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.
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 |