API Documentation

Everything you need to integrate Geoloods into your app. Search, reverse geocode, find nearby locations, and query by bounding box.

Get API KeyTry it live
BASE URL
https://api.geoloods.io/v2/
AUTHENTICATION

Include your API key as a header or query parameter:

X-API-Key: YOUR_API_KEY
or
?api_key=YOUR_API_KEY
GET
/search

Search named places (cities, towns, villages, parks, landmarks). Not streets, addresses, or venues.

PARAMETERS
queryrequired- Named place to search
langoptional- Language code (e.g., en, nl)
EXAMPLE
curl "https://api.geoloods.io/v2/search?query=Amsterdam&lang=en" \
  -H "X-API-Key: YOUR_API_KEY"
GET
/geocode

Find a named place for coordinates (reverse geocoding). Default is settlement and admin labels.

PARAMETERS
latrequired- Latitude coordinate
lngrequired- Longitude coordinate
filteroptional- smart (default: settlement/admin; HTL/RSRT/MALL excluded) or simple (opt-in nearest feature; may return hotels)
resultsoptional- Maximum number of results
langoptional- Language code (e.g., en, nl)
EXAMPLE
curl "https://api.geoloods.io/v2/geocode?lat=52.370216&lng=4.895168" \
  -H "X-API-Key: YOUR_API_KEY"

Unnamed request uses filter=smart. Hotels and venues belong on /nearby. Opt-in nearest feature:

curl "https://api.geoloods.io/v2/geocode?lat=52.370216&lng=4.895168&filter=simple" \
  -H "X-API-Key: YOUR_API_KEY"
GET
/nearby

Find named places within a radius of specified coordinates. Use this for what's around, including hotels.

PARAMETERS
latrequired- Center latitude
lngrequired- Center longitude
radius_kmoptional- Radius in km (default: 10, range: 0.1-100)
limitoptional- Maximum results to return
langoptional- Language code (e.g., en, nl)
EXAMPLE
curl "https://api.geoloods.io/v2/nearby?lat=59.9139&lng=10.7522&radius_km=50" \
  -H "X-API-Key: YOUR_API_KEY"
Returns an array of Location objects sorted by distance.
GET
/bbox

Find locations within a bounding box (rectangular area).

PARAMETERS
min_latrequired- Minimum latitude (south)
max_latrequired- Maximum latitude (north)
min_lngrequired- Minimum longitude (west)
max_lngrequired- Maximum longitude (east)
limitoptional- Maximum results to return
langoptional- Language code (e.g., en, nl)
EXAMPLE
curl "https://api.geoloods.io/v2/bbox?min_lat=59.8&max_lat=60.0&min_lng=10.6&max_lng=10.9" \
  -H "X-API-Key: YOUR_API_KEY"
Maximum bounding box size: 10° in either dimension. Returns an array of Location objects.
GET
/countries

List all countries with ISO codes and metadata.

AUTHENTICATION

Requires authentication via X-API-Key header or api_key query parameter.

EXAMPLE
curl "https://api.geoloods.io/v2/countries" \
  -H "X-API-Key: YOUR_API_KEY"
RESPONSE FIELDS
Each country object includes: code (ISO 3166-1 alpha-2), name, iso3, iso_numeric, capital, area, population, continent, tld, currency_code, currency_name, and more.