GET /v1/apps/:id/screenshots/competitors
Path Parameters
| Name | Type | Required | Description |
|---|
| id | string | Yes | Apple App ID (numeric, e.g. 1617391485) |
Query Parameters
| Name | Type | Default | Description |
|---|
| country | string | us | ISO country code (e.g. us, gb, de, jp) |
| limit | number | 5 | Number of competitor apps to include (1-10) |
Code Examples
curl -X GET "https://api.appeeky.com/v1/apps/1617391485/screenshots/competitors?country=us&limit=5" \
-H "X-API-Key: YOUR_API_KEY"
Response
{
"data": {
"appId": "1617391485",
"apps": [
{
"appId": "1617391485",
"title": "Block Blast!",
"developer": "Hungry Studio",
"icon": "https://is1-ssl.mzstatic.com/image/thumb/Purple211/v4/.../512x512bb.jpg",
"screenshots": {
"iphone": [
"https://is1-ssl.mzstatic.com/image/thumb/Purple211/v4/.../screen1.jpg",
"https://is1-ssl.mzstatic.com/image/thumb/Purple211/v4/.../screen2.jpg",
"https://is1-ssl.mzstatic.com/image/thumb/Purple211/v4/.../screen3.jpg"
],
"ipad": [
"https://is1-ssl.mzstatic.com/image/thumb/Purple211/v4/.../ipad1.jpg"
]
},
"screenshotCount": 4
},
{
"appId": "1594703498",
"title": "Woodoku",
"developer": "Tripledot Studios",
"icon": "https://is1-ssl.mzstatic.com/image/thumb/Purple211/v4/.../512x512bb.jpg",
"screenshots": {
"iphone": [
"https://is1-ssl.mzstatic.com/image/thumb/Purple211/v4/.../screen1.jpg",
"https://is1-ssl.mzstatic.com/image/thumb/Purple211/v4/.../screen2.jpg"
],
"ipad": []
},
"screenshotCount": 2
},
{
"appId": "1614645498",
"title": "Cube Block - Puzzle Games",
"developer": "Easybrain",
"icon": "https://is1-ssl.mzstatic.com/image/thumb/Purple211/v4/.../512x512bb.jpg",
"screenshots": {
"iphone": [
"https://is1-ssl.mzstatic.com/image/thumb/Purple211/v4/.../screen1.jpg",
"https://is1-ssl.mzstatic.com/image/thumb/Purple211/v4/.../screen2.jpg",
"https://is1-ssl.mzstatic.com/image/thumb/Purple211/v4/.../screen3.jpg"
],
"ipad": [
"https://is1-ssl.mzstatic.com/image/thumb/Purple211/v4/.../ipad1.jpg",
"https://is1-ssl.mzstatic.com/image/thumb/Purple211/v4/.../ipad2.jpg"
]
},
"screenshotCount": 5
}
]
}
}
Response Fields
| Field | Type | Description |
|---|
| appId | string | The target app’s Apple App ID |
| apps | array | Array of app screenshot entries (target app first, then competitors) |
App Screenshot Entry
| Field | Type | Description |
|---|
| appId | string | Apple App ID |
| title | string | App name |
| developer | string | Developer / publisher name |
| icon | string | App icon URL (512px) |
| screenshots | object | Screenshot URLs grouped by device |
| screenshotCount | number | Total screenshots (iPhone + iPad) |
Screenshots Object
| Field | Type | Description |
|---|
| iphone | string[] | iPhone screenshot URLs |
| ipad | string[] | iPad screenshot URLs |
The first entry in the apps array is always the target app itself. This makes it easy to compare — just iterate the array and the first element is your baseline.
Competitors are automatically detected using a 3-layer matching algorithm: keyword overlap from the database, title search with genre filtering, and same-developer apps. The quality of competitor detection improves when the app has keyword ranking data in the system.
Errors
| Status | Code | When |
|---|
| 400 | INVALID_APP_ID | Non-numeric or missing app ID |
| 401 | MISSING_API_KEY | No API key in the request |
| 401 | INVALID_API_KEY | Invalid or expired API key |
| 404 | APP_NOT_FOUND | App not found or unavailable in the specified country |
