geonames.place.search
mock data$0.001 / callGeoNames Place Search
Search the GeoNames geographical database for places, populated areas, mountains, rivers, and 12M+ geographical features worldwide. Filter by country (ISO-3166 2-letter code), feature class (A=administrative, P=populated place, T=mountain, H=water body, S=building/spot), and feature code (e.g. PPLC=capital, MT=mountain, STM=stream). Results include geoname_id, lat/lng, country, admin1/admin2, population, and Wikipedia link. Order by relevance (default), population, elevation, or Wikipedia linkage. Supports multilingual name lookup via lang parameter. CC BY 4.0 open data, no upstream cost.
Input schema
Full-text search query across place names, alternate names, and feature codes (e.g. "Paris", "Mont Blanc")
Search by exact or partial official place name (more precise than q; e.g. "New York")
Filter results to this ISO-3166 2-letter country code (e.g. "US", "FR", "DE")
ISO 639-1 language code for localized names in the response (e.g. "en", "fr", "de")
Maximum number of results to return (default 10, max 1000)
Sort order: "relevance" (default, best name match), "population" (largest first), "elevation" (highest first), "wikipedia" (most linked)
Zero-based offset for pagination (default 0)
GeoNames feature code for fine-grained filtering (e.g. "PPLC"=capital, "MT"=mountain, "STM"=stream)
GeoNames feature class: A=administrative, H=hydrographic, L=parks/area, P=populated place, R=road, S=spot/building, T=mountain/hill, U=undersea, V=vegetation
Call via REST
curl -X POST https://unifyapi.pro/api/call/geonames.place.search \
-H "Authorization: Bearer uak_live_..." \
-H "Content-Type: application/json" \
-d '{"q":"<q>","name":"<name>","country":"<country>","language":"<language>","max_rows":0,"order_by":"<order_by>","start_row":0,"feature_code":"<feature_code>","feature_class":"<feature_class>"}'