API
API / Project API / AI Result Tracker

AI Result Tracker

You are reading the Data API docs

Base URL: api4.seranking.com

Project API uses subscription limits. Fro more information visit API credit system.

Data API and Project API keys are not interchangeable — use the correct one to avoid authentication errors.

Data apikey example:
80cfee7d-xxxx-xxxx-xxxx-fc8500816bb3
(UUID format)
Project apikey example:
253a73adxxxxxxxxxxxxxx340aa0a939
(40-char hex)
API dashboard

API keys are available in your account. For any questions or 401 errors, email [email protected] for support.

AI Result Tracker API (AIRT) enables tracking of brand visibility across AI search engines. It covers three resource groups:

  • Brands — Configure which brand name to track for a site
  • LLM engines — Add and manage which AI engines to track (ChatGPT, Perplexity, Gemini, Google AI Overview, Google AI Mode)
  • Prompts — Manage keywords (prompts) per engine and retrieve rankings data

Typical workflow

Note: LLM engine endpoints use {id} while prompt endpoints use {llm_id}. Both refer to the same LLM engine ID.
  1. Set a brand → POST /sites/{site_id}/airt/brands
  2. Add an LLM engine → POST /sites/{site_id}/airt/llm
  3. Add prompts → POST /sites/{site_id}/airt/llm/{llm_id}/prompts
  4. Check status → GET /sites/{site_id}/airt/llm/{id}/status
  5. Retrieve statistics → GET /sites/{site_id}/airt/llm/{id}/statistics
  6. Retrieve rankings → GET /sites/{site_id}/airt/llm/{llm_id}/prompts/rankings

Supported LLM engines

base_nameDisplay name
chatgptChatGPT
google_ai_overviewGoogle AI Overview
google_ai_modeGoogle AI Mode
perplexityPerplexity
geminiGemini

Get site brand

GET https://api4.seranking.com/sites/{site_id}/airt/brands

Returns the brand configured for the specified site.

Request parameters

ParameterTypeRequiredDescription
site_idIntegerYesSite ID (path parameter).

Request example

Copy
curl -X GET 'https://api4.seranking.com/sites/11270054/airt/brands' \

  -H 'Authorization: Token YOUR_API_KEY'

Response parameters

If the site is not found, the API returns the 404 HTTP status code (for more information, see Error handling).

ParameterTypeDescription
site_idIntegerSite ID.
brandStringConfigured brand. null if not set.

Response example

Copy
{

  "site_id": 11270054,

  "brand": "SE Ranking"

}

Save site brand

POST https://api4.seranking.com/sites/{site_id}/airt/brands

Configures or overwrites the brand for a site. The brand is shared across all AI search engines.

Request parameters

ParameterTypeRequiredDescription
site_idIntegerYesSite ID (path parameter).
brandStringYesBrand name (non-empty, max 255 characters).

Request example

Copy
curl -X POST 'https://api4.seranking.com/sites/11270054/airt/brands' \

  -H 'Authorization: Token YOUR_API_KEY' \

  -H 'Content-Type: application/json' \

  -d '{"brand": "SE Ranking"}'

Response parameters

ParameterTypeDescription
site_idIntegerSite ID.
brandStringConfigured brand.

Response example

Copy
{

  "site_id": 11270054,

  "brand": "SE Ranking"

}

List LLM engines

GET https://api4.seranking.com/sites/{site_id}/airt/llm

Returns all LLM engines configured for the specified site.

Request parameters

ParameterTypeRequiredDescription
site_idIntegerYesSite ID (path parameter).

Request example

Copy
curl -X GET 'https://api4.seranking.com/sites/11270054/airt/llm' \

  -H 'Authorization: Token YOUR_API_KEY'

Response parameters

Returns an array of LLM engine objects.

ParameterTypeDescription
idIntegerLLM engine ID.
site_idIntegerSite ID.
base_nameStringLLM engine base name (e.g., chatgpt, google_ai_overview).
country_codeStringISO 3166-1 alpha-2 country code.
region_nameStringSpecific region or locality name.
lang_codeStringISO 639-1 language code.
region_settingsObject/ArrayEngine-specific region settings. Object with lat, lng, uule, radius for geo-targeted engines; empty array [] for engines without region settings.

