LLM Mentions API Fresh

The LLM Mentions API tracks brand, domain, and keyword visibility inside LLM-generated responses. It measures how often a target appears in AI search results, what context surrounds those mentions, and which pages and domains are co-cited.

Use this API to understand your AI search footprint and monitor how it changes over time.

Method: Live only — instant results, no task queue.

Available Endpoints

Endpoint	What it returns
Search Mentions	Detailed structured mentions data — mention counts, quoted links, and citations from AI responses for a keyword or domain
Aggregated Metrics	Consolidated overview of mention metrics across location, language, AI platform, and source domain dimensions
Cross Aggregated Metrics	Batch comparison of mention metrics for multiple domains or keywords in a single request
Top Domains	Domains most frequently mentioned alongside your target keyword or domain
Top Pages	Individual pages most frequently cited in AI responses for a target keyword or domain

Rate Limits

• Up to 2,000 API calls per minute
• Maximum 30 simultaneous requests

Core Metrics Returned

Metric	Description
AI search volume	Estimated number of AI searches performed for the keyword
Impressions	How many times the keyword appeared in LLM-generated results
Mentions count	How many times the target brand/domain was explicitly mentioned
Quoted links	URLs cited by the LLM in response to the query
Top domains	Domains most frequently cited alongside the target
Top pages	Specific pages most frequently cited

Search Mentions Endpoint

POST https://api.dataforseo.com/v3/ai_optimization/llm_mentions/search/live

Returns detailed mention data including the actual citations and linked sources for your target.

Request Parameters

Field	Type	Required	Description
keyword	string	Conditional	Target keyword to track. Required unless target is specified.
target	string	Conditional	Target domain or brand name. Required unless keyword is specified.
location_code	integer	No	Location code for geolocation targeting.
language_code	string	No	Language code (e.g., "en").
limit	integer	No	Number of results to return.
offset	integer	No	Pagination offset.

cURL Example — Search Mentions

curl --request POST \
  --url https://api.dataforseo.com/v3/ai_optimization/llm_mentions/search/live \
  --header 'Authorization: Basic BASE64(login:password)' \
  --header 'Content-Type: application/json' \
  --data '[
    {
      "keyword": "best roofing contractors",
      "location_code": 2840,
      "language_code": "en"
    }
  ]'

Aggregated Metrics Endpoint

POST https://api.dataforseo.com/v3/ai_optimization/llm_mentions/aggregated_metrics/live

Returns a high-level rollup of mention metrics broken down by:

• Location
• Language
• AI platform (ChatGPT, Gemini, etc.)
• Source domains cited in responses

Use this for dashboard-style reporting across multiple dimensions without iterating through individual mention records.

cURL Example — Aggregated Metrics

curl --request POST \
  --url https://api.dataforseo.com/v3/ai_optimization/llm_mentions/aggregated_metrics/live \
  --header 'Authorization: Basic BASE64(login:password)' \
  --header 'Content-Type: application/json' \
  --data '[
    {
      "target": "yourbrand.com",
      "location_code": 2840,
      "language_code": "en"
    }
  ]'

Cross Aggregated Metrics Endpoint

POST https://api.dataforseo.com/v3/ai_optimization/llm_mentions/cross_aggregated_metrics/live

Compare multiple targets (brands or domains) in one request. Useful for competitive benchmarking — see how your AI mention count compares to 5–10 competitors in a single API call.

cURL Example — Competitor Comparison

curl --request POST \
  --url https://api.dataforseo.com/v3/ai_optimization/llm_mentions/cross_aggregated_metrics/live \
  --header 'Authorization: Basic BASE64(login:password)' \
  --header 'Content-Type: application/json' \
  --data '[
    {
      "targets": ["yourbrand.com", "competitor-a.com", "competitor-b.com"],
      "location_code": 2840,
      "language_code": "en"
    }
  ]'

Top Domains Endpoint

POST https://api.dataforseo.com/v3/ai_optimization/llm_mentions/top_domains/live

Returns the domains most frequently cited alongside the keyword or domain you specify. Use this to understand which websites LLMs treat as authoritative sources for your topic area.

Top Pages Endpoint

POST https://api.dataforseo.com/v3/ai_optimization/llm_mentions/top_pages/live

Returns specific page-level citations — the exact URLs that LLMs most frequently reference when responding to queries related to your keyword or domain.

Python Example — Brand Mention Monitoring

import requests
from requests.auth import HTTPBasicAuth
import json

def get_llm_mentions(target_domain, location_code=2840, language_code="en"):
    payload = [{
        "target": target_domain,
        "location_code": location_code,
        "language_code": language_code
    }]

    response = requests.post(
        "https://api.dataforseo.com/v3/ai_optimization/llm_mentions/aggregated_metrics/live",
        auth=HTTPBasicAuth("your_login", "your_password"),
        headers={"Content-Type": "application/json"},
        data=json.dumps(payload)
    )

    return response.json()


def compare_competitors(domains, location_code=2840, language_code="en"):
    payload = [{
        "targets": domains,
        "location_code": location_code,
        "language_code": language_code
    }]

    response = requests.post(
        "https://api.dataforseo.com/v3/ai_optimization/llm_mentions/cross_aggregated_metrics/live",
        auth=HTTPBasicAuth("your_login", "your_password"),
        headers={"Content-Type": "application/json"},
        data=json.dumps(payload)
    )

    return response.json()


# Track your brand
my_data = get_llm_mentions("mybrand.com")
print(json.dumps(my_data["tasks"][0]["result"], indent=2))

# Compare against competitors
comparison = compare_competitors([
    "mybrand.com",
    "competitor1.com",
    "competitor2.com"
])
print(json.dumps(comparison["tasks"][0]["result"], indent=2))

Workflow: Building an AI Visibility Dashboard

1. Baseline: Run Cross Aggregated Metrics for your domain and top 5 competitors. Record mention counts and impressions.
2. Keyword mapping: Run Search Mentions for your primary target keywords. Identify which topics drive the most AI citations.
3. Source analysis: Run Top Domains to see which sites LLMs cite alongside your brand. These are your citation competitors.
4. Page-level gaps: Run Top Pages to identify which specific pages are getting AI citations — and which of yours are not.
5. Trend tracking: Run Aggregated Metrics weekly to detect changes in AI visibility.

Notes

• LLM Mentions API supports Live method only — no task queue required.
• Data covers aggregated historical mentions, not real-time live LLM queries.
• The quoted_links field in Search Mentions shows which URLs the LLM cited — these are the pages earning AI traffic.
• Impressions and mention counts are distinct metrics: impressions track how many times the keyword appeared in AI-generated content; mentions track how many times your specific brand/domain was referenced.