Get a report on brand visibility, sentiment, and position across AI search engines.
Results are aggregated for the entire date range by default. Use the "date" dimension for daily breakdowns.
Returns columnar JSON: {columns, rows, rowCount, total}. Each row is an array of values matching column order. Columns:
- brand_id — the brand ID
- brand_name — the brand name
- visibility: 0–1 ratio — fraction of AI responses that mention this brand. 0.45 means 45% of conversations.
- mention_count: number of times the brand was mentioned
- share_of_voice: 0–1 ratio — brand's fraction of total mentions across all tracked brands
- sentiment: 0–100 scale — how positively AI platforms describe the brand (most brands score 65–85)
- position: average ranking when the brand appears (lower is better, 1 = mentioned first)
- Raw aggregation fields (for custom calculations): visibility_count, visibility_total, sentiment_sum, sentiment_count, position_sum, position_count
When dimensions are selected, rows also include the relevant dimension columns: prompt_id, model_id, model_channel_id, tag_id, topic_id, chat_id, date, country_code.
Dimensions explained:
- prompt_id: individual search queries/prompts
- model_id: AI search engine (e.g. chatgpt-scraper, gpt-4o, gpt-4o-search, gpt-3.5-turbo, llama-sonar, perplexity-scraper, sonar, gemini-2.5-flash, gemini-scraper, google-ai-overview-scraper, google-ai-mode-scraper, llama-3.3-70b-instruct, deepseek-r1, claude-3.5-haiku, claude-haiku-4.5, claude-sonnet-4, grok-scraper, microsoft-copilot-scraper, grok-4, qwen-3-6-plus, amazon-rufus-scraper) — deprecated, prefer model_channel_id
- model_channel_id: stable engine channel (e.g. openai-0, openai-1, qwen-0, openai-2, perplexity-0, perplexity-1, google-0, google-1, google-2, google-3, anthropic-0, anthropic-1, deepseek-0, meta-0, xai-0, xai-1, microsoft-0, amazon-0) — survives model upgrades
- tag_id: custom user-defined tags
- topic_id: topic groupings
- date: (YYYY-MM-DD format)
- country_code: country (ISO 3166-1 alpha-2, e.g. "US", "DE")
- chat_id: individual AI chat/conversation ID
Filters use {field, operator, values} where operator is "in" or "not_in". Filterable fields: model_id (deprecated), model_channel_id, tag_id, topic_id, prompt_id, brand_id, country_code, chat_id.
Sort results with order_by: array of {field, direction} entries. Direction defaults to desc. Sortable fields: visibility, visibility_count, mention_count, sentiment, position, share_of_voice. Multiple entries create a multi-key sort.
