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
Changes
No recorded changes to this endpoint across all 11 revisions of this API.