Position distribution comparison

Project ID

Number of days to look back (alternative to from/to)

End of the window. A date-only value such as 2026-09-01 covers that whole day. Pass a full timestamp to end the window earlier.

One collection/tag ID or a comma-separated list of IDs. A query value is always a string on the wire, so it is typed as one: the previous integer-or-string union made generators emit a wrapper type they could not serialize.

One ISO country code or a comma-separated list (e.g. US,GB,DE)

One ISO language code or a comma-separated list (e.g. en,es,de)

One prompt type or a comma-separated list: informational, navigational, commercial, transactional

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.

Restrict the comparison to one AI model of AI Model Insights, whether or not that model is enabled for the API key's user. Any other value returns 422 ERR_INVALID_PARAM (invalid model).

Competitor ID for the first comparison brand (omit to compare project brand)