Track Rankings
curl -X POST "https://api.latentgeo.com/rank-tracking/track/123?domain=example.com" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"keywords": ["seo tools", "website audit", "seo analysis"]
}'
Path Parameters
The ID of the audit to track rankings for
Query Parameters
Domain to track rankings for
Request Body
Array of keywords to track rankings for
Response
Returns an array of ranking records with position data and competitor information.
Unique identifier for the ranking record
The audit ID this ranking belongs to
The keyword being tracked
Current search engine ranking position (1-100+)
The URL that is ranking for this keyword
Device type used for tracking (e.g., “mobile”, “desktop”)
Geographic location for the search (e.g., “United States”, “Global”)
Array of top 10 competitor results
Ranking position of the competitor
Timestamp when the ranking was checked (ISO 8601 format)
[
{
"id": 1,
"audit_id": 123,
"keyword": "seo tools",
"position": 8,
"url": "https://example.com/seo-tools",
"device": "desktop",
"location": "United States",
"top_results": [
{
"position": 1,
"url": "https://competitor1.com/tools",
"title": "Best SEO Tools 2026",
"domain": "competitor1.com"
},
{
"position": 2,
"url": "https://competitor2.com/seo",
"title": "Top SEO Tools",
"domain": "competitor2.com"
}
],
"tracked_at": "2026-03-03T10:30:00Z"
},
{
"id": 2,
"audit_id": 123,
"keyword": "website audit",
"position": 3,
"url": "https://example.com/audit",
"device": "mobile",
"location": "United States",
"top_results": [],
"tracked_at": "2026-03-03T10:31:00Z"
}
]
Error Codes
Unauthorized - Invalid or missing authentication token
Forbidden - User does not have access to this audit
Not Found - Audit ID does not exist
Get Rankings
curl -X GET "https://api.latentgeo.com/rank-tracking/123" \
-H "Authorization: Bearer YOUR_API_KEY"
Path Parameters
The ID of the audit to retrieve rankings for
Response
Returns an array of ranking objects with the same structure as the track endpoint.
[
{
"id": 1,
"audit_id": 123,
"keyword": "seo tools",
"position": 8,
"url": "https://example.com/seo-tools",
"device": "desktop",
"location": "United States",
"top_results": [],
"tracked_at": "2026-03-03T10:30:00Z"
}
]
Error Codes
Unauthorized - Invalid or missing authentication token
Forbidden - User does not have access to this audit
Not Found - Audit ID does not exist