Response example

Copy
[

  {

    "id": 151216,

    "site_id": 11270054,

    "base_name": "google_ai_overview",

    "country_code": "us",

    "region_name": "Washburn County, Wisconsin, United States",

    "lang_code": "en",

    "region_settings": {

      "lat": 45.965719,

      "lng": -91.814895,

      "uule": "",

      "radius": 25000

    }

  },

  {

    "id": 151294,

    "site_id": 11270054,

    "base_name": "chatgpt",

    "country_code": "us",

    "region_name": null,

    "lang_code": "en",

    "region_settings": []

  }

]

Get LLM engine

GET https://api4.seranking.com/sites/{site_id}/airt/llm/{id}

Returns details of a specific LLM engine.

Request parameters

ParameterTypeRequiredDescription
site_idIntegerYesSite ID (path parameter).
idIntegerYesLLM engine ID (path parameter).

Request example

Copy
curl -X GET 'https://api4.seranking.com/sites/11270054/airt/llm/151216' \

  -H 'Authorization: Token YOUR_API_KEY'

Response parameters

If the LLM engine is not found, the API returns the 404 HTTP status code (for more information, see Error handling).

ParameterTypeDescription
idIntegerLLM engine ID.
site_idIntegerSite ID.
base_nameStringLLM engine base name (e.g., chatgpt, google_ai_overview).
country_codeStringISO 3166-1 alpha-2 country code.
region_nameStringSpecific region or locality name.
lang_codeStringISO 639-1 language code.
region_settingsObject/ArrayEngine-specific region settings. Object with lat, lng, uule, radius for geo-targeted engines; empty array [] for engines without region settings.

Response example

Copy
{

  "id": 151216,

  "site_id": 11270054,

  "base_name": "google_ai_overview",

  "country_code": "us",

  "region_name": "Washburn County, Wisconsin, United States",

  "lang_code": "en",

  "region_settings": {

    "lat": 45.965719,

    "lng": -91.814895,

    "uule": "",

    "radius": 25000

  }

}

Create LLM engine

POST https://api4.seranking.com/sites/{site_id}/airt/llm

Adds a new LLM engine to a site.

Prerequisite: A brand must be configured for the site.

Request parameters

ParameterTypeRequiredDefaultDescription
site_idIntegerYesN/ASite ID (path parameter).
base_nameStringYesN/ALLM engine base name. Must be one of: chatgpt, google_ai_overview, google_ai_mode, perplexity, gemini.
country_codeStringYesN/AISO 3166-1 alpha-2 country code (e.g., us).
region_nameStringNoN/ASpecific region or locality. For location-aware engines (google_ai_overview, google_ai_mode, gemini), must be a canonical SERP location name that matches the specified country_code. chatgpt and perplexity ignore this field and always return region_name: null.
lang_codeStringNoN/AISO 639-1 language code (e.g., en). Must be a valid language code supported by Google.

Request example

Copy
curl -X POST 'https://api4.seranking.com/sites/11270054/airt/llm' \

  -H 'Authorization: Token YOUR_API_KEY' \

  -H 'Content-Type: application/json' \

  -d '{

    "base_name": "perplexity",

    "country_code": "us",

    "lang_code": "en"

  }'

Response parameters

Returns the created LLM engine object. If the site is not found, the API returns the 404 HTTP status code (for more information, see Error handling).

ParameterTypeDescription
idIntegerLLM engine ID.
site_idIntegerSite ID.
base_nameStringLLM engine base name (e.g., chatgpt, google_ai_overview).
country_codeStringISO 3166-1 alpha-2 country code.
region_nameStringSpecific region or locality name.
lang_codeStringISO 639-1 language code.
region_settingsObject/ArrayEngine-specific region settings. Object with lat, lng, uule, radius for geo-targeted engines; empty array [] for engines without region settings.

Response example

