Search
Search the App Store for apps.
GET | POST /v1/app-store/searchSend parameters as a query string with GET, or as a JSON body with POST. Both are equivalent.
Request
curl "https://gateway.apinoa.com/v1/app-store/search?q=meditation&country=US&limit=10" \
-H "x-api-key: $APINOA_API_KEY"Parameters
| Parameter | Type | Required | Notes |
|---|---|---|---|
country | enum | The market, as an ISO 3166 country code. US GB CA AU NZ IE DE FR IT ES NL BE AT CH SE NO DK FI PL PT CZ GR HU RO TR UA IL AE SA EG ZA NG KE IN PK ID MY SG TH VN PH JP KR CN TW HK MX BR AR CL CO PE | |
cursor | string | The previous page's cursor. Pass it alone for the next page. | |
lang | string | Interface language. | |
limit | integer 1–200 | Results wanted (default 50, at most 200). More than one page is charged per page. | |
q | string | The query, search operators included. |
The same parameters, and every response type, are in the OpenAPI document.
Response
Returns AppsPage in data. A real response, shortened: arrays keep their first entries and long text is cut.
{
"success": true,
"data": {
"engine": "app-store",
"query": "meditation",
"outcome": "results",
"country": "US",
"apps": [
{
"id": "337472899",
"name": "Insight Timer: Meditate, Sleep",
"url": "https://apps.apple.com/us/app/insight-timer-meditate-sleep/id337472899?uo=4",
"developer": {
"name": "Insight Network Inc",
"id": "983080487",
"url": "https://apps.apple.com/us/developer/insight-network-inc/id983080487?uo=4",
"website": "http://www.insighttimer.com"
},
"icon": "https://is1-ssl.mzstatic.com/image/thumb/Purple211/v4/b7/68/07/b768071e-fb00-0d0f-f9d3-e0e427d85e4b/AppIcon-0-0-1x_U007epad-0-1-85-220.png/512x512bb.jpg",
"screenshots": [
"https://is1-ssl.mzstatic.com/image/thumb/PurpleSource221/v4/9f/89/d3/9f89d364-4d66-e14f-7cff-5be7e3a6445a/0_APP_IPHONE_55_0.png/392x696bb.png",
"https://is1-ssl.mzstatic.com/image/thumb/PurpleSource221/v4/79/de/a5/79dea510-d411-3746-a506-82794b4fcd37/1_APP_IPHONE_55_1.png/392x696bb.png"
],
"description": "The world’s most popular wellness app.\n\n* Apps of the Year Winner - TIME magazine and Women's Health *\n* More time is spent on Insight Timer than on all other w…",
"categories": ["Health & Fitness", "Lifestyle"],
"rating": {"average": 4.89513, "count": 448546},
"price": {"currency": "USD", "amount": 0},
"contentRating": "12+",
"version": "20.40.0",
"requires": "Requires iOS 15.0 or later",
"releasedAt": "2009-11-05T18:55:12Z",
"updatedAt": "2026-10-25T08:30:36Z",
"whatsNew": "The world's largest free mental health app just got even bigger! In the last week we've added 925 new free meditations for you to enjoy, plus 500 new free sleep…",
"ext": {
"bundleId": "com.spotlightsix.zentimer",
"languages": ["NL"],
"sellerName": "Insight Network Inc",
"sizeBytes": 241229824,
"formattedPrice": "Free",
"icons": {
"60": "https://is1-ssl.mzstatic.com/image/thumb/Purple211/v4/b7/68/07/b768071e-fb00-0d0f-f9d3-e0e427d85e4b/AppIcon-0-0-1x_U007epad-0-1-85-220.png/60x60bb.jpg",
"100": "https://is1-ssl.mzstatic.com/image/thumb/Purple211/v4/b7/68/07/b768071e-fb00-0d0f-f9d3-e0e427d85e4b/AppIcon-0-0-1x_U007epad-0-1-85-220.png/100x100bb.jpg",
"512": "https://is1-ssl.mzstatic.com/image/thumb/Purple211/v4/b7/68/07/b768071e-fb00-0d0f-f9d3-e0e427d85e4b/AppIcon-0-0-1x_U007epad-0-1-85-220.png/512x512bb.jpg"
},
"ipadScreenshots": [
"https://is1-ssl.mzstatic.com/image/thumb/PurpleSource221/v4/0d/63/ee/0d63eeb3-02e9-d06b-a73b-291a6ae634a3/0_APP_IPAD_PRO_129_0.png/576x768bb.png"
],
"genreIds": ["6013"],
"primaryGenre": {"id": "6013", "name": "Health & Fitness"},
"contentAdvisoryRating": "12+",
"advisories": ["Infrequent/Mild Alcohol, Tobacco, or Drug Use or References"],
"currentVersionRating": {"average": 4.89513, "count": 448546},
"minimumOsVersion": "15.0",
"supportedDevices": ["iPhone5s-iPhone5s"],
"features": ["iosUniversal"],
"isGameCenterEnabled": false,
"isVppDeviceBasedLicensingEnabled": true,
"kind": "software"
},
"rank": 1,
"country": "US"
},
{
"id": "493145008",
"name": "Headspace: Sleep & Meditation",
"url": "https://apps.apple.com/us/app/headspace-sleep-meditation/id493145008?uo=4",
"developer": {
"name": "Headspace Inc.",
"id": "384434796",
"url": "https://apps.apple.com/us/developer/headspace-inc/id384434796?uo=4",
"website": "https://www.headspace.com/"
},
"icon": "https://is1-ssl.mzstatic.com/image/thumb/Purple211/v4/ec/20/88/ec208862-22e5-ef28-fd52-eff6151054fe/AppIcon-0-0-1x_U007epad-0-1-85-220.png/512x512bb.jpg",
"screenshots": [
"https://is1-ssl.mzstatic.com/image/thumb/PurpleSource221/v4/72/5a/ec/725aec3b-ce7e-04e5-3fb2-c3eddd568959/6edb2838-55b4-46d0-b166-358beae09bf2_1242x2208bb__U002…",
"https://is1-ssl.mzstatic.com/image/thumb/PurpleSource211/v4/17/aa/29/17aa2961-e804-11d8-d196-58c486554ffe/7cfe3748-bd48-4629-8716-8735363c19b2_1242x2208bb__U002…"
],
"description": "Welcome to Headspace, your expert-led guide to mental health, mindfulness, and meditation. Whether you're navigating stress, anxiety, sleep trouble, or life’s u…",
"categories": ["Health & Fitness", "Productivity"],
"rating": {"average": 4.84216, "count": 973755},
"price": {"currency": "USD", "amount": 0},
"contentRating": "12+",
"version": "8.38.1",
"requires": "Requires iOS 15.6 or later",
"releasedAt": "2012-02-02T18:57:49Z",
"updatedAt": "2026-10-28T15:55:23Z",
"whatsNew": "Thanks for using Headspace! This update includes bug fixes and performance improvements.\n\nAs always, if you run into any troubles, let us know at help@headspace…",
"ext": {
"bundleId": "com.getsomeheadspace.headspace",
"languages": ["EN"],
"sellerName": "Headspace Inc.",
"sizeBytes": 451194880,
"formattedPrice": "Free",
"icons": {
"60": "https://is1-ssl.mzstatic.com/image/thumb/Purple211/v4/ec/20/88/ec208862-22e5-ef28-fd52-eff6151054fe/AppIcon-0-0-1x_U007epad-0-1-85-220.png/60x60bb.jpg",
"100": "https://is1-ssl.mzstatic.com/image/thumb/Purple211/v4/ec/20/88/ec208862-22e5-ef28-fd52-eff6151054fe/AppIcon-0-0-1x_U007epad-0-1-85-220.png/100x100bb.jpg",
"512": "https://is1-ssl.mzstatic.com/image/thumb/Purple211/v4/ec/20/88/ec208862-22e5-ef28-fd52-eff6151054fe/AppIcon-0-0-1x_U007epad-0-1-85-220.png/512x512bb.jpg"
},
"ipadScreenshots": [
"https://is1-ssl.mzstatic.com/image/thumb/PurpleSource211/v4/33/c1/e8/33c1e8bd-22f2-501b-3d45-b529bb7159f5/1.png/576x768bb.png"
],
"genreIds": ["6013"],
"primaryGenre": {"id": "6013", "name": "Health & Fitness"},
"contentAdvisoryRating": "12+",
"currentVersionRating": {"average": 4.84216, "count": 973755},
"minimumOsVersion": "15.6",
"supportedDevices": ["iPhone5s-iPhone5s"],
"features": ["iosUniversal"],
"isGameCenterEnabled": false,
"isVppDeviceBasedLicensingEnabled": true,
"kind": "software"
},
"rank": 2,
"country": "US"
}
],
"page": {"index": 1, "size": 9},
"cursor": "Rl3-aEioiw8jPXTAto6_y35Jx3GMcueBNp5H67_hEE-LLcoHOLkRJZHNmJ8MHqWIVY8iJEvRARMIDnhl2g-NjcqTABxE60OMknPnEWoXagyBpGU6jdqpmklxtd7LcrZEiSFW17vPwmVY1LvT1HqPuHqw_2M2Zfw_…",
"fetchedAt": "2026-10-30T00:57:25.431Z"
}
}Errors
| Status | Code | Meaning |
|---|---|---|
| 400 | INVALID_CURSOR | The cursor is not one this operation returned. Start again without it. |
| 400 | INVALID_PARAMS | A parameter is missing, unknown or out of range, or the engine does not take it. The message names it. |
| 401 | UNAUTHORIZED | The x-api-key header is missing, or the key is revoked or unknown. |
| 402 | INSUFFICIENT_BALANCE | The balance does not cover this call. Top up in the dashboard. |
| 429 | MARKETPLACE_SATURATED | Too many concurrent calls. Retry after the Retry-After seconds. |
| 502 | UPSTREAM_ERROR | The engine answered with something unusable. Retry with backoff. |
| 503 | SERVICE_UNAVAILABLE | A temporary failure. Retry with backoff. |
Every code is listed in Errors. Failed calls are not billed.
Pricing
Price $0.0012 per call. List price; the rate steps down above 1,000 calls a day.