GET /v1/categories/:genreId/top/screenshots
Path Parameters
| Name | Type | Required | Description |
|---|
| genreId | string | Yes | Genre ID from the categories list (e.g. 6014 for Games, or all) |
Query Parameters
| Name | Type | Default | Description |
|---|
| country | string | us | ISO country code (e.g. us, gb, de, jp) |
| chart | string | top-free | Chart type: top-free, top-paid, or top-grossing |
| limit | number | 10 | Number of apps to include (1-25) |
Code Examples
curl -X GET "https://api.appeeky.com/v1/categories/6014/top/screenshots?country=us&chart=top-free&limit=10" \
-H "X-API-Key: YOUR_API_KEY"
Response
{
"data": {
"genreId": "6014",
"chart": "top-free",
"country": "us",
"apps": [
{
"rank": 1,
"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
},
{
"rank": 2,
"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
},
{
"rank": 3,
"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",
"https://is1-ssl.mzstatic.com/image/thumb/Purple211/v4/.../screen4.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": 6
}
]
}
}
Response Fields
| Field | Type | Description |
|---|
| genreId | string | The genre ID that was queried |
| chart | string | Chart type used |
| country | string | Country code used |
| apps | array | Array of ranked apps with screenshots |
App Entry
| Field | Type | Description |
|---|
| rank | number | Position in the chart (1-based) |
| 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 |
Chart Types
| Chart | Description |
|---|
top-free | Most downloaded free apps |
top-paid | Most downloaded paid apps |
top-grossing | Highest revenue apps (free + paid) |
Genre IDs
Use GET /v1/categories to get the full list. Common genre IDs:
| Genre ID | Category | Genre ID | Category |
|---|
6014 | Games | 6015 | Finance |
6016 | Entertainment | 6017 | Education |
6018 | Books | 6000 | Business |
6013 | Health & Fitness | 6005 | Social Networking |
6007 | Productivity | all | All categories |
Use genreId=all to get screenshots for the overall top apps across all categories — great for spotting cross-category screenshot trends.
This endpoint combines two data sources: Apple’s RSS charts for ranking data and the iTunes Lookup API for screenshot URLs. If an app appears in the chart but its iTunes lookup fails, it will be included with empty screenshot arrays.
Errors
| Status | Code | When |
|---|
| 400 | INVALID_GENRE | Genre ID is missing |
| 400 | INVALID_CHART | Chart type not top-free, top-paid, or top-grossing |
| 401 | MISSING_API_KEY | No API key in the request |
| 401 | INVALID_API_KEY | Invalid or expired API key |
