Apple Maps

Browse one Apple Maps category near a coordinate

Returns places in one browse category near a coordinate without a keyword, in the same shape as the search endpoint (place summaries, region, relocation flag, and the refinement filters block). The category is a name from the categories endpoint for the same area (case-insensitive) or its key; an unknown name returns 400 listing the categories available there. Filters and sort work exactly as on the search endpoint.

get/apple-maps/category-search

Request

  • Base URL: https://api.crawlora.net/api/v1
  • URL: https://api.crawlora.net/api/v1/apple-maps/category-search
  • Auth: API key in header x-api-key

Query parameters

categorystring required

Category name (e.g. Coffee Shops, Restaurants) or key from /apple-maps/categories for the same area

latitudenumber required

Search center latitude

longitudenumber required

Search center longitude

spannumber

Search viewport size in degrees around the center. Defaults to 0.05; minimum 0.001, maximum 5.

limitinteger

Max places returned. Defaults to 25, maximum 100.

langstring

Display language as a BCP 47 tag. Defaults to en-US.

countrystring

Two-letter ISO 3166-1 country code. Defaults to US.

filtersstring

Comma-separated filter keys from the filters block of an unfiltered category search for the same category and area. Unknown keys return 400 listing the available keys. Costs a second upstream call.

sort'best_match' | 'distance' | 'ratings'

Result order. Costs a second upstream call.

Headers

x-api-keystring required

API key required

Response

OK

codeinteger

Code is the HTTP status code or a custom code used to indicate the result of the request @example 200

msgunknown

Changes

No recorded changes to this operation across all 3 revisions of this API.