Keywords
List Keywords
Lists the keywords your campaign targets, with topic, cluster, search volume, difficulty and intent.
GET
https://app.tryredrover.com/api/public/v1/keywordsScope:
keywords:readAI Connector Tool: redrover_list_keywordsHeaders
AuthorizationstringRequiredBearerfollowed by anrr_live_API key or a connected app's access token. See Authentication.X-Workspace-IdstringRequiredThe workspace to act on, from List Workspaces.
UUID
Query Parameters
limitintegerHow many results to return, 1 to 100 (default 25)
1 to 100 · default 25
offsetintegerHow many results to skip (default 0)
default 0
Response
200 A page of keywords.
dataobject[]RequiredShow 9 Child FieldsHide Child Fields
idstringRequiredKeyword ID (UUID)
keywordstringRequiredtopicstringRequiredThe topic it belongs to
nullable
clusterstringRequiredThe keyword cluster
nullable
searchVolumenumberRequiredMonthly search volume
nullable
difficultynumberRequiredRanking difficulty, 0 to 100
nullable
intentstringRequiredSearch intent
nullable
funnelStagestringRequirednullable
createdAtstringRequiredISO 8601 datetime
paginationobjectRequiredShow 3 Child FieldsHide Child Fields
limitintegerRequiredPage size used for this response
offsetintegerRequiredHow many results were skipped
hasMorebooleanRequiredTrue when more results follow at a higher offset
Errors
Every error uses the error envelope.
400limit or offset is not valid401The Authorization header is missing, or the key is invalid or revoked403The key lacks the endpoint's scope, or cannot reach the workspace429More than 120 requests in a minute. Wait for Retry-After seconds500Something went wrong on our side
curl "https://app.tryredrover.com/api/public/v1/keywords?limit=25" \
-H "Authorization: Bearer $REDROVER_API_KEY" \
-H "X-Workspace-Id: $REDROVER_WORKSPACE_ID"{
"data": [
{
"id": "0b7e3f5a-2c4d-4e6f-9a1b-3c5d7e9f1a2b",
"keyword": "product analytics for startups",
"topic": "Product Analytics",
"cluster": "Analytics Tools",
"searchVolume": 1900,
"difficulty": 38,
"intent": "commercial",
"funnelStage": "consideration",
"createdAt": "2026-10-02T12:00:00Z"
}
],
"pagination": {
"limit": 25,
"offset": 0,
"hasMore": false
}
}