Copy
{

  "id": 160000,

  "site_id": 11270054,

  "base_name": "perplexity",

  "country_code": "us",

  "region_name": null,

  "lang_code": "en",

  "region_settings": []

}

Update LLM engine

PATCH https://api4.seranking.com/sites/{site_id}/airt/llm/{id}

Partially updates the configuration of an LLM engine (region_name and/or lang_code).

Request parameters

ParameterTypeRequiredDescription
site_idIntegerYesSite ID (path parameter).
idIntegerYesLLM engine ID (path parameter).
region_nameStringNoNew region or locality name. Canonical form required. Set to null to clear. Only honored by google_ai_overview, google_ai_mode, and gemini. chatgpt and perplexity silently ignore this field and always return region_name: null.
lang_codeStringNoNew language code. Set to null to clear.

Request example

Copy
curl -X PATCH 'https://api4.seranking.com/sites/11270054/airt/llm/151216' \

  -H 'Authorization: Token YOUR_API_KEY' \

  -H 'Content-Type: application/json' \

  -d '{

    "region_name": "Los Angeles, California, United States",

    "lang_code": "es"

  }'

Response parameters

Returns the updated LLM engine object. If the LLM engine is not found, the API returns the 404 HTTP status code (for more information, see Error handling).

ParameterTypeDescription
idIntegerLLM engine ID.
site_idIntegerSite ID.
base_nameStringLLM engine base name (e.g., chatgpt, google_ai_overview).
country_codeStringISO 3166-1 alpha-2 country code.
region_nameStringSpecific region or locality name.
lang_codeStringISO 639-1 language code.
region_settingsObject/ArrayEngine-specific region settings. Object with lat, lng, uule, radius for geo-targeted engines; empty array [] for engines without region settings.

Response example

Copy
{

  "id": 151216,

  "site_id": 11270054,

  "base_name": "google_ai_overview",

  "country_code": "us",

  "region_name": "Los Angeles, California, United States",

  "lang_code": "es",

  "region_settings": {

    "lat": 34.052235,

    "lng": -118.243683,

    "uule": "",

    "radius": 25000

  }

}

Delete LLM engine

DELETE https://api4.seranking.com/sites/{site_id}/airt/llm/{id}

Removes the specified LLM engine from the site.

Request parameters

ParameterTypeRequiredDescription
site_idIntegerYesSite ID (path parameter).
idIntegerYesLLM engine ID (path parameter).

Request example

Copy
curl -X DELETE 'https://api4.seranking.com/sites/11270054/airt/llm/151216' \

  -H 'Authorization: Token YOUR_API_KEY'

Response

204 — No content. If the LLM engine is not found, the API returns the 404 HTTP status code (for more information, see Error handling).

Get LLM status

GET https://api4.seranking.com/sites/{site_id}/airt/llm/{id}/status

Returns tracking status for the specified LLM engine, including progress and check statistics.

Request parameters

ParameterTypeRequiredDescription
site_idIntegerYesSite ID (path parameter).
idIntegerYesLLM engine ID (path parameter).

Request example

Copy
curl -X GET 'https://api4.seranking.com/sites/11270054/airt/llm/151216/status' \

  -H 'Authorization: Token YOUR_API_KEY'

Response parameters

If the LLM engine is not found, the API returns the 404 HTTP status code (for more information, see Error handling).

ParameterTypeDescription
llm_idIntegerLLM engine ID.
site_idIntegerSite ID.
progressIntegerPercentage of prompts checked today (0–100).
prompts_countIntegerTotal number of prompts for this LLM engine.
prompts_checkedIntegerNumber of prompts checked on the site’s current date.
last_update_dateStringDate of the last check. If progress is 100%, returns the current date. Otherwise, returns the latest historical check date. null if no checks have been performed yet.

Response examples

All prompts checked today (Google AI Overview)

Copy
{

  "llm_id": 151216,

  "site_id": 11270054,

  "progress": 100,

  "prompts_count": 5,

  "prompts_checked": 5,

  "last_update_date": "2026-02-19"

}

All prompts checked today (ChatGPT)

