Docs

Place autocomplete API reference

Call this endpoint on each debounced keystroke. Prefix matching starts after two characters. Search is scoped to one country index via lang.

Endpoint

GET /locations/search

From the browser demo, requests go through /api/locations/search on meridian-api.com.

q: Partial place name from the autocomplete input. Required for useful results; matching uses normalized names (accents folded).
lang: Country index code. Examples: us United States, nl Netherlands, de Germany, fr France, ch Switzerland. Full live list: coverage.
limit: Maximum hits, 1–100. The public demo requests 10.

GET /locations/search?q=bretagne&lang=fr&limit=10

The JSON includes title, subtitle, scores, and a location object with parents, children, and lineage. A longer sample is on the homepage API section.

Debounce input (the demo waits on keystrokes), require at least two characters, then GET. Unlimited calls are included on monthly plans.