AI Results Tracker – Competitors

AIRT Competitors API, part of the AI Results Tracker (AIRT), provides programmatic access to the per-prompt, per-day Competitors view: which brands and source URLs appear in AI answers for a tracked prompt over time, with a cached HTML copy of the answer page for human verification.

All endpoints are engine-scoped (llm_id). To inspect a prompt across several engines, list the engines via List LLM engines and iterate.

Using the API, you can:

• retrieve the brands and source URLs cited in an AI answer for a prompt across a date range
• list the dates on which a prompt was checked, so you can skip empty periods
• get SEO metrics (Domain Trust, referring domains, organic keywords) for the cited sources

Note:

• prompt_llm_id values come from the prompt_llm_id field of List prompts. The prompt_id field is a different value and is not accepted.
• The full answer text is not returned by these endpoints. Fetch it per (prompt, date) via Get prompt answer; the has_answer_text flag tells you whether it is still available.

Data retention:

• Cached HTML copy: 30 days (has_cached_copy).
• Answer text: 1 year (has_answer_text).

Get competitors breakdown

GET https://api.seranking.com/v1/project-management/airt/competitors

Cost: 0. Retrieving competitors data does not consume API credits or subscription quota.

For each requested prompt over a date range, returns one entry per check date with:

• Brands mentioned in the AI answer, ordered as displayed
• Source URLs cited in the answer, ordered as displayed
• Cached copy URL for human verification (opt out via include_cached_copy_url=0)

Dates without a check are omitted from results. A check with no sources or brands is returned with empty brands and sources arrays.

Limits:

• Up to 50 prompt_llm_ids[] per request.
• Date range up to 366 days.
• Requested prompts multiplied by date range days must not exceed 3,660.
• Default range: last 7 days.

Compact mode (compact=1): adjacent calendar days with identical brands and sources (and, for Google AI Overview, identical ai_overview_present and organic_urls) are collapsed into a single entry with a date_from/date_to range instead of date. Entry fields (cached_copy_url, flags) are taken from the most recent day of the run. Days separated by a gap without checks are never merged.

Google AI Overview: entries additionally contain ai_overview_present and organic_urls (top 20 organic results).

Warning: cached_copy_url points at the api4.seranking.com surface, which is not part of the unified gateway. As of July 9, 2026 the gateway API key is rejected there (403) with both Authorization: Token header and ?token= query authentication, so the cached copy cannot currently be fetched with the same credentials. Raised with the AIRT team.

Request parameters

Request example

curl 'https://api.seranking.com/v1/project-management/airt/competitors?site_id=11270054&llm_id=151294&prompt_llm_ids[]=1411621&prompt_llm_ids[]=1411624&date_from=2026-07-01&date_to=2026-07-08' \

  -H 'Authorization: Token YOUR_API_KEY'

Response parameters

Each item in the items array:

Each entry in results:

Response example

{

  "site_id": 11270054,

  "site_llm_id": 151294,

  "date_from": "2026-07-01",

  "date_to": "2026-07-08",

  "items": [

    {

      "prompt_llm_id": 1411621,

      "prompt": "best seo tool",

      "results": [

        {

          "date": "2026-07-08",

          "brands": [

            { "position": 1, "name": "Semrush" },

            { "position": 2, "name": "SE Ranking" }

          ],

          "sources": [

            {

              "position": 1,

              "url": "https://seranking.com/blog/best-seo-tools/",

              "domain": "seranking.com"

            }

          ],

          "has_cached_copy": true,

          "has_answer_text": true,

          "cached_copy_url": "https://api4.seranking.com/sites/11270054/airt/v2/llm/151294/prompts/1411621/cached-copy?date=2026-07-08"

        }

      ]

    }

  ]

}

Error responses

Get competitors check dates

GET https://api.seranking.com/v1/project-management/airt/competitors/dates

Cost: 0. Retrieving competitors data does not consume API credits or subscription quota.

Returns the list of dates within a range on which the prompt was checked and competitors data is available. Use it to avoid requesting empty periods.

Note: Default range: last 30 days. Maximum range: 366 days.

Request parameters

Request example

curl 'https://api.seranking.com/v1/project-management/airt/competitors/dates?site_id=11270054&llm_id=151294&prompt_llm_id=1411621&date_from=2026-06-09&date_to=2026-07-08' \

  -H 'Authorization: Token YOUR_API_KEY'

Response parameters

Response example

{

  "site_id": 11270054,

  "site_llm_id": 151294,

  "prompt_llm_id": 1411621,

  "date_from": "2026-06-09",

  "date_to": "2026-07-08",

  "dates": ["2026-07-06", "2026-07-07", "2026-07-08"]

}

Error responses

Get source metrics

GET https://api.seranking.com/v1/project-management/airt/competitors/source-metrics

Cost: 0. Retrieving competitors data does not consume API credits or subscription quota.

Returns SEO metrics for the source URLs (or their domains) cited in the AI answer for a prompt on a given date:

• domain_trust — Domain Trust score
• ref_domains — number of referring domains
• organic_keywords — number of organic keywords the URL or domain ranks for

For Google AI Overview engines the source list also includes organic results.

Request parameters

Request example

curl 'https://api.seranking.com/v1/project-management/airt/competitors/source-metrics?site_id=11270054&llm_id=151216&prompt_llm_id=1411240&date=2026-07-08&mode=domain' \

  -H 'Authorization: Token YOUR_API_KEY'

Response parameters

Each item in the items array:

Response example

{

  "site_id": 11270054,

  "site_llm_id": 151216,

  "prompt_llm_id": 1411240,

  "date": "2026-07-08",

  "mode": "domain",

  "items": [

    {

      "source": "[www.reddit.com](https://www.reddit.com)",

      "domain": "[www.reddit.com](https://www.reddit.com)",

      "domain_trust": 98,

      "ref_domains": "2532163",

      "organic_keywords": 199918377

    },

    {

      "source": "[www.semrush.com](https://www.semrush.com)",

      "domain": "[www.semrush.com](https://www.semrush.com)",

      "domain_trust": 96,

      "ref_domains": "222992",

      "organic_keywords": 494418

    }

  ]

}

Note: A 200 response with an empty items array means the answer on that date cited no sources (common for ChatGPT prompts where the answer had no source links).

Error responses