Copy
{

  "llm_id": 151294,

  "site_id": 11270054,

  "progress": 100,

  "prompts_count": 5,

  "prompts_checked": 5,

  "last_update_date": "2026-02-19"

}

No prompts configured

Copy
{

  "llm_id": 160000,

  "site_id": 11270054,

  "progress": 0,

  "prompts_count": 0,

  "prompts_checked": 0,

  "last_update_date": null

}

Get LLM statistics

GET https://api4.seranking.com/sites/{site_id}/airt/llm/{id}/statistics

Returns statistics for the specified LLM engine, including presence stats, AIO presence, mentions/links, and organic overlap (AI Overview only).

Request parameters

ParameterTypeRequiredDefaultDescription
site_idIntegerYesN/ASite ID (path parameter).
idIntegerYesN/ALLM engine ID (path parameter).
fromStringNoCurrent dateStart date for date range (YYYY-MM-DD format). If not provided, defaults to the current date.
toStringNoCurrent dateEnd date for date range (YYYY-MM-DD format). If not provided, defaults to the current date.
topIntegerNo0 (all positions)Top N positions to analyze (0–100):
• 0 – all positions (default when omitted)
• 3 – only the top 3 positions
• 10 – only top 10 positions
Note: When a date range is provided, only the first and last dates in the range are used. Values show data for the last date; diff values show the change from first to last date in percentage points.

Request examples

Current date only (default)

Copy
curl -X GET 'https://api4.seranking.com/sites/11270054/airt/llm/151216/statistics' \

  -H 'Authorization: Token YOUR_API_KEY'

With date range and top 3

Copy
curl -X GET 'https://api4.seranking.com/sites/11270054/airt/llm/151216/statistics?from=2026-02-01&to=2026-02-19&top=3' \

  -H 'Authorization: Token YOUR_API_KEY'

Response parameters

If the LLM engine is not found, the API returns the 404 HTTP status code (for more information, see Error handling).

Top-level response

ParameterTypeDescription
llm_idIntegerLLM engine ID.
site_idIntegerSite ID.
topIntegertop value used for this query (0 = all positions).

stats object: Basic tracking stats

ParameterTypeDescription
stats.indexed_percentNumberPercentage of prompts that have been indexed (0–100).
stats.keywords_countIntegerTotal number of keywords/prompts.
stats.last_updateStringDate of the last check (YYYY-MM-DD).

presence object: Link and mention presence in Top N positions

ParameterTypeDescription
presence.link_percent_in_topNumberPercentage of keywords with site link in Top N (0–100).
presence.link_diffNumberChange in link percentage from first to last date (percentage points).
presence.mention_percent_in_topNumberPercentage of keywords with brand mention in Top N (0–100).
presence.mention_diffNumberChange in mention percentage from first to last date (percentage points).

aio_presence object: Google AI Overview only

ParameterTypeDescription
aio_presence.keywords_with_aioNumberPercentage of keywords that show AI Overview (0–100).
aio_presence.keywords_with_aio_diffNumberChange in keywords_with_aio from first to last date (percentage points).

organic_overlap object: Google AI Overview only

ParameterTypeDescription
organic_overlap.overlap_countIntegerNumber of overlapping URLs from the Top 20 organic and AIO.
organic_overlap.overlap_count_diffIntegerChange in overlap count from first to last date.
organic_overlap.overlap_percentNumberPercentage of overlap (0–100).

sources_presence object: Non-Google-AI-Overview engines only (ChatGPT, AI Mode, Gemini, Perplexity)

ParameterTypeDescription
sources_presence.answers_with_sourcesNumberPercentage of answers that have source links (0–100).
sources_presence.answers_with_sources_diffNumberChange in answers_with_sources from first to last date (percentage points).

LLM-specific response shape

EngineFields returned
Google AI Overviewstats + presence + aio_presence + organic_overlap
ChatGPT, AI Mode, Gemini, Perplexitystats + presence + sources_presence

Response examples

Google AI Overview with date range and top=3

