fetch_mentions
fetch_mentionsRetrieve media mentions filtered by search, date range, language, sentiment, and more. Returns paginated results with title, url, sentiment, and virality.
Instructions
Fetch media mentions matching the specified filters. Supports filtering by search, phrase, date range, language, country, media segment, sentiment, tags, source, read/marked/critical/mailed status, inlink count, and more. Results are paginated and sortable. Returns total count and a list of mentions with title, url, media segment, published date, sentiment, virality, and link counts.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Number of results to return (max 100). Default 25. | |
| offset | No | Number of initial results to skip. Max offset+limit is 10000. Default 0. | |
| phrase | No | Include only mentions matching this search query. | |
| country | No | Filter by country code(s), comma-separated. Use 'missing' to include mentions with no country assigned. | |
| date_to | No | Exclude mentions published after this ISO 8601 timestamp. Defaults to 3000-01-01T01:01:01.000Z. | |
| tags_id | No | Include mentions tagged with at least one of the specified tag ids, comma-separated. | |
| language | No | Filter by language code(s), comma-separated (e.g. 'en' or 'en,de'). | |
| date_from | No | Exclude mentions published before this ISO 8601 timestamp (e.g. '2024-01-01' or '2024-01-01T08:00Z'). | |
| sentiment | No | Filter by sentiment: -1 (negative), 0 (neutral), 1 (positive), -99 (no sentiment). | |
| searches_id | No | Comma-separated list of search ids. Use '0' for all searches, a folder id for all searches in a folder, or specific search ids. | 0 |
| media_segment_id | No | Filter by media segment id(s), comma-separated. Available values: * 2 (Blogs) * 3 (News) * 4 (Social Networks) * 5 (Microblogs) * 6 (Web) * 7 (Forums) * 10 (Press Releases) |