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 and require the apps:read scope for reads and apps:write for writes.
List My 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"
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
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"}'
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"}'
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"
Response (200 OK):
{ "data": { "success": true } }
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 |