API Reference
AppService status

Discussion's recent mentions live stream

post
https://sentione.com/api/public/v2/discussions//mentions/recent/search/stream/live

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)

string
enum

⚠️ Experimental - this parameter is in experimental phase and may be changed in a future version without being considered a breaking change.

Enables anonymization of personal data fields on returned mentions, allowing you to process mention data without exposing personally identifiable information — useful for compliance and data privacy requirements.

Anonymized field values are replaced with a consistent hash, so the same original value always produces the same hash across all mentions.

Available levels:

  • author - anonymizes author-related fields:
    • author.id, author.name - replaced with a consistent hash
    • author.avatar - set to null
    • discussion.author.name - replaced with a consistent hash
  • all - anonymizes all identification-related fields:
    • author.id, author.name - replaced with a consistent hash
    • author.avatar - set to null
    • discussion.author.name - replaced with a consistent hash
    • source.socialChannel.id, source.socialChannel.name - replaced with a consistent hash
    • location - removed entirely
Allowed:
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

Updated 2 months ago

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

Updated 2 months ago