# GeoAPI.info

> Free geolocation and country data API on a global CDN. No API key. JSON responses with rate limiting.

GeoAPI provides IP geolocation, country demographics and geography, holiday calendars, flags, and search/filter endpoints for developers.

## Documentation

- [Interactive docs (Redoc)](https://geoapi.info/docs): Human-friendly API reference
- [OpenAPI 3 specification](https://geoapi.info/api/openapi.json): Machine-readable schema
- [Homepage (markdown)](https://geoapi.info/): Accept: text/markdown
- [API catalog (RFC 9727)](https://geoapi.info/.well-known/api-catalog): Service discovery
- [Agent skills index](https://geoapi.info/.well-known/agent-skills/index.json): Agent Skills
- [Terms & data licenses](https://geoapi.info/terms): Usage policy and CC BY-SA notices

## Core endpoints

- [GET /api/geo](https://geoapi.info/api/geo): Geolocation for the client IP
- [GET /api/holidays](https://geoapi.info/api/holidays): Public holidays (?country=&year=)
- [GET /api/country](https://geoapi.info/api/country): Country by code or name (?code= or ?name=)
- [GET /api/countries](https://geoapi.info/api/countries): Paginated country list
- [GET /api/countries/search](https://geoapi.info/api/countries/search): Search (?q=)
- [GET /api/countries/continent](https://geoapi.info/api/countries/continent): Filter by continent
- [GET /api/countries/currency](https://geoapi.info/api/countries/currency): Filter by currency
- [GET /api/countries/stats](https://geoapi.info/api/countries/stats): Global statistics
- [GET /api/health](https://geoapi.info/api/health): Service health
- [GET /api/rate-limit](https://geoapi.info/api/rate-limit): Rate limit configuration

## Optional

- [llms-full.txt](https://geoapi.info/llms-full.txt): Extended endpoint notes
- [About](https://geoapi.info/about): Project background