Skip to main content

​
Research Keywords

curl -X POST "https://api.latentgeo.com/keywords/research/123?domain=example.com" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "seed_keywords": ["seo tools", "audit software", "website analysis"]
  }'
Research keywords for a given audit and domain using AI-powered analysis.

​
Path Parameters

​
audit_id
integer
required
The ID of the audit to research keywords for

​
Query Parameters

​
domain
string
required
Domain to research keywords for

​
Request Body

​
seed_keywords
array
Array of seed keywords to expand and research. If not provided, the system will generate keywords based on domain analysis.

​
Response

Returns an array of keyword objects with search volume, difficulty, and intent data.
​
id
integer
Unique identifier for the keyword record
​
audit_id
integer
The audit ID this keyword belongs to
​
term
string
The keyword or search term
​
volume
integer
Monthly search volume estimate
​
difficulty
integer
Keyword difficulty score (0-100, higher is more competitive)
​
cpc
number
Cost per click in USD for paid advertising
​
intent
string
Search intent classification (e.g., “informational”, “commercial”, “transactional”, “navigational”)
​
created_at
string
Timestamp when the keyword was researched (ISO 8601 format)
[
  {
    "id": 1,
    "audit_id": 123,
    "term": "seo audit tool",
    "volume": 5400,
    "difficulty": 68,
    "cpc": 12.50,
    "intent": "commercial",
    "created_at": "2026-03-03T10:30:00Z"
  },
  {
    "id": 2,
    "audit_id": 123,
    "term": "website seo analysis",
    "volume": 8100,
    "difficulty": 55,
    "cpc": 9.75,
    "intent": "informational",
    "created_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
​
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 Keywords

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

​
Path Parameters

​
audit_id
integer
required
The ID of the audit to retrieve keywords for

​
Response

Returns an array of keyword objects with the same structure as the research endpoint. 
[
  {
    "id": 1,
    "audit_id": 123,
    "term": "seo audit tool",
    "volume": 5400,
    "difficulty": 68,
    "cpc": 12.50,
    "intent": "commercial",
    "created_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

Get started for freeTalk to us