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.