Copy
{

  "llm_id": 151216,

  "site_id": 11270054,

  "top": 3,

  "stats": {

    "keywords_count": 5,

    "last_update": "2026-02-19",

    "indexed_percent": 100

  },

  "presence": {

    "link_percent_in_top": 0,

    "link_diff": 0,

    "mention_percent_in_top": 0,

    "mention_diff": 0

  },

  "aio_presence": {

    "keywords_with_aio": 80,

    "keywords_with_aio_diff": 0

  },

  "organic_overlap": {

    "overlap_count": 4,

    "overlap_count_diff": 0,

    "overlap_percent": 20

  }

}

ChatGPT with date range (all positions)

Copy
{

  "llm_id": 151294,

  "site_id": 11270054,

  "top": 0,

  "stats": {

    "keywords_count": 5,

    "last_update": "2026-02-19",

    "indexed_percent": 100

  },

  "presence": {

    "link_percent_in_top": 0,

    "link_diff": 0,

    "mention_percent_in_top": 20,

    "mention_diff": 0

  },

  "sources_presence": {

    "answers_with_sources": 60,

    "answers_with_sources_diff": 0

  }

}

List prompts

GET https://api4.seranking.com/sites/{site_id}/airt/llm/{llm_id}/prompts

Retrieves the list of prompts (keywords) tracked by a specific LLM engine with pagination support.

Request parameters

ParameterTypeRequiredDefaultDescription
site_idIntegerYesN/ASite ID (path parameter).
llm_idIntegerYesN/ALLM engine ID (path parameter).
limitIntegerNo100Number of items per page (1–1,000).
offsetIntegerNo0Offset from the beginning of the list.
group_ids[]Array of integersNoN/AFilter by prompt group IDs (repeatable). See AIRT Groups.

Request example

List all prompts

Copy
curl -X GET 'https://api4.seranking.com/sites/11270054/airt/llm/151294/prompts?limit=5&offset=0' \

  -H 'Authorization: Token YOUR_API_KEY'

Filter by prompt groups (repeat group_ids[])

Copy
curl -X GET 'https://api4.seranking.com/sites/11270054/airt/llm/151294/prompts?group_ids[]=12&group_ids[]=18' \

  -H 'Authorization: Token YOUR_API_KEY'

Response parameters

If the site or LLM engine is not found, the API returns the 404 HTTP status code (for more information, see Error handling).

ParameterTypeDescription
site_llm_idIntegerLLM engine ID.
site_idIntegerSite ID.
itemsArrayList of prompt objects (see below).
totalIntegerTotal number of prompts for this LLM.
limitIntegerNumber of items per page.
offsetIntegerOffset from the beginning.

Each item in the items array has the following structure:

ParameterTypeDescription
k2site_llm_idIntegerKeyword-LLM link ID. Use for DELETE and as the path ID in Get prompt answer.
site_llm_idIntegerLLM engine ID.
keyword_idIntegerKeyword ID.
group_idIntegerPrompt group ID.
keywordStringKeyword text.
search_volumeIntegerSearch volume (if available).
intentIntegerKeyword intent (if set).
intent_meaningArray of stringsIntent letters: I, N, L, C, T. null when unset.
Warning: Some numeric fields (keyword_id, site_llm_id, k2site_llm_id, search_volume) may be returned as JSON strings. Consumers should coerce them to integers.

Response example

Copy
{

  "site_llm_id": 151294,

  "site_id": 11270054,

  "items": [

    {

      "k2site_llm_id": "1411621",

      "site_llm_id": "151294",

      "keyword_id": "1021954",

      "group_id": "26377",

      "keyword": "best seo tool",

      "search_volume": "0",

      "intent": "1",

      "intent_meaning": ["I"]

    }

  ],

  "total": 5,

  "limit": 5,

  "offset": 0

}

If the site or LLM engine is not found, the API returns the 404 HTTP status code.

Add prompts

POST https://api4.seranking.com/sites/{site_id}/airt/llm/{llm_id}/prompts

Adds new prompts (keywords) to the specified LLM engine. Duplicate keywords for the same LLM engine are automatically skipped.

Request parameters

