Endpoint Playground
Searches OpenStreetMap places by address. Pass either free-text `q` or structured fields (`street`, `city`, `county`, `state`, `country`, `postalcode`), not both. `limit` defaults to 10 and is clamped to 20; `countrycodes` restricts by ISO 3166-1 alpha-2 country. Each result has its display name, coordinates, category, type, bounding box, importance and address parts. No match returns `404`.
14 Oct 2026: 1 results; 15 fields had a value in every checked item.
Sample value profiles: licence: “Data © OpenStreetMap contributors, ODbL 1.0. http://osm.org…”; display_name: median 138 characters; boundingbox: median 4 entries.
curl "https://api.crawlora.net/api/v1/geocoding/search?q=Brandenburg+Gate+Berlin&limit=5&countrycodes=de&accept_language=en&addressdetails=true" \
-H "x-api-key: $CRAWLORA_API_KEY"| Parameter | Type | Required | Prefilled value | Description |
|---|---|---|---|---|
| q | string | No | Brandenburg Gate Berlin | Free-text search query |
| street | string | No | Structured street or house number | |
| city | string | No | Structured city | |
| county | string | No | Structured county | |
| state | string | No | Structured state | |
| country | string | No | Structured country | |
| postalcode | string | No | Structured postal code | |
| limit | integer | No | 5 | Maximum results, defaults to 10 and clamps to 20 |
| countrycodes | string | No | de | Comma-separated ISO 3166-1 alpha-2 country filters |
| accept_language | string | No | en | Preferred result language, forwarded to Nominatim |
| addressdetails | boolean | No | true | Include address details, defaults to true |
| extratags | boolean | No | Include OSM extra tags | |
| namedetails | boolean | No | Include multilingual name details |
{
"code": 200,
"msg": "OK",
"data": {
"query": "Empire State Building",
"results": [
{
"place_id": 358220252,
"osm_type": "way",
"osm_id": 34633854,
"lat": "40.7484421",
"lon": "-73.9856589",
"category": "office",
"type": "yes",
"place_rank": 30,
"importance": 0.5803438355141769,
"addresstype": "office",
"name": "Empire State Building",
"display_name": "Empire State Building, 350, 5th Avenue, New York, United States",
"address": {
"office": "Empire State Building",
"house_number": "350",
"road": "5th Avenue",
"city": "New York",
"state": "New York",
"postcode": "10118",
"country": "United States",
"country_code": "us"
},
"boundingbox": [
"40.7479255",
"40.7489585",
"-73.9865012",
"-73.9848166"
]
}
]
}
}The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.