Project's recent mentions export stream

post

https://sentione.com/api/public/v2/projects/{projectId}/mentions/recent/search/stream

Access Tiers: Premium

Rate limit:

Bucket: recent-stream
Limit: 500 requests per 15 minutes

Concurrency limit:

Bucket: mentions-stream
Limit: 2 concurrent connections

Data limitations:

Mentions cap - monthly limit applies
Mentions published within last 7 days only

⚠️ 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.

Long-running stream of recent project mentions (published within last 7 days) matching filters and sorting criteria. Best for bulk extraction of huge volumes of data.
Multiple different filters such as time-range, sentiment, source can be applied.
Supports both SSE (Server-Sent Events) and NDJSON (Newline Delimited JSON) formats.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

projectId

integer

required

Query Params

anonymize

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:

limit

int64

≥ 1

Maximum number of mentions to return. When specified, the stream closes automatically after delivering the requested number of mentions. If omitted, the stream runs until the client disconnects or all matching data has been delivered.

Body Params

Search request with filters and sorting options

Request model for searching mentions with optional filters and sorting.
If sortType is omitted, defaults to PublishedAtDescending.

filters

object

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

sortType

string

enum

Defines how to sort search results (Default is PublishedAtDescending)

Headers

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Responses

200Streaming recent mentions data

400Bad request

401Authentication errors

415Unsupported media type

422Validation error

429Rate limit exceeded for the endpoint's rate limit bucket

defaultUnexpected error