Returns statistical data about your mentions. Useful for showing charts or summary tables about your data. (Enable your developer account and go to the API Parameters tab in the Chart Builder in the application to see examples.)

Required Access Token Scope



Param Description Required Default Value
facetdefinitions A json encoded array of facetdefinition objects. Yes
filter A filter query string to return only data that matches a certain filter. No
date_from ISO 8601 formatted date, defaults to 28 days ago. No
date_to ISO 8601 formatted date, defaults to now. No
topic_ids Comma separated list of topic ids to search in. Required for facets of type "mentions". No
profile_ids Comma separated list of monitored profiles ids. Required for facets of type "monitored profile kpis". No


Array of facet items.


Breakdown of total volume by day