Documentation menu
places
GET/places/search
API key required, sent as Authorization: Bearer snk_… or ?api_key=snk_….
Call it
bash
curl -fsS -X GET "https://api.mapmap.ai/places/search?q=…" \
-H "Authorization: Bearer $MAPMAP_KEY"Parameters
| Name | In | Required | Description |
|---|---|---|---|
| q | query | yes | Free-text query over name, alternative names, street, locality, region and postcode (required) |
| lat | query | no | Focus latitude for proximity-biased ranking; requires lon |
| lon | query | no | Focus longitude for proximity-biased ranking; requires lat |
| limit | query | no | Maximum results, 1–50 (default 10) |
| category | query | no | Restrict hits to places carrying this category |
Responses
200Ranked hits (empty when no dataset is stored)
| Field | Type | Required | Description |
|---|---|---|---|
| count | integer | yes | Number of results returned. |
| query | string | yes | The query text as interpreted. |
| results | PlaceSearchHit[] | yes | Ranked hits, best first. Empty when no dataset is stored. |
400Missing
q or a malformed parameter401Missing or invalid API key
404Customer places not configured on this gateway
Error bodies follow the shared problem model documented on API conventions.
Also under places
Generated from https://api.mapmap.ai/openapi.json on 2026-09-17 · operationId search_places