Keywords and GEO
Get the evolution of GEO mentions
Weekly (ISO weeks starting Monday) mentions of the site per AI model over the period ending today; the first and last weeks only count days inside the period. Read as the Sorank dashboard shows it to the same user. Does not trigger a new analysis or consume GEO quota.
GET
/
profiles
/
{profile_id}
/
geo
/
mentions-evolution
Error
A valid request URL is required to generate request examples{
"data": {
"period": "7d",
"range": {
"start": "2023-12-25",
"end": "2023-12-25"
},
"total_mentions": 123,
"models": {
"chatgpt": 123,
"claude": 123,
"gemini": 123,
"grok": 123,
"perplexity": 123
},
"weeks": [
{
"week_start": "2023-12-25",
"total": 123,
"models": {
"chatgpt": 123,
"claude": 123,
"gemini": 123,
"grok": 123,
"perplexity": 123
}
}
]
},
"meta": {
"request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"pagination": {
"limit": 50,
"has_more": true,
"next_cursor": "<string>"
},
"catalog": {
"available_count": 1,
"enriched_count": 1,
"truncated": true
}
}
}{
"error": {
"code": "insufficient_quota",
"message": "The current article generation quota is exhausted.",
"request_id": "33333333-3333-4333-8333-333333333333",
"retryable": false
}
}{
"error": {
"code": "insufficient_quota",
"message": "The current article generation quota is exhausted.",
"request_id": "33333333-3333-4333-8333-333333333333",
"retryable": false
}
}Authorizations
OAuth2PersonalAPIKey
Authorization-code grant with PKCE S256, exact scopes, explicit resource audience and a persisted consent grant. Obtain endpoint URLs from server discovery in the target environment. Refresh tokens remain client-bound.
FlowAuthorization Code
- Authorization URL
- /oauth/authorize
- Token URL
- /oauth/token
- Refresh URL
- /oauth/token
Scopes1
geo:read
Read existing GEO analyses.
Path Parameters
Profile UUID; must be in the grant allowlist and currently accessible to the actor.
Query Parameters
Window ending today.
Available options:
7d, 30d, 90d, 6m, 12m ⌘I
Error
A valid request URL is required to generate request examples{
"data": {
"period": "7d",
"range": {
"start": "2023-12-25",
"end": "2023-12-25"
},
"total_mentions": 123,
"models": {
"chatgpt": 123,
"claude": 123,
"gemini": 123,
"grok": 123,
"perplexity": 123
},
"weeks": [
{
"week_start": "2023-12-25",
"total": 123,
"models": {
"chatgpt": 123,
"claude": 123,
"gemini": 123,
"grok": 123,
"perplexity": 123
}
}
]
},
"meta": {
"request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"pagination": {
"limit": 50,
"has_more": true,
"next_cursor": "<string>"
},
"catalog": {
"available_count": 1,
"enriched_count": 1,
"truncated": true
}
}
}{
"error": {
"code": "insufficient_quota",
"message": "The current article generation quota is exhausted.",
"request_id": "33333333-3333-4333-8333-333333333333",
"retryable": false
}
}{
"error": {
"code": "insufficient_quota",
"message": "The current article generation quota is exhausted.",
"request_id": "33333333-3333-4333-8333-333333333333",
"retryable": false
}
}