ParameterTypeRequiredDescription
site_idIntegerYesSite ID (path parameter).
llm_idIntegerYesLLM engine ID (path parameter).
promptsArray of stringsYesKeywords to add. Minimum 1 item. Each item non-empty (whitespace-only rejected), max 255 characters.
group_idIntegerNoTarget prompt group ID. Defaults to the site’s default group.

Request example

Add to the default group

Copy
curl -X POST 'https://api4.seranking.com/sites/11270054/airt/llm/151294/prompts' \

  -H 'Authorization: Token YOUR_API_KEY' \

  -H 'Content-Type: application/json' \

  -d '{

    "prompts": [

      "best seo tool",

      "seo rank tracker",

      "website audit tool"

    ]

  }'

Add to a specific prompt group

Copy
curl -X POST 'https://api4.seranking.com/sites/11270054/airt/llm/151294/prompts' \

  -H 'Authorization: Token YOUR_API_KEY' \

  -H 'Content-Type: application/json' \

  -d '{

    "prompts": ["best seo tool", "seo rank tracker"],

    "group_id": 12

  }'

Response parameters

Returns the count of actually added keywords (excluding duplicates) in the HTTP status 201. If the site or LLM engine is not found, the API returns the 404 HTTP status code (for more information, see Error handling).

ParameterTypeDescription
site_llm_idIntegerLLM engine ID.
site_idIntegerSite ID.
addedIntegerNumber of keywords actually added (excluding duplicates).
promptsArray\<Integer>Array of k2site_llm_id values for added keywords.

Response example

Copy
{

  "site_llm_id": 151294,

  "site_id": 11270054,

  "added": 3,

  "prompts": [1411621, 1411624, 1411627]

}

Delete prompts

DELETE https://api4.seranking.com/sites/{site_id}/airt/llm/{llm_id}/prompts

Deletes prompts (keywords) from the specified LLM engine by their k2site_llm_id.

Note: Use the List prompts endpoint first to retrieve k2site_llm_id values for keywords you want to delete.

Request parameters

ParameterTypeRequiredDescription
site_idIntegerYesSite ID (path parameter).
llm_idIntegerYesLLM engine ID (path parameter).
k2site_llm_idsArrayYesArray of keyword-LLM link IDs to delete (min 1 item).

Request example

Copy
curl -X DELETE 'https://api4.seranking.com/sites/11270054/airt/llm/151294/prompts' \

  -H 'Authorization: Token YOUR_API_KEY' \

  -H 'Content-Type: application/json' \

  -d '{"k2site_llm_ids": [1411621, 1411624]}'

Response

204 No content — prompts deleted successfully. If the site or LLM engine is not found, the API returns the 404 HTTP status code (for more information, see Error handling).

Get prompt answer

GET
https://api4.seranking.com/sites/{site_id}/airt/llm/{llm_id}/prompts/{k2site_llm_id}/answer
Cost: 0. Retrieving prompt answers does not consume API credits or subscription quota.

Returns the full AI answer text, cited source URLs, detected brand mentions, and, for Google AI Overview engines, the top organic URLs for the tracked prompt on the requested date. Use this endpoint to retrieve the evidence behind the presence and position metrics from /prompts/rankings.

Warning:
  • Pass the k2site_llm_id value from List prompts. The keyword_id field returned by List prompts or Get prompt rankings is a different value and returns 404 Prompt not found for this LLM engine. The same value is echoed back in the response under a third name, prompt_llm_id.
  • Get prompt rankings does not expose k2site_llm_id. If rankings is your discovery source, cross-reference with List prompts to obtain a usable ID.
Note:
  • Answer data is stored per day. To follow answer drift over time, call the endpoint once per date.
  • Available dates come from the /prompts/rankings endpoint.
  • The organic_urls field is returned only for Google AI Overview engines. For other engines (ChatGPT, Perplexity, Gemini), the field is omitted from the response.
Warning:
  • The full text field is retained for 30 days.
  • Presence metrics (sources, brands, organic_urls) are retained for one year.
  • For dates between 30 days and one year old, the endpoint returns the presence metrics with text as an empty string.
  • Dates older than one year return HTTP 400.

Request parameters

