> ## Documentation Index
> Fetch the complete documentation index at: https://docs.appeeky.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Featured Apps

> Apps featured on the Apple App Store Today tab, including App of the Day, Game of the Day, and curated editorial collections

```
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

| Name    | Type   | Default | Description                              |
| ------- | ------ | ------- | ---------------------------------------- |
| country | string | `us`    | ISO country code (e.g. `us`, `gb`, `de`) |

## Examples

<CodeGroup>
  ```bash cURL theme={"theme":{"light":"github-light","dark":"github-dark"}}
  curl "https://api.appeeky.com/v1/featured?country=us" \
    -H "X-API-Key: YOUR_API_KEY"
  ```

  ```javascript JavaScript theme={"theme":{"light":"github-light","dark":"github-dark"}}
  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);
  ```

  ```python Python theme={"theme":{"light":"github-light","dark":"github-dark"}}
  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"])
  ```
</CodeGroup>

## Response

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "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 |