Endpoint Playground
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.
14 Oct 2026: 8 suggestions; 3 fields had a value in every checked item and 6 varied between items.
Sample value profiles: type: business (6), query (2); detail: “Search Nearby” and 7 other values; query: “Blue Bottle Coffee”.
curl 'https://api.crawlora.net/api/v1/apple-maps/autocomplete?query=blue+bot&latitude=37.7749&longitude=-122.4194' \
-H "x-api-key: $CRAWLORA_API_KEY"| Parameter | Type | Required | Prefilled value | Description |
|---|---|---|---|---|
| query | string | Yes | blue bot | Partial search text to complete |
| latitude | number | Yes | 37.7749 | Center latitude the suggestions are biased to |
| longitude | number | Yes | -122.4194 | 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. |
{
"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": "$"
}
}
]
}
}The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.