Matrix Analysis
Returns a metric (visibility, mentions, industry rank, or average position) broken out across two public dimensions. Row, column, and cell identifiers use the same public identifiers as filters: provider strings, country codes, enum values, UUIDs, or stable sentinels.
Authorizations
Team API key created in Team Settings. Use it with URLs for the same team.
Path Parameters
Project UUID.
Query Parameters
brand, tag, country, service, topic Must differ from row_dimension.
brand, tag, country, service, topic industry_rank, visibility, mentions, avg_position Brand UUIDs. Pass repeated brands[]=... query params.
10Tag UUID filters. Discover tag UUIDs with GET /api/v1/projects/{project}/tags.
AI 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.
Prompt UUID filter.
Topic UUID filters. Use no_topic for prompts without a topic. Discover topic UUIDs with GET /api/v1/projects/{project}/topics.
Must be on or after start_date.
When true, brand dimensions only include the primary brand and marked competitors.
Response
Matrix analysis result.
brand, tag, country, service, topic brand, tag, country, service, topic industry_rank, visibility, mentions, avg_position