PiriAPI delivers structured, hierarchical location data — countries, states, cities, districts — via a fast RESTful interface. Powered by OpenStreetMap. Built for developers who need precise geospatial data without the overhead.
Capabilities
From a simple country list to deep hierarchical traversal and full-text search — PiriAPI covers the full spectrum of geospatial data needs.
Navigate seamlessly from country level down to state, city, and district. Each place carries its admin level, parent address chain, and localized names.
Instant search across millions of place names in any language. FTS index is kept in sync automatically — query by any part of the name.
Resolve any IP address to a physical location. Look up country, region, and city from a single IP string.
All data is sourced from OpenStreetMap via Nominatim-compatible ingestion. Global coverage with accurate administrative boundaries at every level.
Consume PiriAPI over REST (HTTP/JSON), gRPC (Protocol Buffers, HTTP/2), or GraphQL — pick the transport that fits your stack. All protocols expose the same data model.
Import large datasets in bulk via file upload. Supports Nominatim-compatible JSON structures for seamless migration and initial seeding.
API Reference
Standard REST conventions throughout. Every response is JSON with consistent pagination via limit, offset, and count.
{ "list": [ { "id": "174737", "admin_level": 2, "localname": "Türkiye", "country_code": "tr", "coordinates": [35.231, 39.294] } // ... 194 more countries ], "count": 195 }
Data Source
PiriAPI ingests Nominatim-compatible place records from OpenStreetMap, giving you the most comprehensive and up-to-date administrative boundary dataset available.
live place index activity
Get Started
Sign in with your email — no password required. Get an API key and make your first request in under two minutes.