Endpoint Playground

Try the Apple Maps Autocomplete API

Test Crawlora's Apple Maps Autocomplete 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/autocomplete
Platform: Apple Maps
Auth: apiKey
Credits: 1 credit/request
Required params: query, latitude, longitude
Common optional params: span, lang, country

Apple Maps Autocomplete API documentation Apple Maps platform page Crawlora API pricing Try Apple Maps Categories API Try Apple Maps Category Search 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/autocomplete?query=<query>&latitude=<latitude>&longitude=<longitude>" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters visible to crawlers

Parameter	Type	Required	Description
query	string	Yes	Partial search text to complete
latitude	number	Yes	Center latitude the suggestions are biased to
longitude	number	Yes	Center longitude the suggestions are biased to
span	number	No	Viewport size in degrees around the center. Defaults to 0.05; minimum 0.001, maximum 5.
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.

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "query": "blue bot",
    "suggestions": [
      {
        "type": "query",
        "text": "Blue Bottle Coffee",
        "detail": "Search Nearby",
        "query": "Blue Bottle Coffee"
      },
      {
        "type": "business",
        "text": "Blue Bottle Coffee",
        "detail": "66 Mint St, San Francisco, CA  94103, United States",
        "place_id": "I8A3B1C2D4E5F6071",
        "id": "13662822354918264874",
        "latitude": 37.7739334,
        "longitude": -122.4186249,
        "place": {
          "id": "13662822354918264874",
          "place_id": "I8A3B1C2D4E5F6071",
          "url": "https://maps.apple.com/place?place-id=I8A3B1C2D4E5F6071",
          "name": "Blue Bottle Coffee",
          "type": "BUSINESS",
          "category": "Coffee Shop",
          "latitude": 37.7739334,
          "longitude": -122.4186249,
          "address": "66 Mint St, San Francisco, CA  94103, United States",
          "rating": 4.5,
          "rating_max": 5,
          "rating_count": 1873,
          "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

GETapiKey1 credit/requestapplemaps.autocompleteResponseDocApple Maps

GET /apple-maps/autocomplete

Get Apple Maps search suggestions for a partial query

Returns Apple Maps typeahead suggestions for a partial query near a coordinate: query completions, matching businesses (resolved to the same place summary the search endpoint returns, with the place ID the place endpoint takes), and addresses.

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

query

requiredstring

Partial search text to completelatitude

requirednumber

Center latitude the suggestions are biased tolongitude

requirednumber

Center longitude the suggestions are biased to

Add an API key to send a live request.

If an active API key is configured, Copy cURL includes it. Share links never include API keys.

View docs

Sample responseGET

Shown before your first request. Add an API key and send a request to see the live response, status, latency, and headers.

{
  "code": 200,
  "msg": "OK",
  "data": {
    "query": "blue bot",
    "suggestions": [
      {
        "type": "query",
        "text": "Blue Bottle Coffee",
        "detail": "Search Nearby",
        "query": "Blue Bottle Coffee"
      },
      {
        "type": "business",
        "text": "Blue Bottle Coffee",
        "detail": "66 Mint St, San Francisco, CA  94103, United States",
        "place_id": "I8A3B1C2D4E5F6071",
        "id": "13662822354918264874",
        "latitude": 37.7739334,
        "longitude": -122.4186249,
        "place": {
          "id": "13662822354918264874",
          "place_id": "I8A3B1C2D4E5F6071",
          "url": "https://maps.apple.com/place?place-id=I8A3B1C2D4E5F6071",
          "name": "Blue Bottle Coffee",
          "type": "BUSINESS",
          "category": "Coffee Shop",
          "latitude": 37.7739334,
          "longitude": -122.4186249,
          "address": "66 Mint St, San Francisco, CA  94103, United States",
          "rating": 4.5,
          "rating_max": 5,
          "rating_count": 1873,
          "price_level": 2,
          "price_max": 4,
          "price_symbol": "$"
        }
      }
    ]
  }
}

Endpoint details

Method: GET
Path: /apple-maps/autocomplete
Authentication: apiKey
Credit cost: 1 credit/request
Platform: Apple Maps
Parameters: 7 documented fields

Request parameters

query:querylatitude:querylongitude:queryspan:querylang:querycountry:queryx-api-key:header

Response schema fields

codedatadata.querydata.suggestionsdata.suggestions[].detaildata.suggestions[].iddata.suggestions[].latitudedata.suggestions[].longitudedata.suggestions[].placedata.suggestions[].place.addressdata.suggestions[].place.address_infodata.suggestions[].place.address_info.city

Sample response summary

{
  "code": 200,
  "msg": "OK",
  "data": {
    "query": "blue bot",
    "suggestions": [
      {
        "type": "query",
        "text": "Blue Bottle Coffee",
        "detail": "Search Nearby",
        "query": "Blue Bottle Coffee"
      },
      {
        "type": "business",
        "text": "Blue Bottle Coffee",
        "detail": "66 Mint St, San Francisco, CA  94103, United States",
        "place_id": "I8A3B1C2D4E5F6071",
        "id": "13662822354918264874",
        "latitude": 37.7739334,
        "longitude": -122.4186249,
        "place": {
          "id": "13662822354918264874",
          "place_id": "I8A3B1C2D4E5F6071",
          "url": "https://maps.apple.com/place?place-id=I8A3B1C2D4E5F6071",
          "name": "Blue Bottle Coffee",
          "type": "BUSINESS",
          "category": "Coffee Shop",
          "latitude": 37.7739334,
          "longitude": -122.4186249,
          "address": "66 Mint St, San Francisco, CA  94103, United States",
          "rating": 4.5,
          "rating_max": 5,
          "rating_count": 1873,
          "price_level": 2,
          "price_max": 4,
          "price_symbol": "$"
        }
      }
    ]
  }
}

cURL example

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

View endpoint docs Open platform page Browse all endpoints Pricing List Apple Maps browse categories for an area Browse one Apple Maps category near a coordinate 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

Endpoint Playground

Try the Apple Maps Autocomplete API

Endpoint facts

Method: GET
API path: /apple-maps/autocomplete
Platform: Apple Maps
Auth: apiKey
Credits: 1 credit/request
Required params: query, latitude, longitude
Common optional params: span, lang, country

Prefilled cURL

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

Request parameters visible to crawlers

Parameter	Type	Required	Description
query	string	Yes	Partial search text to complete
latitude	number	Yes	Center latitude the suggestions are biased to
longitude	number	Yes	Center longitude the suggestions are biased to
span	number	No	Viewport size in degrees around the center. Defaults to 0.05; minimum 0.001, maximum 5.
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.

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "query": "blue bot",
    "suggestions": [
      {
        "type": "query",
        "text": "Blue Bottle Coffee",
        "detail": "Search Nearby",
        "query": "Blue Bottle Coffee"
      },
      {
        "type": "business",
        "text": "Blue Bottle Coffee",
        "detail": "66 Mint St, San Francisco, CA  94103, United States",
        "place_id": "I8A3B1C2D4E5F6071",
        "id": "13662822354918264874",
        "latitude": 37.7739334,
        "longitude": -122.4186249,
        "place": {
          "id": "13662822354918264874",
          "place_id": "I8A3B1C2D4E5F6071",
          "url": "https://maps.apple.com/place?place-id=I8A3B1C2D4E5F6071",
          "name": "Blue Bottle Coffee",
          "type": "BUSINESS",
          "category": "Coffee Shop",
          "latitude": 37.7739334,
          "longitude": -122.4186249,
          "address": "66 Mint St, San Francisco, CA  94103, United States",
          "rating": 4.5,
          "rating_max": 5,
          "rating_count": 1873,
          "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

GETapiKey1 credit/requestapplemaps.autocompleteResponseDocApple Maps

GET /apple-maps/autocomplete

Get Apple Maps search suggestions for a partial query

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

query

requiredstring

Partial search text to completelatitude

requirednumber

Center latitude the suggestions are biased tolongitude

requirednumber

Center longitude the suggestions are biased to

Add an API key to send a live request.

If an active API key is configured, Copy cURL includes it. Share links never include API keys.

View docs

Sample responseGET

Shown before your first request. Add an API key and send a request to see the live response, status, latency, and headers.

{
  "code": 200,
  "msg": "OK",
  "data": {
    "query": "blue bot",
    "suggestions": [
      {
        "type": "query",
        "text": "Blue Bottle Coffee",
        "detail": "Search Nearby",
        "query": "Blue Bottle Coffee"
      },
      {
        "type": "business",
        "text": "Blue Bottle Coffee",
        "detail": "66 Mint St, San Francisco, CA  94103, United States",
        "place_id": "I8A3B1C2D4E5F6071",
        "id": "13662822354918264874",
        "latitude": 37.7739334,
        "longitude": -122.4186249,
        "place": {
          "id": "13662822354918264874",
          "place_id": "I8A3B1C2D4E5F6071",
          "url": "https://maps.apple.com/place?place-id=I8A3B1C2D4E5F6071",
          "name": "Blue Bottle Coffee",
          "type": "BUSINESS",
          "category": "Coffee Shop",
          "latitude": 37.7739334,
          "longitude": -122.4186249,
          "address": "66 Mint St, San Francisco, CA  94103, United States",
          "rating": 4.5,
          "rating_max": 5,
          "rating_count": 1873,
          "price_level": 2,
          "price_max": 4,
          "price_symbol": "$"
        }
      }
    ]
  }
}

Endpoint details

Method: GET
Path: /apple-maps/autocomplete
Authentication: apiKey
Credit cost: 1 credit/request
Platform: Apple Maps
Parameters: 7 documented fields

Request parameters

query:querylatitude:querylongitude:queryspan:querylang:querycountry:queryx-api-key:header

Response schema fields

Sample response summary

{
  "code": 200,
  "msg": "OK",
  "data": {
    "query": "blue bot",
    "suggestions": [
      {
        "type": "query",
        "text": "Blue Bottle Coffee",
        "detail": "Search Nearby",
        "query": "Blue Bottle Coffee"
      },
      {
        "type": "business",
        "text": "Blue Bottle Coffee",
        "detail": "66 Mint St, San Francisco, CA  94103, United States",
        "place_id": "I8A3B1C2D4E5F6071",
        "id": "13662822354918264874",
        "latitude": 37.7739334,
        "longitude": -122.4186249,
        "place": {
          "id": "13662822354918264874",
          "place_id": "I8A3B1C2D4E5F6071",
          "url": "https://maps.apple.com/place?place-id=I8A3B1C2D4E5F6071",
          "name": "Blue Bottle Coffee",
          "type": "BUSINESS",
          "category": "Coffee Shop",
          "latitude": 37.7739334,
          "longitude": -122.4186249,
          "address": "66 Mint St, San Francisco, CA  94103, United States",
          "rating": 4.5,
          "rating_max": 5,
          "rating_count": 1873,
          "price_level": 2,
          "price_max": 4,
          "price_symbol": "$"
        }
      }
    ]
  }
}

cURL example

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