# GeoSearch
> Geographic data REST API — countries, regions, cities, postal codes, timezones, IP geolocation.

## Docs
- [Documentation](https://geosearch.dev/docs): Documentation hub: getting started, API reference, boundary search guide and console.
- [Getting started](https://geosearch.dev/docs/getting-started): API key to first request in five minutes.
- [API reference](https://geosearch.dev/docs/api): API reference index: all 27 endpoints across 10 groups, with samples.
- [Health API](https://geosearch.dev/docs/api/health): Health endpoint: API status check, no authentication required.
- [Countries API](https://geosearch.dev/docs/api/countries): Country endpoints: list, detail by ISO code, regions and neighbors.
- [Regions API](https://geosearch.dev/docs/api/regions): Region endpoints: list, detail, and the cities within a region.
- [Cities API](https://geosearch.dev/docs/api/cities): City endpoints: list, detail, nearby search and administrative hierarchy.
- [Postal Codes API](https://geosearch.dev/docs/api/postal-codes): Postal code endpoints: list and nearest-neighbor search.
- [Timezones API](https://geosearch.dev/docs/api/timezones): Timezone endpoints: list and detail by IANA ID.
- [IP Geolocation API](https://geosearch.dev/docs/api/ip-geolocation): IP geolocation endpoints: lookup by address and caller lookup.
- [Search API](https://geosearch.dev/docs/api/search): Search endpoints: autocomplete, reverse geocoding, coordinate resolve and cross-type search.
- [Boundaries API](https://geosearch.dev/docs/api/boundaries): Boundary endpoint: area polygons as GeoJSON, 5 quota units per polygon.
- [Batch API](https://geosearch.dev/docs/api/batch): Batch endpoints: multi-entity lookup for cities, countries and regions.
- [Boundary search](https://geosearch.dev/docs/boundaries): Boundary search guide: GeoJSON polygons, containment queries and a live map demo.

## Product
- [GeoSearch](https://geosearch.dev/): Landing page: product overview with a live search demo.
- [Pricing](https://geosearch.dev/pricing): Pricing: Free, Basic, Pro and Business plans with per-second and monthly quota limits.
- [Country data](https://geosearch.dev/data): Country data hub: every country and territory in the dataset, with the API call behind each page.
- [GeoNames alternative](https://geosearch.dev/compare/geonames): GeoNames alternative: feature comparison, when GeoNames is right, and migration code.
- [GeoDB Cities alternative](https://geosearch.dev/compare/geodb-cities): GeoDB Cities alternative: feature comparison and side-by-side migration code.

## Legal
- [Terms of service](https://geosearch.dev/terms): Terms of service for the GeoSearch API.
- [Privacy policy](https://geosearch.dev/privacy): Privacy policy: what data GeoSearch stores and why.
- [Data attribution](https://geosearch.dev/attribution): Data source attribution: GeoNames, OpenStreetMap, Natural Earth, MaxMind and geoBoundaries.