Keywords and GEO
List previously computed keyword suggestions
Does not trigger research, generation or a quota debit.
GET
/
profiles
/
{profile_id}
/
keywords
Error
A valid request URL is required to generate request examples{
"data": [
{
"id": "11111111-1111-4111-8111-111111111111",
"profile_id": "22222222-2222-4222-8222-222222222222",
"keyword": "sustainable travel",
"search_volume": 120,
"keyword_difficulty": 24.5,
"cpc": 1.2,
"language": "en",
"is_used": false,
"created_at": "2026-09-24T09:00:00+00:00"
}
],
"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
keywords:read
Read existing keyword suggestions.
Path Parameters
Profile UUID; must be in the grant allowlist and currently accessible to the actor.
Query Parameters
Opaque cursor returned by the preceding page; do not construct it.
Minimum string length:
1Page size, subject to the configured bound; stable ordering includes an ID tie-breaker.
Required range:
1 <= x <= 100⌘I
Error
A valid request URL is required to generate request examples{
"data": [
{
"id": "11111111-1111-4111-8111-111111111111",
"profile_id": "22222222-2222-4222-8222-222222222222",
"keyword": "sustainable travel",
"search_volume": 120,
"keyword_difficulty": 24.5,
"cpc": 1.2,
"language": "en",
"is_used": false,
"created_at": "2026-09-24T09:00:00+00:00"
}
],
"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
}
}