> ## 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.

# Discover

> Aggregated discovery data - new releases, category leaders, and trending apps

```
GET /v1/discover
```

Returns aggregated discovery data combining multiple sources into a single response. Use this as a convenience endpoint to power discovery dashboards.

## Query Parameters

| Name    | Type   | Default | Description                              |
| ------- | ------ | ------- | ---------------------------------------- |
| country | string | `us`    | ISO country code (e.g. `us`, `gb`, `de`) |
| limit   | number | `25`    | Max apps per section (capped at 50)      |

## Examples

<CodeGroup>
  ```bash cURL theme={"theme":{"light":"github-light","dark":"github-dark"}}
  curl "https://api.appeeky.com/v1/discover?country=us&limit=10" \
    -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/discover?country=us&limit=10",
    { headers: { "X-API-Key": "YOUR_API_KEY" } }
  );
  const { data } = await res.json();
  console.log(data.newReleases);
  console.log(data.newNumber1);
  ```

  ```python Python theme={"theme":{"light":"github-light","dark":"github-dark"}}
  import requests

  res = requests.get(
      "https://api.appeeky.com/v1/discover",
      params={"country": "us", "limit": 10},
      headers={"X-API-Key": "YOUR_API_KEY"},
  )
  data = res.json()["data"]
  print(data["newReleases"])
  print(data["newNumber1"])
  ```
</CodeGroup>

## Response

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "data": {
    "newReleases": [
      {
        "appId": "6758588325",
        "title": "SocialLife Diary",
        "developer": "Jelena Popovic",
        "icon": "https://is1-ssl.mzstatic.com/.../512x512bb.jpg",
        "category": "Lifestyle",
        "releasedAt": "2026-02-16T08:00:00Z",
        "releasedAgo": "today",
        "url": "https://apps.apple.com/us/app/sociallife-diary/id6758588325"
      },
      {
        "appId": "6756836995",
        "title": "Finnet Finance",
        "developer": "RICHINNOVATIONS TECHNOLOGIES",
        "icon": "https://is1-ssl.mzstatic.com/.../512x512bb.jpg",
        "category": "Finance",
        "releasedAt": "2026-02-16T08:00:00Z",
        "releasedAgo": "today",
        "url": "https://apps.apple.com/us/app/finnet-finance/id6756836995"
      }
    ],
    "newNumber1": [
      {
        "category": "Games",
        "appId": "1617391485",
        "title": "Block Blast",
        "icon": "https://is1-ssl.mzstatic.com/.../512x512bb.jpg",
        "reachedAt": null
      },
      {
        "category": "Social Networking",
        "appId": "284882215",
        "title": "Facebook",
        "icon": "https://is1-ssl.mzstatic.com/.../512x512bb.jpg",
        "reachedAt": null
      }
    ]
  }
}
```

## Sections

| Section       | Description                        | Source                                   |
| ------------- | ---------------------------------- | ---------------------------------------- |
| `newReleases` | Apps released in the last 30 days  | iTunes Search across multiple categories |
| `newNumber1`  | Apps currently #1 in each category | Apple RSS Top Free chart                 |

<Tip>
  For more granular control, use the individual endpoints directly:

  * [`GET /v1/new-releases`](/docs/new-releases) for new releases with `maxDays` filter
  * [`GET /v1/discover/new-number-1`](/docs/new-number-1) for category leaders
</Tip>

## Errors

| Status | Code          | When                          |
| ------ | ------------- | ----------------------------- |
| 500    | FETCH\_FAILED | Failed to fetch upstream data |