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

# New Releases

> Discover recently released apps on the App Store

```
GET /v1/new-releases
```

Returns recently released apps discovered via iTunes Search across multiple App Store categories. Only apps with an original `releaseDate` within the specified time window are included — updated apps are filtered out. Results are sorted newest first.

## Query Parameters

| Name    | Type   | Default | Description                                                        |
| ------- | ------ | ------- | ------------------------------------------------------------------ |
| country | string | `us`    | ISO country code (e.g. `us`, `gb`, `de`, `jp`)                     |
| limit   | number | `25`    | Maximum number of results to return (max `50`)                     |
| maxDays | number | `30`    | Only include apps released within the last N days (range `7`–`90`) |

## Code Examples

<CodeGroup>
  ```bash cURL theme={"theme":{"light":"github-light","dark":"github-dark"}}
  curl -X GET "https://api.appeeky.com/v1/new-releases?country=us&limit=10&maxDays=14" \
    -H "X-API-Key: YOUR_API_KEY"
  ```

  ```javascript JavaScript theme={"theme":{"light":"github-light","dark":"github-dark"}}
  const response = await fetch(
    "https://api.appeeky.com/v1/new-releases?country=us&limit=10&maxDays=14",
    {
      headers: {
        "X-API-Key": "YOUR_API_KEY",
      },
    }
  );

  const { data } = await response.json();
  console.log(data.apps);
  ```

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

  response = requests.get(
      "https://api.appeeky.com/v1/new-releases",
      params={"country": "us", "limit": 10, "maxDays": 14},
      headers={"X-API-Key": "YOUR_API_KEY"},
  )

  data = response.json()["data"]
  print(data["apps"])
  ```
</CodeGroup>

## Response

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "data": {
    "apps": [
      {
        "appId": "6742819203",
        "title": "Pixel Dojo",
        "developer": "Neon Arc Studios",
        "icon": "https://is1-ssl.mzstatic.com/image/thumb/Purple221/v4/ab/cd/ef/abcdef12-icon/AppIcon-0-0-1x_U007emarketing-0-7-0-85-220.png/512x512bb.jpg",
        "category": "Games",
        "releasedAt": "2026-02-15T00:00:00Z",
        "releasedAgo": "2d ago",
        "url": "https://apps.apple.com/app/id6742819203"
      },
      {
        "appId": "6738501274",
        "title": "FocusFlow - Deep Work Timer",
        "developer": "Mindful Apps Co.",
        "icon": "https://is1-ssl.mzstatic.com/image/thumb/Purple221/v4/12/34/56/12345678-icon/AppIcon-0-0-1x_U007emarketing-0-7-0-85-220.png/512x512bb.jpg",
        "category": "Productivity",
        "releasedAt": "2026-02-13T00:00:00Z",
        "releasedAgo": "4d ago",
        "url": "https://apps.apple.com/app/id6738501274"
      },
      {
        "appId": "6751093847",
        "title": "Routemaster - Trip Planner",
        "developer": "Wanderlust Digital Ltd",
        "icon": "https://is1-ssl.mzstatic.com/image/thumb/Purple221/v4/78/9a/bc/789abc01-icon/AppIcon-0-0-1x_U007emarketing-0-7-0-85-220.png/512x512bb.jpg",
        "category": "Travel",
        "releasedAt": "2026-02-10T00:00:00Z",
        "releasedAgo": "7d ago",
        "url": "https://apps.apple.com/app/id6751093847"
      }
    ]
  }
}
```

## App Object

| Field       | Type           | Description                                                |
| ----------- | -------------- | ---------------------------------------------------------- |
| appId       | string         | Apple App ID                                               |
| title       | string         | App name                                                   |
| developer   | string         | Developer / publisher name                                 |
| icon        | string         | App icon URL (512px)                                       |
| category    | string         | Primary category (e.g. `Games`, `Productivity`)            |
| releasedAt  | string \| null | Original release date (ISO 8601)                           |
| releasedAgo | string \| null | Human-readable relative time (e.g. `"2d ago"`, `"1w ago"`) |
| url         | string         | App Store URL                                              |

## How It Works

The endpoint uses **iTunes Search** across 55+ category-specific search terms to build a large candidate pool of apps. Each app's original `releaseDate` is checked — only apps truly released within the `maxDays` window are kept. Apps that were merely *updated* (where `releaseDate` is old but `currentVersionReleaseDate` is recent) are filtered out.

Results are sorted by `releaseDate` descending (newest first) and capped at the requested `limit`.

<Tip>
  Use `maxDays=7` for the freshest releases. This narrows the window to only the past week, giving you the most recently launched apps without older entries.
</Tip>

## Errors

| Status | Code              | When                                           |
| ------ | ----------------- | ---------------------------------------------- |
| 400    | INVALID\_PARAMS   | Invalid `limit`, `maxDays`, or `country` value |
| 401    | MISSING\_API\_KEY | No API key in the request                      |
| 401    | INVALID\_API\_KEY | Invalid or expired API key                     |
| 500    | FETCH\_FAILED     | Failed to fetch data from iTunes Search        |