GET /v1/featured
Query Parameters
| Name | Type | Default | Description |
|---|---|---|---|
| country | string | us | ISO country code (e.g. us, gb, de) |
Examples
curl "https://api.appeeky.com/v1/featured?country=us" \
-H "X-API-Key: YOUR_API_KEY"
const res = await fetch(
"https://api.appeeky.com/v1/featured?country=us",
{ headers: { "X-API-Key": "YOUR_API_KEY" } }
);
const { data } = await res.json();
console.log("App of the Day:", data.appOfTheDay);
console.log("Game of the Day:", data.gameOfTheDay);
console.log("Featured groups:", data.groups.length);
import requests
res = requests.get(
"https://api.appeeky.com/v1/featured",
params={"country": "us"},
headers={"X-API-Key": "YOUR_API_KEY"},
)
data = res.json()["data"]
print("App of the Day:", data["appOfTheDay"]["name"])
print("Game of the Day:", data["gameOfTheDay"]["name"])
Response
{
"data": {
"country": "us",
"date": "2026-02-24",
"appOfTheDay": {
"appId": "1583614988",
"name": "Oko - Cross streets and Maps",
"developer": "Polara Engineering, Inc.",
"icon": "https://is1-ssl.mzstatic.com/.../256x256bb.png",
"genre": "Navigation",
"url": "https://apps.apple.com/us/app/oko-cross-streets-and-maps/id1583614988"
},
"gameOfTheDay": {
"appId": "6742443980",
"name": "Blade & Soul Heroes",
"developer": "NCSOFT",
"icon": "https://is1-ssl.mzstatic.com/.../256x256bb.png",
"genre": "Roleplaying",
"url": "https://apps.apple.com/us/app/blade-soul-heroes/id6742443980"
},
"groups": [
{
"id": "1694921970",
"name": "Turn-Based Games",
"tagline": null,
"type": "GameOfTheDay",
"apps": [
{
"appId": "6742443980",
"name": "Blade & Soul Heroes",
"developer": "NCSOFT",
"icon": "https://is1-ssl.mzstatic.com/.../256x256bb.png",
"genre": "Roleplaying",
"url": "https://apps.apple.com/us/app/blade-soul-heroes/id6742443980"
}
]
},
{
"id": "1698371075",
"name": "Hot This Week",
"tagline": "Play these new launches and updates",
"type": "ShortImage",
"apps": [
{
"appId": "1174078549",
"name": "Apple TV",
"developer": "Apple",
"icon": "https://is1-ssl.mzstatic.com/.../256x256bb.png",
"genre": "Entertainment",
"url": "https://apps.apple.com/us/app/apple-tv/id1174078549"
}
]
}
]
}
}
Response Fields
Top Level
| Field | Type | Description |
|---|---|---|
country | string | ISO country code |
date | string | Date of the featured content (YYYY-MM-DD) |
appOfTheDay | FeaturedApp | Today’s App of the Day (null if not available) |
gameOfTheDay | FeaturedApp | Today’s Game of the Day (null if not available) |
groups | FeaturedGroup[] | Curated editorial collections with featured apps |
FeaturedApp
| Field | Type | Description |
|---|---|---|
appId | string | Apple App ID |
name | string | App name |
developer | string | Developer name |
icon | string | App icon URL (256x256) |
genre | string | Primary genre |
url | string | App Store URL |
FeaturedGroup
| Field | Type | Description |
|---|---|---|
id | string | Apple editorial group ID |
name | string | Collection name (e.g. “Hot This Week”) |
tagline | string|null | Short description (e.g. “Play these new launches”) |
type | string | Card display type: AppOfTheDay, GameOfTheDay, ShortImage |
apps | FeaturedApp[] | Apps in this collection |
Group Types
| Type | Description |
|---|---|
AppOfTheDay | Featured apps with large editorial cards |
GameOfTheDay | Featured games with large editorial cards |
ShortImage | Curated collections with smaller app cards |
AppEventCard | In-app event promotions (typically no app data) |
Errors
| Status | Code | When |
|---|---|---|
| 500 | INTERNAL_ERROR | Failed to fetch Apple editorial data |