Get the competitors cited in a GEO analysis
Competitors that AI answers cited in the analysis, most mentioned first, with the AI models whose answers cite each one with the most sources. The analysis must belong to the profile; an analysis of another profile returns not_found. Read as the Sorank dashboard shows it to the same user. Does not trigger a new analysis or consume GEO quota.
A valid request URL is required to generate request examples{
"data": {
"analysis_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"total_count": 123,
"limit": 123,
"competitors": [
{
"name": "<string>",
"mentions": 123,
"top_models": [
"<string>"
],
"top_model_sources": 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
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.
- Authorization URL
- /oauth/authorize
- Token URL
- /oauth/token
- Refresh URL
- /oauth/token
Path Parameters
Profile UUID; must be in the grant allowlist and currently accessible to the actor.
Resource UUID, scoped by the path profile or persisted operation receipt.
Query Parameters
List size from 1 to the configured maximum (100); an out-of-range or malformed value returns invalid_limit.
1 <= x <= 100A valid request URL is required to generate request examples{
"data": {
"analysis_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"total_count": 123,
"limit": 123,
"competitors": [
{
"name": "<string>",
"mentions": 123,
"top_models": [
"<string>"
],
"top_model_sources": 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
}
}