Endpoint Playground

Try the Apple Maps Category Search API

Test Crawlora's Apple Maps Category Search API with realistic prefilled parameters. Generate a cURL request, inspect the expected structured JSON response, and open the full docs or pricing page when you are ready to integrate this public web data extraction endpoint into your application.

Endpoint facts

Method: GET
API path: /apple-maps/category-search
Platform: Apple Maps
Auth: apiKey
Credits: 3 credits/request
Required params: category, latitude, longitude
Common optional params: span, limit, lang, country, filters, sort

Apple Maps Category Search API documentation Apple Maps platform page Crawlora API pricing Try Apple Maps Autocomplete API Try Apple Maps Categories API Try Apple Maps Directions API Try Apple Maps ETA API Try Apple Maps Guides API

Prefilled cURL

curl "https://api.crawlora.net/api/v1/apple-maps/category-search?category=<category>&latitude=<latitude>&longitude=<longitude>&sort=best_match" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters visible to crawlers

Parameter	Type	Required	Prefilled value	Description
category	string	Yes		Category name (e.g. Coffee Shops, Restaurants) or key from /apple-maps/categories for the same area
latitude	number	Yes		Search center latitude
longitude	number	Yes		Search center longitude
span	number	No		Search viewport size in degrees around the center. Defaults to 0.05; minimum 0.001, maximum 5.
limit	integer	No		Max places returned. Defaults to 25, maximum 100.
lang	string	No		Display language as a BCP 47 tag. Defaults to en-US.
country	string	No		Two-letter ISO 3166-1 country code. Defaults to US.
filters	string	No		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	string	No	best_match	Result order. Costs a second upstream call.

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "query": "Fast Food",
    "total_found": 25,
    "total_results": 1,
    "region": {
      "south": 37.7499,
      "west": -122.4494,
      "north": 37.7999,
      "east": -122.3894
    },
    "relocated": false,
    "filters": [
      {
        "name": "Open Now",
        "type": "toggle",
        "options": [
          {
            "key": "OPEN_NOW",
            "name": "Open Now",
            "selected": false
          }
        ]
      },
      {
        "name": "All Chains",
        "type": "multi_select",
        "match": "any",
        "options": [
          {
            "key": "chain_in_n_out",
            "name": "In-N-Out Burger",
            "selected": false
          }
        ]
      }
    ],
    "places": [
      {
        "id": "16345243216502689102",
        "place_id": "I0B1C2D3E4F5A6B7C",
        "url": "https://maps.apple.com/place?place-id=I0B1C2D3E4F5A6B7C",
        "name": "Super Duper Burgers",
        "type": "BUSINESS",
        "category": "Burger Restaurant",
        "latitude": 37.7848,
        "longitude": -122.4076,
        "address": "721 Market St, San Francisco, CA  94103, United States",
        "rating": 4.2,
        "rating_max": 5,
        "rating_count": 2107,
        "price_level": 2,
        "price_max": 4,
        "price_symbol": "$"
      }
    ]
  }
}

Public Playground

Preview the endpoint before sending a live request

Sample responses, schemas, request previews, and code snippets are visible before sign in. Create an account when you are ready to save an API key and run authenticated requests.

Set up API key Endpoint docs

Endpoint

Choose one catalog endpoint for this request.

1 shown

Group

Method

Auth

Endpoint

GETapiKey3 credits/requestapplemaps.searchResponseDocApple Maps

GET /apple-maps/category-search

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.

API key required. Paste a full key or rotate one from the API Keys page.

Set up API key

View docs

API key

API key required for live requests. Your key is only used to send requests from this Playground.

not configured

Active Playground key: not configured

Manage API keys in Console

Required query parameters

Endpoint details

Method: GET
Path: /apple-maps/category-search
Authentication: apiKey
Credit cost: 3 credits/request
Platform: Apple Maps
Parameters: 10 documented fields

Request parameters

category:querylatitude:querylongitude:queryspan:querylimit:querylang:querycountry:queryfilters:querysort:queryx-api-key:header

