Documentation menu
mapbox-compat
GET/search/geocode/v6/forward
API key required, sent as Authorization: Bearer snk_… or ?api_key=snk_….
Call it
bash
curl -fsS -X GET "https://api.mapmap.ai/search/geocode/v6/forward?q=…" \
-H "Authorization: Bearer $MAPMAP_KEY"Parameters
| Name | In | Required | Description |
|---|---|---|---|
| q | query | yes | Search text |
| access_token | query | no | Your MapMap key (snk_...) |
| proximity | query | no | Bias as lon,lat (ip is refused) |
| bbox | query | no | minLon,minLat,maxLon,maxLat |
| country | query | no | ISO 3166-1 alpha-2 codes, comma-separated |
| limit | query | no | 1 to 10 |
| language | query | no | IETF tag; its primary subtag selects the result language |
| types | query | no | Filter on feature_type, applied to the page returned |
| autocomplete | query | no | Accepted and ignored |
| session_token | query | no | Accepted and ignored |
Responses
200Mapbox v6 FeatureCollection built from MapMap's own answers (shape-compatible, not Mapbox's results), with the OpenStreetMap
attribution400
{message}401Missing or invalid key
429Quota or rate limit exceeded
Error bodies follow the shared problem model documented on API conventions.
Also under mapbox-compat
Generated from https://api.mapmap.ai/openapi.json on 2026-10-17 · operationId get_v6_forward