> ## Documentation Index
> Fetch the complete documentation index at: https://docs.appeeky.com/llms.txt
> Use this file to discover all available pages before exploring further.

# My Apps

> List, add, update, and delete apps in your appeeky.com tracked app list

Manage the apps you track in your [appeeky.com](https://appeeky.com) account. These are the same apps visible under **My Apps** in the web dashboard.

![Appeeky My Apps Dashboard](https://mintcdn.com/storetrack/zMkSF5E0RxX7W7dg/appeeky-my-app-cover.png?fit=max\&auto=format\&n=zMkSF5E0RxX7W7dg\&q=85\&s=e3b7f0bc6654e1069b97d49097c038d5)

> [!NOTE]
>
> All My Apps endpoints cost **0 credits** (except the [release timeline](#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.

```bash cURL theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl "https://api.appeeky.com/v1/user/apps" \
  -H "X-API-Key: YOUR_API_KEY"
```

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

```python Python theme={"theme":{"light":"github-light","dark":"github-dark"}}
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):**

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "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`) |

```bash cURL theme={"theme":{"light":"github-light","dark":"github-dark"}}
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"}'
```

```javascript JavaScript theme={"theme":{"light":"github-light","dark":"github-dark"}}
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();
```

```python Python theme={"theme":{"light":"github-light","dark":"github-dark"}}
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).

```bash cURL theme={"theme":{"light":"github-light","dark":"github-dark"}}
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"}'
```

```javascript JavaScript theme={"theme":{"light":"github-light","dark":"github-dark"}}
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();
```

```python Python theme={"theme":{"light":"github-light","dark":"github-dark"}}
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 |

```bash cURL theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl -X DELETE "https://api.appeeky.com/v1/user/apps/6443843426" \
  -H "X-API-Key: YOUR_API_KEY"
```

```javascript JavaScript theme={"theme":{"light":"github-light","dark":"github-dark"}}
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 }
```

```python Python theme={"theme":{"light":"github-light","dark":"github-dark"}}
import requests

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

**Response (200 OK):**

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{ "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](https://docs.appeeky.com/docs/my-apps-competitors.md#competitor-change-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 |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.