Skip to main content
GET /v1/featured
Returns apps currently featured on the Apple App Store Today tab. Includes App of the Day, Game of the Day, and editorially curated collections like “Hot This Week”, “Indie Games We Love”, etc.

Query Parameters

NameTypeDefaultDescription
countrystringusISO country code (e.g. us, gb, de)

Examples

curl "https://api.appeeky.com/v1/featured?country=us" \
  -H "X-API-Key: YOUR_API_KEY"

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

FieldTypeDescription
countrystringISO country code
datestringDate of the featured content (YYYY-MM-DD)
appOfTheDayFeaturedAppToday’s App of the Day (null if not available)
gameOfTheDayFeaturedAppToday’s Game of the Day (null if not available)
groupsFeaturedGroup[]Curated editorial collections with featured apps

FeaturedApp

FieldTypeDescription
appIdstringApple App ID
namestringApp name
developerstringDeveloper name
iconstringApp icon URL (256x256)
genrestringPrimary genre
urlstringApp Store URL

FeaturedGroup

FieldTypeDescription
idstringApple editorial group ID
namestringCollection name (e.g. “Hot This Week”)
taglinestring|nullShort description (e.g. “Play these new launches”)
typestringCard display type: AppOfTheDay, GameOfTheDay, ShortImage
appsFeaturedApp[]Apps in this collection

Group Types

TypeDescription
AppOfTheDayFeatured apps with large editorial cards
GameOfTheDayFeatured games with large editorial cards
ShortImageCurated collections with smaller app cards
AppEventCardIn-app event promotions (typically no app data)

Caching

Results are cached for 30 minutes. Featured content changes daily (App/Game of the Day) and weekly (curated collections).

Errors

StatusCodeWhen
500INTERNAL_ERRORFailed to fetch Apple editorial data