ParameterTypeRequiredDefaultDescription
site_idIntegerYesN/ASite ID. Path parameter.
llm_idIntegerYesN/ALLM engine ID. Path parameter.

k2site_llm_id		IntegerYesN/APrompt-LLM link ID from List prompts. Path parameter.
dateStringNoCurrent dateDate of the cached answer, in YYYY-MM-DD format.

Request example

Copy
curl -X GET "https://api4.seranking.com/sites/72193/airt/llm/630/prompts/6739/answer?date=2026-04-01" \

  -H "Authorization: Token YOUR_API_TOKEN"

Response parameters

ParameterTypeDescription
prompt_llm_idIntegerPrompt ID.
Same value as the k2site_llm_id path parameter.
promptStringPrompt text.
site_llm_idIntegerSite LLM association ID.
site_idIntegerSite ID.
dateStringDate of the cached answer, in YYYY-MM-DD format.
textStringFull AI answer text cached on the requested date. Empty for dates older than 30 days.
sourcesArray of ObjectSource URLs cited in the answer, ordered by position.
sources[].urlStringCited source URL.
sources[].positionIntegerPosition of the source in the answer, starting at 1.
brandsArray of ObjectBrands detected in the answer, including the tracked brand and competitors.
brands[].nameStringDetected brand name.
brands[].positionIntegerPosition of the brand in the answer, starting at 1.
organic_urlsArray of ObjectTop organic URLs alongside the AI answer. Returned for Google AI Overview engines, up to 20 items.
organic_urls[].urlStringOrganic result URL.
organic_urls[].positionIntegerOrganic result position, starting at 1.

Response example

Copy
{

  "prompt_llm_id": 6739,

  "prompt": "What are the top fashion trends for Fall/Winter 2025?",

  "site_llm_id": 630,

  "site_id": 72193,

  "date": "2026-04-01",

  "text": "Fall/Winter 2025 fashion trends embrace dramatic, oversized silhouettes and textured luxury, featuring long coats, rich suede, leather blazers, and strong \"collegiate\" preppy styles...",

  "sources": [

    { "url": "https://www.whowhatwear.com/fashion/fall/fashion-week-trends-fall-winter-2025", "position": 1 },

    { "url": "https://facesmag.com/fashion-en/faces-trend-report-the-top-13-trends-for-fall-winter-2025-26/", "position": 2 },

    { "url": "https://www.vogue.com/article/fall-winter-2025-fashion-trends", "position": 3 }

  ],

  "brands": [

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

    { "name": "Who What Wear", "position": 2 },

    { "name": "Glamour", "position": 3 }

  ],

  "organic_urls": [

    { "url": "https://www.vogue.com/article/fall-winter-2025-fashion-trends", "position": 1 },

    { "url": "https://www.whowhatwear.com/fashion/trends/elegant-fall-winter-trends-2025", "position": 2 },

    { "url": "https://www.pinterest.com/ideas/fall-2025-fashion-trends/923550151023/", "position": 3 }

  ]

}

Get prompt rankings

GET https://api4.seranking.com/sites/{site_id}/airt/llm/{llm_id}/prompts/rankings

Retrieves ranking data for all prompts tracked by the specified LLM engine within a date range. Returns positions, URLs, search volume, search intent, and organic-AI overlap data for each keyword.

Request parameters

ParameterTypeRequiredDefaultDescription
site_idIntegerYesN/ASite ID (path parameter).
llm_idIntegerYesN/ALLM engine ID (path parameter).
date_fromStringNoCurrent dateStart date for rankings data (YYYY-MM-DD format).
date_toStringNoCurrent dateEnd date for rankings data (YYYY-MM-DD format).
limitIntegerNo100Number of items per page (1–1000).
offsetIntegerNo0Offset from the beginning of the list.
group_ids[]IntegerNoN/AFilter by prompt group IDs (repeatable).

Request example

Rankings for a date range

Copy
curl -X GET 'https://api4.seranking.com/sites/11270054/airt/llm/151216/prompts/rankings?date_from=2026-02-17&date_to=2026-02-19&limit=2&offset=0' \

  -H 'Authorization: Token YOUR_API_KEY'

