Brand Mentions
Returns paginated brand mentions matched within the requested date range. Supports filtering by brand, AI service, country, tag, topic, prompt, rank range, sentiment, and free-text search across snippets.
Authorizations
Team API key created in Team Settings. Use it with URLs for the same team.
Path Parameters
Project UUID.
Query Parameters
255Brand UUID filter. Pass a single brand UUID as brands[]=....
1AI platform provider filters such as chatgpt or perplexity. Discover providers with GET /api/v1/platforms.
Country code filters such as US or GB. Discover codes with GET /api/v1/countries.
Tag UUID filters. Discover tag UUIDs with GET /api/v1/projects/{project}/tags.
Topic UUID filters. Use no_topic for prompts without a topic. Discover topic UUIDs with GET /api/v1/projects/{project}/topics.
Prompt UUID filter.
Comma-separated list of sentiments. Allowed values: positive, negative, neutral.
x >= 1x >= 11 <= x <= 100rank asc, desc