📘
All changes to Listen API will be announced here

26.02.2026 Legacy Mention ID field added for transition period

🚧
This field will be removed in future
This new field is added as temporary measure helping existing customers migrate from Legacy V1 API to V2.

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:

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

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

Updating existing projects

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

Deleting platform projects

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:

🔍 API Reference:

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.