Response schema fields

codedatadata.filtersdata.filters[].matchdata.filters[].namedata.filters[].optionsdata.filters[].options[].keydata.filters[].options[].namedata.filters[].options[].selecteddata.filters[].typedata.guidesdata.guides[].description

Sample response summary

{
  "code": 200,
  "msg": "OK",
  "data": {
    "query": "Fast Food",
    "total_found": 25,
    "total_results": 1,
    "region": {
      "south": 37.7499,
      "west": -122.4494,
      "north": 37.7999,
      "east": -122.3894
    },
    "relocated": false,
    "filters": [
      {
        "name": "Open Now",
        "type": "toggle",
        "options": [
          {
            "key": "OPEN_NOW",
            "name": "Open Now",
            "selected": false
          }
        ]
      },
      {
        "name": "All Chains",
        "type": "multi_select",
        "match": "any",
        "options": [
          {
            "key": "chain_in_n_out",
            "name": "In-N-Out Burger",
            "selected": false
          }
        ]
      }
    ],
    "places": [
      {
        "id": "16345243216502689102",
        "place_id": "I0B1C2D3E4F5A6B7C",
        "url": "https://maps.apple.com/place?place-id=I0B1C2D3E4F5A6B7C",
        "name": "Super Duper Burgers",
        "type": "BUSINESS",
        "category": "Burger Restaurant",
        "latitude": 37.7848,
        "longitude": -122.4076,
        "address": "721 Market St, San Francisco, CA  94103, United States",
        "rating": 4.2,
        "rating_max": 5,
        "rating_count": 2107,
        "price_level": 2,
        "price_max": 4,
        "price_symbol": "$"
      }
    ]
  }
}

cURL example

curl "https://api.crawlora.net/api/v1/apple-maps/category-search?category=<category>&latitude=<latitude>&longitude=<longitude>" \
  -H "x-api-key: $CRAWLORA_API_KEY"

View endpoint docs Open platform page Browse all endpoints Pricing Get Apple Maps search suggestions for a partial query List Apple Maps browse categories for an area Get Apple Maps driving, walking, or cycling directions Get Apple Maps travel-time estimates between two points Browse the Apple Guides home page worldwide or for one city

Try the Apple Maps Category Search API

Endpoint facts

Method: GET
API path: /apple-maps/category-search
Platform: Apple Maps
Auth: apiKey
Credits: 3 credits/request
Required params: category, latitude, longitude
Common optional params: span, limit, lang, country, filters, sort

Prefilled cURL

curl "https://api.crawlora.net/api/v1/apple-maps/category-search?category=<category>&latitude=<latitude>&longitude=<longitude>&sort=best_match" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters visible to crawlers

Parameter	Type	Required	Prefilled value	Description
category	string	Yes		Category name (e.g. Coffee Shops, Restaurants) or key from /apple-maps/categories for the same area
latitude	number	Yes		Search center latitude
longitude	number	Yes		Search center longitude
span	number	No		Search viewport size in degrees around the center. Defaults to 0.05; minimum 0.001, maximum 5.
limit	integer	No		Max places returned. Defaults to 25, maximum 100.
lang	string	No		Display language as a BCP 47 tag. Defaults to en-US.
country	string	No		Two-letter ISO 3166-1 country code. Defaults to US.
filters	string	No		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	string	No	best_match	Result order. Costs a second upstream call.

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "query": "Fast Food",
    "total_found": 25,
    "total_results": 1,
    "region": {
      "south": 37.7499,
      "west": -122.4494,
      "north": 37.7999,
      "east": -122.3894
    },
    "relocated": false,
    "filters": [
      {
        "name": "Open Now",
        "type": "toggle",
        "options": [
          {
            "key": "OPEN_NOW",
            "name": "Open Now",
            "selected": false
          }
        ]
      },
      {
        "name": "All Chains",
        "type": "multi_select",
        "match": "any",
        "options": [
          {
            "key": "chain_in_n_out",
            "name": "In-N-Out Burger",
            "selected": false
          }
        ]
      }
    ],
    "places": [
      {
        "id": "16345243216502689102",
        "place_id": "I0B1C2D3E4F5A6B7C",
        "url": "https://maps.apple.com/place?place-id=I0B1C2D3E4F5A6B7C",
        "name": "Super Duper Burgers",
        "type": "BUSINESS",
        "category": "Burger Restaurant",
        "latitude": 37.7848,
        "longitude": -122.4076,
        "address": "721 Market St, San Francisco, CA  94103, United States",
        "rating": 4.2,
        "rating_max": 5,
        "rating_count": 2107,
        "price_level": 2,
        "price_max": 4,
        "price_symbol": "$"
      }
    ]
  }
}

