My Apps

Manage the apps you track in your appeeky.com account. These are the same apps visible under My Apps in the web dashboard.

All My Apps endpoints cost 0 credits (except the release timeline, 1 credit per call) and require the apps:read scope for reads and apps:write for writes.

List My Apps

GET /v1/user/apps

Returns all apps in your tracked list, ordered by most recently added.

curl "https://api.appeeky.com/v1/user/apps" \
  -H "X-API-Key: YOUR_API_KEY"

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

import requests

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

Response (200 OK):

{
  "data": [
    {
      "id": "c3f0961b-e252-469b-9d5e-d294d721032e",
      "app_id": 6443843426,
      "app_name": "Appeeky",
      "app_icon_url": "https://...",
      "developer_name": "Appeeky Inc.",
      "bundle_id": "com.appeeky.app",
      "subtitle": "ASO & Keyword Intelligence",
      "description": "...",
      "languages": ["en", "tr"],
      "is_live": true,
      "category": "Productivity",
      "platform": "ios",
      "created_at": "2026-03-19T15:47:06.270736+00:00"
    }
  ]
}

Add an App

POST /v1/user/apps

Add an app to your tracked list by its numeric App Store ID. Request Body:

Field	Type	Required	Description
`appId`	number	Yes	Numeric Apple App Store ID
`appName`	string	No	App display name
`developerName`	string	No	Developer name
`bundleId`	string	No	Bundle identifier (e.g. `com.example.app`)
`subtitle`	string	No	App subtitle
`description`	string	No	App description
`languages`	string[]	No	Supported language codes
`isLive`	boolean	No	Whether the app is live on the App Store (default: `false`)
`category`	string	No	App category
`platform`	string	No	`ios`, `macos`, or `tvos` (default: `ios`)

curl -X POST "https://api.appeeky.com/v1/user/apps" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"appId": 6443843426, "appName": "Appeeky", "platform": "ios"}'

const res = await fetch("https://api.appeeky.com/v1/user/apps", {
  method: "POST",
  headers: {
    "X-API-Key": "YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ appId: 6443843426, appName: "Appeeky", platform: "ios" }),
});
const { data } = await res.json();

import requests

res = requests.post(
    "https://api.appeeky.com/v1/user/apps",
    headers={"X-API-Key": "YOUR_API_KEY"},
    json={"appId": 6443843426, "appName": "Appeeky", "platform": "ios"},
)
data = res.json()["data"]

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

Update an App

PATCH /v1/user/apps/:appId

Update metadata for an app in your list. Only provide the fields you want to change. Path Parameters:

Name	Type	Description
`appId`	number	Numeric App Store ID of the app to update

Request Body: Same optional fields as Add (all optional).

curl -X PATCH "https://api.appeeky.com/v1/user/apps/6443843426" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"isLive": true, "category": "Productivity"}'

const res = await fetch("https://api.appeeky.com/v1/user/apps/6443843426", {
  method: "PATCH",
  headers: {
    "X-API-Key": "YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ isLive: true, category: "Productivity" }),
});
const { data } = await res.json();

import requests

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

Response (200 OK): Returns the updated app row.

Remove an App

DELETE /v1/user/apps/:appId

Remove an app from your tracked list. Path Parameters:

Name	Type	Description
`appId`	number	Numeric App Store ID of the app to remove

curl -X DELETE "https://api.appeeky.com/v1/user/apps/6443843426" \
  -H "X-API-Key: YOUR_API_KEY"

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

import requests

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

Response (200 OK):

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

Release Timeline

The same change log Appeeky keeps for competitors, for your own app: version releases, metadata and description changes, screenshots, promotional text, price and rating changes. Use it to line up ranking or download changes with what you shipped.

Method	Endpoint	Description	Credits
GET	`/v1/user/apps/:appId/release/timeline`	Change events for your app, newest first	1
POST	`/v1/user/apps/:appId/release/track`	Check your listing for changes now	1

Release tracking requires a paid plan.

Name	Type	Default	Description
`country`	string	`us`	Storefront (query for the timeline, body for `track`)
`sinceDays`	number	`120`	Lookback, 7–365
`limit`	number	`200`	Max events, 1–500

Events have the same fields as the competitor timeline, with app_id instead of competitor_app_id. kind is version_release, metadata_update, description_rewrite, promotional_content, screenshot_change, price_change or rating_change. POST …/release/track returns { "data": { "queued": 1, "userAppId": "…" } }.

Errors

Status	Code	When
400	`BAD_REQUEST`	`appId` missing or not a number
403	`FORBIDDEN`	Key scope does not allow this operation
404	`USER_NOT_FOUND`	No appeeky.com account linked to this key
404	`NOT_FOUND`	App not found in your list
409	`DUPLICATE`	App already in your list
403	`PLAN_REQUIRED`	Release tracking isn’t included in your plan
503	`TRACK_UNAVAILABLE`	A release check couldn’t be queued. Try again later

My Data - Appeeky Web

AI Visibility

SEO for Apps

Growth Channels

UGC & Phones

List My Apps

Add an App

Update an App

Remove an App

Release Timeline

Errors

​List My Apps

​Add an App

​Update an App

​Remove an App

​Release Timeline

​Errors

List My Apps

Add an App

Update an App

Remove an App

Release Timeline

Errors