Skip to main content
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

NameTypeDefaultDescription
countrystringusISO country code (e.g. us, gb, de)
limitnumber25Max 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"

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

SectionDescriptionSource
newReleasesApps released in the last 30 daysiTunes Search across multiple categories
newNumber1Apps currently #1 in each categoryApple RSS Top Free chart
For more granular control, use the individual endpoints directly:

Caching

Results are cached for 30 minutes. The first request (cold start) may take 12-25 seconds as it fetches data from multiple Apple sources. Subsequent requests return in under 5ms.

Errors

StatusCodeWhen
500FETCH_FAILEDFailed to fetch upstream data