latestOpenAPI 3.1.02026-08-13511119.5 KB
e91a4f756dfe
Social Listening
List mentions for a tracked keyword
Windowed mentions for a keyword, with optional platform/sentiment filter and sort. Brand listeners only return brand mentions. Mentions are returned as a curated, typed shape — common fields plus per-platform metric fields as optional properties.
get/keywords/{keywordId}/mentions
Path parameters
keywordIdstring required
Query parameters
workspaceIdstring required
range'7d' | '14d' | '30d'
startDatestring date-time
endDatestring date-time
platform'twitter' | 'youtube' | 'reddit' | 'tiktok' | 'facebook' | 'instagram'
sentiment'all' | 'positive' | 'negative' | 'neutral'
sortBy'engagement' | 'recency'
cursorinteger
limitinteger
Response
Mentions for the keyword