Follow these two steps to fetch the latest mentions from Listen project:

1. List Projects

curl -X GET \
  'https://sentione.com/api/public/v2/projects' \
  -H 'X-API-KEY: your_secret_key_here'

2. Extract project ID from the response

{
  "data": [
    { "id": 111, "name": "Apple" },
    { "id": 222, "name": "Android" }
  ],
  "cursor": "abc123"
}

Select desired project id (eg. 111 for Apple project)

3. Issue search request to retrieve 25 latest mentions from a project

curl -X POST \
  'https://sentione.com/api/public/v2/projects/111/mentions/recent/search' \
  -H 'X-API-KEY: your_secret_key_here' \
  -H 'Content-Type: application/json' \
  -d '{"filters":{},"sortType":"PublishedAtDescending"}'

4. Extract mentions from data field

{
  "data": [ {
      "id": "smid-wcuEd-YCoP89RC676Z97taQ2Nk97_T5HYBbFSb1rwOCzvdVLUm5GMI6tZXFUhoU5v0zQiWgt48ZllN5iXPF9tVuU4dFDR0COkaoLAVFOrYCbXju8Nztir6cPSOMdITnpMZMjNsALWcK3MU1tevSnNpZojdQD2IzBQfzYx_o",
      "author": {
        "id": "333333",
        "name": "Apple user",
        "avatar": {
          "url": "https://graph.facebook.com/1111111111/picture",
          "type": "Image"
        },
        "gender": "Unspecified",
        "influenceMetrics": {}
      },
      "source": {
        "socialChannel": {
          "id": "1111111111",
          "name": "Apple Iphone Fanpage Example"
        },
        "mentionUrl": "https://www.facebook.com/1111111111/",
        "type": "Facebook"
      },
      "type": "Post",
      "publishedAt": "2025-05-16T10:09:48.000Z",
      "collectedAt": "2025-05-16T10:09:53.122Z",
      "content": {
        "text": "Apple is so cool!",
        "language": {
          "code": "pl"
        },
        "sentiment": "Neutral"
      },
      "engagementMetrics": {
        "influenceScore": 1,
        "engagementRate": 0,
        "sourceMetrics": {
          "common": {},
          "facebook": {
            "likeCount": 10,
            "loveCount": 0,
            "hahaCount": 0,
            "wowCount": 0,
            "sadCount": 0,
            "angryCount": 0
          }
        }
      },
      "attachments": []
    } ],
  "cursor": "def456"
}

5. Fetch next page of results

If the returned cursor is non-null, include ?cursor=def456 on the next request to fetch subsequent pages.

More details about paging can be found here

For full details on endpoints, schemas, filters, sorting options, and time ranges, refer to the Swagger documentation included in this package.