Filter by prompt groups (repeat group_ids[])

Copy
curl -X GET 'https://api4.seranking.com/sites/11270054/airt/llm/151216/prompts/rankings?date_from=2026-02-17&date_to=2026-02-19&group_ids[]=12&group_ids[]=18' \

  -H 'Authorization: Token YOUR_API_KEY'

Response parameters

If the site or LLM engine is not found, the API returns the 404 HTTP status code (for more information, see Error handling).

ParameterTypeDescription
site_llm_idIntegerLLM engine ID.
site_idIntegerSite ID.
date_fromStringStart date of the data range.
date_toStringEnd date of the data range.
itemsArrayRankings data grouped by keyword (see below).
totalIntegerTotal number of keywords.
limitIntegerNumber of items per page.
offsetIntegerOffset from the beginning.

Each item in the items array has the following structure:

ParameterTypeDescription
keyword_idIntegerKeyword ID (distinct from
k2site_llm_id; this value is not accepted by Get prompt answer).
keywordStringKeyword text.
search_volumeIntegerMonthly search volume for the keyword.
search_intentArraySearch intent codes:
• I – informational
• N – navigational
• L – local
• C – commercial
• T – transactional
positionsArrayDaily position data (see below).

Each item in the positions array has the following structure:

ParameterTypeDescription
dateStringCheck date.
url_positionIntegerPosition of the site’s URL in AI results:
• null – no AI result block on that date
• 0 – URL not found in results
• 1+ – position in results
urls_countIntegerTotal number of URLs present in AI results. null when no AI result block.
mention_positionIntegerPosition of brand mention in AI results:
• null – no AI result block on that date
• 0 – brand not mentioned
• 1+ – position of mention
mentions_countIntegerTotal number of brand mentions in AI results. null when no AI result block.
organic_overlapIntegerOrganic-AI overlap metric (0–100). null when no AI result block.
organic_overlap_percentIntegerOrganic overlap as percentage (0–100). null when no AI result block.
Note: When position and count fields are null, it means there was no AI result block on that date — not that the brand wasn’t found.

Response examples

Google AI Overview rankings

Copy
{

  "site_llm_id": 151216,

  "site_id": 11270054,

  "date_from": "2026-02-17",

  "date_to": "2026-02-19",

  "items": [

    {

      "keyword_id": 1021696,

      "keyword": "What are the best tools for monitoring backlinks currently on the market?",

      "search_volume": 0,

      "search_intent": ["I"],

      "positions": [

        {

          "date": "2026-02-19",

          "url_position": 0,

          "urls_count": 10,

          "mention_position": 6,

          "mentions_count": 8,

          "organic_overlap": 3,

          "organic_overlap_percent": 15

        }

      ]

    }

  ],

  "total": 5,

  "limit": 2,

  "offset": 0

}

ChatGPT rankings

Copy
{

  "site_llm_id": 151294,

  "site_id": 11270054,

  "date_from": "2026-02-17",

  "date_to": "2026-02-19",

  "items": [

    {

      "keyword_id": 1021954,

      "keyword": "best seo tool",

      "search_volume": null,

      "search_intent": null,

      "positions": [

        {

          "date": "2026-02-19",

          "url_position": 0,

          "urls_count": 25,

          "mention_position": 5,

          "mentions_count": 10,

          "organic_overlap": null,

          "organic_overlap_percent": null

        }

      ]

    }

  ],

  "total": 5,

  "limit": 2,

  "offset": 0

}

If the site or LLM engine is not found, the API returns the 404 HTTP status code.

Learn how SE Ranking’s API can boost your SEO!

Hi! Meet our product experts!

One of them will walk you through the API and show you how to get the most out of it.

  • Enjoy a tailored demo on integrating rich, structured SEO data into your stack.
  • Pin down every tech detail live—auth, endpoints, rate limits, data formats.
  • Compare usage tiers and pricing so you can unlock maximum data value.

Request a free demo to see our tools and integrations in action

By clicking this button, you agree to SE Ranking’s
Terms of Services and Privacy Policy.