AI Model Insights
Position distribution comparison
get/reports/ai_model_insights/position_distribution
Query parameters
project_idinteger required
Project ID
rangeinteger
Number of days to look back
fromstring date-time
tostring date-time
granularity'day' | 'week' | 'month'
collection_idinteger
country_codestring
language_codestring
prompt_type'informational' | 'navigational' | 'commercial' | 'transactional'
Filter by prompt type (search intent).
brand_kind'brand' | 'brand_other' | 'non_brand'
Filter by brand kind: brand (own brand/products), brand_other (competitors/other brands), non_brand (generic, no brand named). For fair 1:1 brand-vs-competitor comparisons (visibility, share of voice), use non_brand: brand-focused prompts skew results toward the brand they name. The in-app Overview page applies non_brand by default.
model'chatgpt' | 'perplexity' | 'gemini' | 'ai_overview' | 'ai_mode' | 'copilot' | 'claude' | 'grok' | 'deepseek' | 'meta_ai' | 'amazon_rufus'
Filter by AI model. Models the API key's user has not enabled are silently dropped.
brand1integer
brand2integer
Response
Bucketed position totals