Competitors

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

Returns all competitor apps tracked for a given app. Path Parameters:

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"

const res = await fetch(
  "https://api.appeeky.com/v1/user/apps/6443843426/competitors",
  { headers: { "X-API-Key": "YOUR_API_KEY" } }
);
const { data } = await res.json();

import requests

res = requests.get(
    "https://api.appeeky.com/v1/user/apps/6443843426/competitors",
    headers={"X-API-Key": "YOUR_API_KEY"},
)
data = res.json()["data"]

Response (200 OK):

{
  "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

Add a competitor app by App Store numeric ID or Google Play package name. Path Parameters:

Name	Type	Description
`appId`	number	Numeric App Store ID of your tracked app (or synthetic id for Android)

Request Body:

Field	Type	Required	Description
`competitorAppId`	number \| string	Yes*	App Store ID (number) or Play package name (string)
`competitorStoreAppId`	string	Yes*	Canonical store id (preferred for Play packages)
`platform` / `competitorPlatform`	string	No	`apple`/`ios` or `google`/`android` — inferred when omitted
`competitorName`	string	No	Display name for the competitor

* Provide competitorAppId and/or competitorStoreAppId.

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"}'

const res = await fetch(
  "https://api.appeeky.com/v1/user/apps/6443843426/competitors",
  {
    method: "POST",
    headers: {
      "X-API-Key": "YOUR_API_KEY",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({ competitorAppId: 1547223625, competitorName: "Sensor Tower" }),
  }
);
const { data } = await res.json();

import requests

res = requests.post(
    "https://api.appeeky.com/v1/user/apps/6443843426/competitors",
    headers={"X-API-Key": "YOUR_API_KEY"},
    json={"competitorAppId": 1547223625, "competitorName": "Sensor Tower"},
)
data = res.json()["data"]

Response (201 Created): Returns the created competitor row.

Remove a Competitor

DELETE /v1/user/apps/:appId/competitors/:competitorAppId

Remove a competitor from a tracked app. Path Parameters:

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"

const res = await fetch(
  "https://api.appeeky.com/v1/user/apps/6443843426/competitors/1547223625",
  { method: "DELETE", headers: { "X-API-Key": "YOUR_API_KEY" } }
);

import requests

requests.delete(
    "https://api.appeeky.com/v1/user/apps/6443843426/competitors/1547223625",
    headers={"X-API-Key": "YOUR_API_KEY"},
)

Response (200 OK):

{ "data": { "success": true } }

Competitor Change Timeline

Appeeky watches each competitor’s store listing and logs what changed: new versions, metadata and description rewrites, screenshots, promotional text, price and rating changes, and Apple Ads activity. This is the timeline on the Competitors tab.

Method	Endpoint	Description	Credits
GET	`/v1/user/apps/:appId/competitors/timeline`	Change events for all competitors of an app, newest first	0
POST	`/v1/user/apps/:appId/competitors/track`	Check every competitor for changes now	0

Competitor tracking requires a paid plan.

Query parameters (timeline)

Name	Type	Default	Description
`country`	string	`us`	Storefront
`sinceDays`	number	`90`	Lookback, 7–365
`limit`	number	`200`	Max events, 1–500

curl "https://api.appeeky.com/v1/user/apps/6443843426/competitors/timeline?sinceDays=30" \
  -H "X-API-Key: YOUR_API_KEY"

{
  "data": [
    {
      "id": "evt_123",
      "competitor_app_id": 1547223625,
      "country": "us",
      "kind": "version_release",
      "field": null,
      "significance": "medium",
      "title": "Version 5.2",
      "summary": "New widgets and a redesigned onboarding.",
      "before_value": null,
      "after_value": null,
      "occurred_at": "2026-10-28T00:00:00.000Z",
      "detected_at": "2026-10-28T06:10:00.000Z"
    }
  ]
}

Field	Meaning
`kind`	`version_release`, `metadata_update`, `description_rewrite`, `promotional_content`, `price_change`, `rating_change` or `apple_ads`
`field`	Which listing field changed, for metadata events
`significance`	`low`, `medium` or `high`
`before_value`, `after_value`	The old and new value, when the change has one
`occurred_at`	When the change happened (release date for versions)
`detected_at`	When Appeeky noticed it

Competitors are checked on a schedule. POST …/competitors/track (body: { "country": "us" }) queues a check for every competitor right away and returns { "data": { "queued": 3, "competitorIds": ["…"] } }. New events appear on the timeline a few minutes later.

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
403	`PLAN_REQUIRED`	Competitor tracking isn’t included in your plan

My Data - Appeeky Web

AI Visibility

SEO for Apps

Growth Channels

UGC & Phones

List Competitors

Add a Competitor

Remove a Competitor

Competitor Change Timeline

Query parameters (timeline)

Errors

​List Competitors

​Add a Competitor

​Remove a Competitor

​Competitor Change Timeline

​Query parameters (timeline)

​Errors

List Competitors

Add a Competitor

Remove a Competitor

Competitor Change Timeline

Query parameters (timeline)

Errors