GET /v1/apps/:id/screenshots
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) |
| device | string | all | Device filter: iphone, ipad, or all |
Code Examples
curl -X GET "https://api.appeeky.com/v1/apps/1617391485/screenshots?country=us&device=all" \
-H "X-API-Key: YOUR_API_KEY"
Response
{
"data": {
"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",
"https://is1-ssl.mzstatic.com/image/thumb/Purple211/v4/.../screen4.jpg"
],
"ipad": [
"https://is1-ssl.mzstatic.com/image/thumb/Purple211/v4/.../ipad-screen1.jpg",
"https://is1-ssl.mzstatic.com/image/thumb/Purple211/v4/.../ipad-screen2.jpg"
]
},
"totalCount": 6
}
}
Response with device=iphone
When filtering by device, only the requested device array is populated:
{
"data": {
"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"
],
"ipad": []
},
"totalCount": 2
}
}
Response Fields
| 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 |
| totalCount | number | Total number of screenshots returned |
Screenshots Object
| Field | Type | Description |
|---|
| iphone | string[] | iPhone screenshot URLs |
| ipad | string[] | iPad screenshot URLs |
Use device=iphone or device=ipad to reduce response size when you only need screenshots for a specific device. The default all returns both.
Screenshot URLs are served from Apple’s CDN (is1-ssl.mzstatic.com). They are high-resolution and suitable for display at full size. The number of screenshots varies by app — most apps have 5-10 iPhone screenshots and 0-5 iPad screenshots.
Errors
| Status | Code | When |
|---|
| 400 | INVALID_APP_ID | Non-numeric or missing app ID |
| 400 | INVALID_DEVICE | Device not iphone, ipad, or all |
| 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 |
