Track competitor apps against each of your tracked apps. Competitors are displayed on the Competitors tab in the appeeky.com dashboard.
All Competitor endpoints cost 0 credits and require the apps:read scope for reads and apps:write for writes.
List Competitors
GET /v1/user/apps/:appId/competitors
| Name | Type | Description |
|---|
appId | number | Numeric App Store ID of your tracked app |
curl "https://api.appeeky.com/v1/user/apps/6443843426/competitors" \
-H "X-API-Key: YOUR_API_KEY"
{
"data": [
{
"id": "a4b1d302-...",
"competitor_app_id": 1547223625,
"competitor_name": "Voice Tape Record",
"competitor_icon_url": "https://...",
"created_at": "2026-03-19T15:47:06.270736+00:00"
}
]
}
Add a Competitor
POST /v1/user/apps/:appId/competitors
| Name | Type | Description |
|---|
appId | number | Numeric App Store ID of your tracked app |
| Field | Type | Required | Description |
|---|
competitorAppId | number | Yes | Numeric App Store ID of the competitor |
competitorName | string | No | Display name for the competitor |
curl -X POST "https://api.appeeky.com/v1/user/apps/6443843426/competitors" \
-H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"competitorAppId": 1547223625, "competitorName": "Sensor Tower"}'
Remove a Competitor
DELETE /v1/user/apps/:appId/competitors/:competitorAppId
| Name | Type | Description |
|---|
appId | number | Numeric App Store ID of your tracked app |
competitorAppId | number | Numeric App Store ID of the competitor to remove |
curl -X DELETE "https://api.appeeky.com/v1/user/apps/6443843426/competitors/1547223625" \
-H "X-API-Key: YOUR_API_KEY"
{ "data": { "success": true } }
Errors
| Status | Code | When |
|---|
| 400 | BAD_REQUEST | appId or competitorAppId 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 | Competitor not found |
| 409 | DUPLICATE | Competitor already tracked for this app |
