Skip to main content

Check Visibility

curl -X POST "https://api.latentgeo.com/llm-visibility/check/123?brand_name=Example%20Corp" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "queries": [
      "What are the best SEO tools?",
      "How to improve website performance?",
      "Top website audit platforms"
    ]
  }'
Check if a brand is mentioned in AI language model responses to specific queries.

Path Parameters

audit_id
integer
required
The ID of the audit to check visibility for

Query Parameters

brand_name
string
required
Brand name to check visibility for in LLM responses

Request Body

queries
array
required
Array of queries to test against various LLMs

Response

Returns an array of visibility records showing if and how the brand appears in LLM responses.
id
integer
Unique identifier for the visibility record
audit_id
integer
The audit ID this visibility check belongs to
llm_name
string
Name of the LLM tested (e.g., “GPT-4”, “Claude”, “Gemini”)
query
string
The query that was tested
is_visible
boolean
Whether the brand was mentioned in the LLM’s response
rank
integer
Position where the brand was mentioned (1 = first mention)
citation_text
string
The exact text snippet where the brand was mentioned
checked_at
string
Timestamp when the visibility was checked (ISO 8601 format)
[
  {
    "id": 1,
    "audit_id": 123,
    "llm_name": "GPT-4",
    "query": "What are the best SEO tools?",
    "is_visible": true,
    "rank": 3,
    "citation_text": "Example Corp offers comprehensive SEO audit capabilities...",
    "checked_at": "2026-03-03T10:30:00Z"
  },
  {
    "id": 2,
    "audit_id": 123,
    "llm_name": "Claude",
    "query": "What are the best SEO tools?",
    "is_visible": false,
    "rank": null,
    "citation_text": null,
    "checked_at": "2026-03-03T10:30:00Z"
  },
  {
    "id": 3,
    "audit_id": 123,
    "llm_name": "Gemini",
    "query": "Top website audit platforms",
    "is_visible": true,
    "rank": 1,
    "citation_text": "Example Corp is a leading platform for website auditing...",
    "checked_at": "2026-03-03T10:31:00Z"
  }
]

Error Codes

401
error
Unauthorized - Invalid or missing authentication token
403
error
Forbidden - User does not have access to this audit
404
error
Not Found - Audit ID does not exist
502
error
Bad Gateway - Kimi AI generation failed. Error code: KIMI_GENERATION_FAILED
503
error
Service Unavailable - Kimi provider not configured. Error code: KIMI_UNAVAILABLE. Ensure NV_API_KEY_ANALYSIS, NVIDIA_API_KEY, or NV_API_KEY is set.

Get Visibility

curl -X GET "https://api.latentgeo.com/llm-visibility/123" \
  -H "Authorization: Bearer YOUR_API_KEY"
Retrieve stored LLM visibility data for an audit.

Path Parameters

audit_id
integer
required
The ID of the audit to retrieve visibility data for

Response

Returns an array of visibility objects with the same structure as the check endpoint.
[
  {
    "id": 1,
    "audit_id": 123,
    "llm_name": "GPT-4",
    "query": "What are the best SEO tools?",
    "is_visible": true,
    "rank": 3,
    "citation_text": "Example Corp offers comprehensive SEO audit capabilities...",
    "checked_at": "2026-03-03T10:30:00Z"
  }
]

Error Codes

401
error
Unauthorized - Invalid or missing authentication token
403
error
Forbidden - User does not have access to this audit
404
error
Not Found - Audit ID does not exist

Build docs developers (and LLMs) love