📘

All changes to Listen API will be announced here

16.07.2026 Limit parameter in Streaming endpoints

New parameter in streaming endpoints

New parameter have been added to streaming endpoints that will allow to limit total number of mentions extracted with streaming endpoints.

This could be especially useful during initial integration with our API to make sure your mention cap is not used too fast due to some programming error.

curl --request POST \
     --url https://sentione.com/api/public/v2/projects/123/mentions/search/stream?limit=10 \
     --header 'Accept: text/event-stream' \
     --header 'content-type: application/json'

18.06.2026 Anonymize parameter & Bug fixes

New experimental feature - Anonymization

Streaming endpoints will receive an update that will allow to run anonymization pipeline that previously was included in CSV/XLSX exports.

If the mode is enabled - fields such as author.name, author.id will be replaced with hash that is consistent for equal author names. These values are also in line with values you get in XLSX/CSV format

Heartbeat event - bug fix

We're fixing bug where Hearbeat events send in Streaming endpoints were not in-line with documented payload.

Was

event: heartbeat
id: 2026-05-27T13:40:52.224+02:00
data: "2026-05-27T11:40:52.224Z"

{"id":"2026-05-27T13:41:14.962+02:00","event":"heartbeat","data":"2026-05-27T11:41:14.962Z"}

Will be (matching documentation)

event: heartbeat
id: 2026-05-27T13:44:01.194+02:00
data: {"date":"2026-05-27T11:44:01.194Z"}

{"id":"2026-05-27T13:43:33.766+02:00","event":"heartbeat","data":{"date":"2026-05-27T11:43:33.766Z"}}

23.04.2026 Context field added

With this release we've added new field on Mention model

"context": {
  "parent": {
    "content": {
      "text": "content of the parent mention (if available - depending on the source)"
    }
  }
}

This new field hold optional information about content of parent mention (whenever it's available). Availability of the information depends on specific source type and is not guaranteed.

26.02.2026 Legacy Mention ID field added for transition period

With this release we've added new field on Mention model

"deprecatedV1Fields": {
  "id": "statement_id_from_sentione_api_v1"
}

This new field has exact same value id field in the old V1 API

This new field is added as temporary measure helping existing customers migrate from V1 to V2.

29.01.2026 Tagging endpoints & New field

Tagging endpoints

This feature is available in Enterprise API Tier only

With this release we've added ability to manage mention tags:

• https://listen.help.sentione.com/update/reference/tagmentionv2
• https://listen.help.sentione.com/update/reference/untagmentionv2

New fields

We've added content.title filed to mentions model that includes the title of Articles / YT Videos etc.

11.12.2025 Mention Engagement Updates Stream

A new streaming endpoint will be added to the API, providing real-time updates on mention engagement changes such as likes, shares, or comments.

🔗 Endpoint

POST /v2/mentions/engagement/updates/stream/live

💡 Use case

This stream delivers all unfiltered updates about mentions whose engagement metrics have changed — allowing you to monitor evolving public interactions, build live dashboards, or trigger automated reactions in real time.

⚙️ Access level

Available for Enterprise Tier users.

06.11.2025 New filters added & Tags field added

Language and country filters

All search endpoints will now accept new filters filters.content.language and filters.location.country that will respectively allow API users to filter mentions by their language codes (ISO-659-1) and country codes (ISO 3166)

Collection date filter

You will now be able to filter the data by the collection date - the date when mention appeared in SentiOne system. This aims to give ability to fetch only the data that is new compared to previous extraction.

filters.collectedAt can be used for that purpose

Tags field added on Mention

Mentions will now include tags field which will be an array of tag names that were assigned to it.

09.10.2025 New additions to the API

Wildcard & Phrase operators in query filter

Upcoming release will bring support of new operators in Query language

Wildcard support

POST /api/public/v2/projects
{ "query": "linux AND tech*", "mame": "Linux technology" }

Phrase support

POST /api/public/v2/projects
{ "query": "\"linux is great\"", "mame": "Linux is Great" }

Discussion field added

Upcoming release will bring new object field discussion that will include information about thread mention belongs to. This way it will be possible to group mentions.

{ 
    "id": "smid-wcuEd-YCoP89RC676Z97taQ2Nk97_T5HYBbFSb1rwOCzvdVLUm5GMI6tZXFUhoU5v0zQiWgt48ZllN5iXPF9tVuU4dFDR0COkaoLAVFOrYCbXju8Nztir6cPSOMdITnpMZMjNsALWcK3MU1tevSnNpZojdQD2IzBQfzYx_o",
    "author": {
      "id": "facebook_user_1234567890",
      "name": "Sarah Johnson",
      "avatar": {
        "url": "https://cdn.facebook.com/avatars/user_1234567890.jpg",
        "type": "Image"
      },
      "gender": "Female",
      "influenceMetrics": {
        "followerCount": 245,
        "fanCount": null
      }
    },
    "discussion": {
      "id": "sdid-unique-identifier-of-discussion-thread", 
      "author": { 
        "name": "Author name who initiated the discussion" 
      },
    "source": {
      "socialChannel": {
        "id": "facebook_page_987654321",
        "name": "Tech Reviews Hub"
      },
      "mentionUrl": "https://www.facebook.com/posts/123456789012345",
      "type": "Facebook"
    }
    ...
  }
}

11.09.2025 Project management API & Query filter

Upcoming release will bring

New project management endpoints

• Creating new projects on the platform
  • cURL

    POST /api/public/v2/projects
    { "query": "linux AND (ubuntu OR debian)", "mame": "Linux project" }

• Updating existing projects
  • cURL

    PUT /api/public/v2/projects/:projectId
    { "query": "linux AND (ubuntu OR debian)", "mame": "Linux project" }

• Deleting platform projects
  • cURL

    DELETE /api/public/v2/projects/:projectId

New boolean query filter in mentions extraction endpoints

New filter content.query will enable to narrow down mentions results further by mention content

POST /api/public/v2/projects/:projectId/mentions/recent/search
{
    "filters": {
        "content": {
            "query": "linux AND (ubuntu OR debian)"
        }
    }
}

31.07.2025 Streaming API endpoints preview

We’re excited to announce that the new Streaming API will be available on 31.07.2025 🎉 This update brings two powerful capabilities to your Listen projects:

• Export Streams – Export large volumes of historical or recent mentions through a single long-running connection.
• Live Streams – Monitor mentions in real-time as they’re collected by the SentiOne platform.

Whether you’re building data pipelines, dashboards, or alerting systems — this API is made for speed, scalability, and automation.

Learn How to Use It

We’ve prepared detailed guides and OpenAPI documentation to help you get started right away:

📘 API Guides:

• Overview: Streaming API
• Export Mentions Streams
• Live Mentions Stream

🔍 API Reference:

• Search Mentions Stream (Export)
• Recent Mentions Stream (Export)
• Live Mentions Stream

Have feedback or questions? Let us know directly via the in-app chat. We’re actively improving this API based on your input.

Let the streaming begin! 🚀

09.06.2025 Tech Preview of V2 API

We're happy to announce that we're rolling out new Listen API that will eventually supersede Old and Legacy API that many of our customers have access to.

Please beware that the new API is in active development and is subject to change.

We'd love to hear your feedback so please drop us a message in the application chat window about the features you'd like to see in this new API.