Social Listening

List mentions for a tracked keyword

Windowed mentions for a keyword, with optional platform/sentiment filter and sort. Every saved mention is returned. 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' | '90d'
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

Changes

Changed in 1 of the 4 revisions of this API.1

    • added the new enum value 90d to the query request parameter range

      request-parameter-enum-value-added