JustSERPDocs
Apple

Apple Maps places

Up to 20 places on Apple Maps by id (`place_ids`, comma-separated: `I...` ids or decimal muids), under the Apple Maps Places parameters (`country`, `lang`) and answered as the document: `search_metadata`, `search_parameters`, `place_results` (in request order, with `position`) and `not_found_places` (as sent).

GET
/v1/apple/maps/places

Up to 20 places on Apple Maps by id (place_ids, comma-separated: I... ids or decimal muids), under the Apple Maps Places parameters (country, lang) and answered as the document: search_metadata, search_parameters, place_results (in request order, with position) and not_found_places (as sent). Every id missing is a 404 profile_not_found. The place fields are the same as /v1/apple/maps's.

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
place_ids*string

Comma-separated, up to 20: I... ids or decimal muids.

country?string
Default"us"
lang?string
Default"en"

Response Body

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

application/json
  1. response

If every id is missing the answer is 404 profile_not_found.

search_metadata*
search_parameters*

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

search_information?
place_results?array<>

In request order, with position.

not_found_places?array<string>

As sent.

Example Request
curl -X GET 'https://api.justserp.com/v1/apple/maps/places?place_ids=IAA409CDF9D3555A9&country=us&lang=en'
Example Response
{  "search_metadata": {    "id": "string",    "status": "Success",    "created_at": "string",    "request_url": "string",    "html_url": "string"  },  "search_parameters": {},  "search_information": {},  "place_results": [    {      "position": 0,      "place_id": "string",      "title": "string",      "link": "string",      "address": "string",      "phone": "string",      "website": "string",      "rating": 0,      "reviews": 0,      "gps_coordinates": {        "latitude": 0,        "longitude": 0      },      "open_state": "string",      "open_hours": {}    }  ],  "not_found_places": [    "string"  ]}

Apple Maps search GET

A search on Apple Maps under the Apple Maps parameters (`q`; `center` or `location`; `zoom` or `span`; `country`, `lang`, `sort_by`, `filters`, `open_at`) and answered as the document: `search_metadata`, `search_parameters` (with `location_used` and `center_used` for a `location`), `search_information` (`query_displayed`, `total_results`), `local_results`, `guide_results`, `filters` and `error` when there are no results.

Apple App Store Search GET

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).