JustSERPDocs
Apple

Apple App Store Search

Apps for a term, from Apple's search API, answered as the document: `search_metadata`, `search_parameters`, `search_information` and `organic_results` (one entry per app, in the API's order).

GET
/v1/apple/app-store/search

Apps for a term, from Apple's search API, answered as the document: search_metadata, search_parameters, search_information and organic_results (one entry per app, in the API's order). The search is fuzzy: a nonsense term still returns the nearest apps. device=desktop returns Mac apps only. No result is an empty list. device here is the App Store's own device (iPhone, iPad, Mac), not a phone job.

Authorization

headerX-API-Key<token>

Your API key.

Query Parameters

cancel_token?string

A name you make up for this request (a UUID is fine), so you can later GET /v1/cancel with it. Only you know it, so only you can cancel. Use a new one for every request, retries included: a cancelled token stays cancelled for a few minutes.

Length1 <= length <= 128
term*string

What to search for.

Length1 <= length <= 500
country?string

The App Store storefront, two letters.

Match^[A-Za-z]{2}$
Default"us"
lang?string

Language of the store, e.g. ja-jp, de.

Default"en-us"
device?string

mobile (iPhone), tablet (iPad) or desktop (Mac apps).

Default"mobile"
Value in"mobile""tablet""desktop"
property?"developer"

developer: term is a developer's name, only their apps.

Value in"developer"
include_explicit?boolean

Whether explicit content is included.

Defaulttrue
num?integer

Results.

Range1 <= value <= 200
Default10

Response Body

The apps, as the document. When the page could not be parsed, the usual envelope.

application/json
  1. response

The App Store search document. A field Apple leaves out is null or an empty list.

search_metadata*
search_parameters*

The parameters the search ran with, defaults filled in; engine is the engine's name.

search_information?
organic_results?array<>
Example Request
curl -X GET 'https://api.justserp.com/v1/apple/app-store/search?term=instagram&device=mobile&num=10'
Example Response
{  "search_metadata": {    "id": "string",    "status": "Success",    "created_at": "string",    "request_url": "string",    "html_url": "string"  },  "search_parameters": {},  "search_information": {},  "organic_results": [    {      "position": 0,      "id": 0,      "title": "string",      "bundle_id": "string",      "version": "string",      "has_vpp_license": true,      "age_rating": "string",      "release_note": "string",      "seller_link": "string",      "minimum_os_version": "string",      "description": "string",      "game_center_enabled": true,      "link": "string",      "release_date": "string",      "latest_version_release_date": "string",      "price": {        "is_free": true,        "type": "string",        "formatted_price": "string",        "extracted_price": 0,        "currency": "string",        "currency_symbol": "string"      },      "rating": 0,      "reviews": 0,      "genres": [        {          "name": "string",          "id": 0,          "is_primary": true        }      ],      "developer": {        "name": "string",        "id": 0,        "link": "string"      },      "size_in_bytes": 0,      "supported_languages": [        "string"      ],      "screenshots": {        "general": [          {            "link": "string",            "width": 0,            "height": 0          }        ],        "ipad": [          {            "link": "string",            "width": 0,            "height": 0          }        ],        "appletv": [          {            "link": "string",            "width": 0,            "height": 0          }        ]      },      "logos": [        {          "link": "string",          "width": 0,          "height": 0        }      ],      "features": [        "string"      ],      "advisories": [        "string"      ],      "supported_devices": [        "string"      ]    }  ]}