Browse one Apple Maps category near a coordinate

API key required. Paste a full key or rotate one from the API Keys page.

Set up API key

{ "code": 200, "msg": "OK", "data": { "query": "Fast Food", "total_found": 25, "total_results": 1, "region": { "south": 37.7499, "west": -122.4494, "north": 37.7999, "east": -122.3894 }, "relocated": false, "filters": [ { "name": "Open Now", "type": "toggle", "options": [ { "key": "OPEN_NOW", "name": "Open Now", "selected": false } ] }, { "name": "All Chains", "type": "multi_select", "match": "any", "options": [ { "key": "chain_in_n_out", "name": "In-N-Out Burger", "selected": false } ] } ], "places": [ { "id": "16345243216502689102", "place_id": "I0B1C2D3E4F5A6B7C", "url": "https://maps.apple.com/place?place-id=I0B1C2D3E4F5A6B7C", "name": "Super Duper Burgers", "type": "BUSINESS", "category": "Burger Restaurant", "latitude": 37.7848, "longitude": -122.4076, "address": "721 Market St, San Francisco, CA 94103, United States", "rating": 4.2, "rating_max": 5, "rating_count": 2107, "price_level": 2, "price_max": 4, "price_symbol": "$" } ] } }

Endpoint details

Method: GET
Path: /apple-maps/category-search
Authentication: apiKey
Credit cost: 3 credits/request
Platform: Apple Maps
Parameters: 10 documented fields

Request parameters

category:querylatitude:querylongitude:queryspan:querylimit:querylang:querycountry:queryfilters:querysort:queryx-api-key:header

Response schema fields

Sample response summary

{
  "code": 200,
  "msg": "OK",
  "data": {
    "query": "Fast Food",
    "total_found": 25,
    "total_results": 1,
    "region": {
      "south": 37.7499,
      "west": -122.4494,
      "north": 37.7999,
      "east": -122.3894
    },
    "relocated": false,
    "filters": [
      {
        "name": "Open Now",
        "type": "toggle",
        "options": [
          {
            "key": "OPEN_NOW",
            "name": "Open Now",
            "selected": false
          }
        ]
      },
      {
        "name": "All Chains",
        "type": "multi_select",
        "match": "any",
        "options": [
          {
            "key": "chain_in_n_out",
            "name": "In-N-Out Burger",
            "selected": false
          }
        ]
      }
    ],
    "places": [
      {
        "id": "16345243216502689102",
        "place_id": "I0B1C2D3E4F5A6B7C",
        "url": "https://maps.apple.com/place?place-id=I0B1C2D3E4F5A6B7C",
        "name": "Super Duper Burgers",
        "type": "BUSINESS",
        "category": "Burger Restaurant",
        "latitude": 37.7848,
        "longitude": -122.4076,
        "address": "721 Market St, San Francisco, CA  94103, United States",
        "rating": 4.2,
        "rating_max": 5,
        "rating_count": 2107,
        "price_level": 2,
        "price_max": 4,
        "price_symbol": "$"
      }
    ]
  }
}

cURL example

curl "https://api.crawlora.net/api/v1/apple-maps/category-search?category=<category>&latitude=<latitude>&longitude=<longitude>" \
  -H "x-api-key: $CRAWLORA_API_KEY"