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
curl -X GET "https://api.appeeky.com/v1/new-releases?country=us&limit=10&maxDays=14" \
-H "X-API-Key: YOUR_API_KEY"
Response
{
"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.
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.
Caching: Responses are cached for 30 minutes (per country + limit + maxDays combination). The first request after a cache miss or server restart may be slow (10–20 seconds) because it queries 55+ iTunes Search endpoints. Subsequent requests within the TTL return instantly.
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 |
