---
title: "Get competitor analysis"
method: GET
path: "/ai-visibility/competitors"
tags: ["AI Visibility"]
---

# Get competitor analysis

`GET /ai-visibility/competitors`

## Request

- Base URL: `https://next.frase.io/api/v1`
- URL: `https://next.frase.io/api/v1/ai-visibility/competitors`
- Auth: one of:
  - API key in header `X-API-KEY`
  - HTTP bearer

Get competitive share-of-voice analysis across AI platforms.

## Query parameters

- `page` integer
- `page_size` integer
- `days` integer

## Response `200`

Competitor analysis

- object
  - `data` object[]
    - `id` string, uuid
    - `name` string
    - `domain` string
    - `variants` string[]
    - `latest_visibility_score` number, nullable
    - `last_tracked_at` string, date-time, nullable
    - `share_of_voice` object: The competitor's mentions and scores over the window, counted from its daily rows. Changed 2026-10-01: a re-read of stored answers now recounts each day's rows from 2026-05-27 on under the competitor's current name and other names, so the totals for those days can change after a rename; days before 2026-05-27 keep their counts. Changed 2026-10-01: a name that is an ordinary word or a place, or is made only of them ("Landing", "Home Instead", "Visit Mobile"), counts only where the answer writes it as a name, every significant word capitalised, or links the entity's own site; answers read from this date on are counted this way, and a re-read applies it to earlier days.
      - `total_mentions` integer
      - `avg_score` number, nullable: Mean visibility score over the competitor's measured rows in the window (one decimal). Null when the competitor has no measured row in the window. Changed 2026-09-19: previously a running average seeded at 0, and 0 with nothing measured.
      - `platforms` object
    - `created_at` string, date-time
  - `pagination` Pagination
    - `page` integer
    - `page_size` integer
    - `total` integer
    - `has_more` boolean
  - `request_id` string

---

[API](https://skmtc.dev/frase/apis/frase-api.md) · [All operations](https://skmtc.dev/frase/apis/frase-api/llms.txt) · [OpenAPI document](https://skmtc.dev/frase/apis/frase-api/revisions/7fb75d89f7a4?raw)