Manage the keywords tracked for any app in your list. Tracked keywords power the keyword rank monitoring shown on the Keywords tab in the appeeky.com dashboard.
All Tracked Keyword endpoints cost 0 credits and require the apps:read scope for reads and apps:write for writes.
List Tracked Keywords
GET /v1/user/apps/:appId/keywords
| Name | Type | Description |
|---|
appId | number | Numeric App Store ID of your tracked app |
curl "https://api.appeeky.com/v1/user/apps/6443843426/keywords" \
-H "X-API-Key: YOUR_API_KEY"
{
"data": [
{
"id": "7e4a1c90-...",
"keyword": "aso tool",
"country": "us",
"language": "en",
"created_at": "2026-03-19T15:47:06.270736+00:00"
}
]
}
Add a Tracked Keyword
POST /v1/user/apps/:appId/keywords
| Name | Type | Description |
|---|
appId | number | Numeric App Store ID of your tracked app |
| Field | Type | Required | Description |
|---|
keyword | string | Yes | The keyword to track (e.g. "aso tool") |
country | string | No | ISO country code (default: "us") |
language | string | No | ISO language code (default: "en") |
curl -X POST "https://api.appeeky.com/v1/user/apps/6443843426/keywords" \
-H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"keyword": "aso tool", "country": "us", "language": "en"}'
Remove a Tracked Keyword
DELETE /v1/user/apps/:appId/keywords/:keywordId
| Name | Type | Description |
|---|
appId | number | Numeric App Store ID of your tracked app |
keywordId | string | UUID of the tracked keyword row |
curl -X DELETE "https://api.appeeky.com/v1/user/apps/6443843426/keywords/7e4a1c90-..." \
-H "X-API-Key: YOUR_API_KEY"
{ "data": { "success": true } }
Errors
| Status | Code | When |
|---|
| 400 | BAD_REQUEST | keyword field missing or appId is not a number |
| 403 | FORBIDDEN | Key scope does not allow this operation |
| 404 | USER_APP_NOT_FOUND | appId is not in your tracked list |
| 404 | NOT_FOUND | Keyword row not found |
| 409 | DUPLICATE | Keyword already tracked for this app + country |
