v1Resources/Social Listening
Social Listening
Set up what social listening tracks for a client — topics, competitors, tags and themes — and work through what it finds: insights, opportunities and individual posts. Results update once a month; nothing here starts a collection.
- getRead competitive aspect comparisons
/api/v1/listening/competitive/aspects - getRead saved competitive gaps
/api/v1/listening/competitive/gaps - getRead tracked entity perception
/api/v1/listening/competitive/perception - getRead the competitive scorecard
/api/v1/listening/competitive/scorecard - getRead the weekly listening brief
/api/v1/listening/brief - getList conversation terms
/api/v1/listening/conversation/terms - getList saved listening findings
/api/v1/listening/insights - getRead brand insights
/api/v1/listening/insights/brand - getRead the insights workspace
/api/v1/listening/insights/briefing - getList listening posts and comments
/api/v1/listening/mentions - getRead listening metrics by network
/api/v1/listening/overview/networks - getRead the listening overview
/api/v1/listening/overview/summary - getRead listening metric trends
/api/v1/listening/overview/timeseries - getRead the listening client portfolio
/api/v1/listening/portfolio - getGet a client's listening setup
/api/v1/listening/setup - postCreate a listening topic
/api/v1/listening/topics - patchUpdate a listening topic
/api/v1/listening/topics/{id} - deleteArchive a listening topic
/api/v1/listening/topics/{id} - postAdd a listening competitor
/api/v1/listening/competitors - patchUpdate a listening competitor
/api/v1/listening/competitors/{id} - deleteArchive a listening competitor
/api/v1/listening/competitors/{id} - getList conversation themes
/api/v1/listening/themes - postCreate a theme
/api/v1/listening/themes - patchUpdate a theme
/api/v1/listening/themes/{id} - deleteArchive a theme
/api/v1/listening/themes/{id} - patchUpdate an insight
/api/v1/listening/insights/{id} - getList opportunities
/api/v1/listening/opportunities - patchUpdate an opportunity
/api/v1/listening/opportunities/{id} - postTurn an opportunity into post ideas
/api/v1/listening/opportunities/{id}/post-ideas - patchCorrect a listening post
/api/v1/listening/posts/{id}