GET /v1/discover
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
curl "https://api.appeeky.com/v1/discover?country=us&limit=10" \
-H "X-API-Key: YOUR_API_KEY"
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);
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"])
Response
{
"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 |
For more granular control, use the individual endpoints directly:
GET /v1/new-releasesfor new releases withmaxDaysfilterGET /v1/discover/new-number-1for category leaders
Errors
| Status | Code | When |
|---|---|---|
| 500 | FETCH_FAILED | Failed to fetch upstream data |