Discussion's recent mentions live stream

Tier: Enterprise

Rate limit: 14400 requests per hour, 2 concurrent connections

Data limitations:

  • Mentions cap - monthly limit applies
  • Mentions published within last 7 days, collected by the system since the connection start (with optional 5-minute backfill)

Discussion: A discussion represents a collection of mentions within a single thread that share the same discussion.id value. For example, a Facebook post along with all its comments forms one discussion.

⚠️ WARNING: Due to limitations of readme.com API console, the Try it out button will not work for streaming endpoints. Please copy the generated curl command and execute it in your terminal to test streaming functionality.

⚠️ WARNING: The order of mentions in the live stream is random and you cannot make any assumptions about it. Due to the nature of the live-stream and different delays of particular mentions, they may arrive out of chronological order.

Infinite live-stream of mentions from a specific discussion published within last 7 days which are being collected by SentiOne system from the moment the stream connection starts.

Supports optional backfill of recent mentions and filtering. Supports both SSE (Server-Sent Events) and NDJSON (Newline Delimited JSON) formats.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

The ID of the discussion thread to stream live mentions from (must match mention's field discussion.id)

Query Params
integer
0 to 5
Defaults to 0

Number of minutes to backfill (0-5 minutes maximum)

Body Params

Search request with filters (sorting not supported for live stream - mentions arrive in random order as they are collected)

filters
object

Filters to apply to live stream searches. If omitted in Recent mentions search, publishedAt defaults to the last 7 days.

Headers
string
enum
required

Stream format - 'text/event-stream' for SSE or 'application/x-ndjson' for newline-delimited JSON

Allowed:
Responses

Language
Credentials
Header
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
text/event-stream
application/x-ndjson
application/json