Apple Maps API endpoint
Returns the "Find Nearby" browse categories Apple Maps offers for an area (for example Restaurants, Coffee Shops, Gas Stations, Hotels, Parking, Grocery Stores), each with the key and name the category-search endpoint takes. The set is location-aware.
/apple-maps/categoriesEach category's name or key is the value /apple-maps/category-search takes. The set is location-aware and can differ by area and country.
Query parameters:
latitude (required) — center latitude, e.g. 37.7749.longitude (required) — center longitude, e.g. -122.4194.span (optional) — viewport size in degrees around the center. Defaults to 0.05; minimum 0.001, maximum 5.lang (optional) — display language as a BCP 47 tag, e.g. en-US, ja-JP. Names follow it. Defaults to en-US.country (optional) — two-letter ISO 3166-1 code, e.g. US. Defaults to US.Response includes categories[], each with key (an opaque Apple category token valid for this area) and name.
| Field | Filled in, of 8 checked | Values in the sample |
|---|---|---|
| key | 8 | |
| name | 8 | “Restaurants” and 7 other values |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| latitude | number | Yes | Center latitude | 37.7749 | |
| longitude | number | Yes | Center longitude | -122.4194 | |
| span | number | No | 0 | Viewport size in degrees around the center. Defaults to 0.05; minimum 0.001, maximum 5. | 0.05 |
| lang | string | No | en-US | Display language as a BCP 47 tag. Defaults to en-US. | en-US |
| country | string | No | US | Two-letter ISO 3166-1 country code. Defaults to US. | US |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/apple-maps/categories?latitude=37.7749&longitude=-122.4194&lang=en&country=us" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"categories": [
{
"key": "CikKHXNlYXJjaF9zdWdnZXN0X3ByaW1hcnlfc291cmNlEghDQVRFR09SWQ…",
"name": "Fast Food"
},
{
"key": "CikKHXNlYXJjaF9zdWdnZXN0X3ByaW1hcnlfc291cmNlEghDQVRFR09SWQ…",
"name": "Restaurants"
},
{
"key": "CikKHXNlYXJjaF9zdWdnZXN0X3ByaW1hcnlfc291cmNlEghDQVRFR09SWQ…",
"name": "Coffee Shops"
},
{
"key": "CikKHXNlYXJjaF9zdWdnZXN0X3ByaW1hcnlfc291cmNlEghDQVRFR09SWQ…",
"name": "Gas Stations"
}
]
}
}Request schema
No body schema
Response schema
#/definitions/applemaps.categoriesResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | Code is the HTTP status code or a custom code used to indicate the result of the request @example 200 | |||
| data | applemaps.CategoriesResponse | No | ||||
| data.categories | array | No | ||||
| data.categories[].key | string | No | ||||
| data.categories[].name | string | No | ||||
| msg | unknown | No | Msg is the message that describes the result of the request @example "Request successful" |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 503 | Service Unavailable | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/apple-maps/categories?latitude=37.7749&longitude=-122.4194&lang=en&country=us" \
-H "x-api-key: $CRAWLORA_API_KEY"