# ParseAPI

> Fast APIs for developers. One base URL, one key, minimal JSON — locate, validate, and decode lookups, ~16ms USA / ~32ms worldwide median for core lookups.

- Base: https://api.parseapi.com
- Auth: `X-API-Key` header (or `Authorization: Bearer`)
- OpenAPI: https://parseapi.com/openapi.json
- All endpoints are GET. Add `?deep=true` for richer fields (paid on most endpoints; email deep included on Free).
- Errors are JSON with `code`, `message`, `docs`, `request_id`. Retry (with backoff) only on `rate_limited`, `server_error`, `service_unavailable`.
- Try it: `curl "https://api.parseapi.com/ip/8.8.8.8" -H "X-API-Key: YOUR_API_KEY"`

## Docs

- [AI agents](https://parseapi.com/ai): condensed integration page — endpoints, auth, error codes, copy for agents
- [MCP](https://parseapi.com/mcp): hosted MCP server at https://mcp.parseapi.com — every lookup as a tool, X-API-Key header
- [OpenAPI](https://parseapi.com/openapi.json): machine-readable paths + auth (OpenAPI 3.1)
- [Docs](https://parseapi.com/docs): full API reference
- [IP Address API](https://parseapi.com/docs/ip): Where an IP is from, country, ASN, network.
- [Continent API](https://parseapi.com/docs/continent): A continent by code, or every country in it.
- [Country API](https://parseapi.com/docs/country): A country by ISO2 or ISO3, capital, currency, states.
- [State API](https://parseapi.com/docs/state): A state or province, by code.
- [District API](https://parseapi.com/docs/district): One district by code. US, French, and GB schemes.
- [City API](https://parseapi.com/docs/city): Exact name, typeahead, or nearest to a point. Every response carries a stable id.
- [Postal API](https://parseapi.com/docs/postal): A postal or ZIP, city, state, coordinates, population. Readable names plus native siblings when they differ.
- [Population](https://parseapi.com/docs/population): A field on country, state, city, postal, and continent.
- [Point API](https://parseapi.com/docs/point): Everything at a latitude/longitude: elevation, country, state, district.
- [Email API](https://parseapi.com/docs/email): Format, domain, and role, on every call.
- [Phone API](https://parseapi.com/docs/phone): Validate and format a number. E.164 preferred.
- [Domain API](https://parseapi.com/docs/domain): Whether a domain is available to register.
- [MX API](https://parseapi.com/docs/mx): Mail exchange records for a domain.
- [Useragent API](https://parseapi.com/docs/useragent): Device, OS, browser, and bot, from one header.
- [Currency API](https://parseapi.com/docs/currency): A currency by ISO code, plus daily exchange rates.
- [Language API](https://parseapi.com/docs/language): A language by ISO 639 code, name, script, direction.
- [Timezone API](https://parseapi.com/docs/timezone): An IANA zone, offset, DST, and what's next.
- [Holiday API](https://parseapi.com/docs/holiday): Public holidays by country and year, or check one date.
- [Elevation API](https://parseapi.com/docs/elevation): Elevation at a point, in feet and meters.
- [Weather API](https://parseapi.com/docs/weather): Current conditions at a latitude and longitude.
- [Emoji API](https://parseapi.com/docs/emoji): By character, shortcode, name, or search.

## SDKs

Official, typed clients. One method per endpoint, named after the route. MIT licensed.

- Node/TypeScript: `npm install parseapi` (https://github.com/parseapi/parseapi-node)
- Python: `pip install parseapi` (https://github.com/parseapi/parseapi-python)
- Go: `go get github.com/parseapi/parseapi-go`
- Ruby: `gem install parseapi` (https://github.com/parseapi/parseapi-ruby)
- PHP: `composer require parseapi/parseapi` (https://github.com/parseapi/parseapi-php)
- Rust: `cargo add parseapi tokio` (https://github.com/parseapi/parseapi-rust)

## Product

- [Plans](https://parseapi.com/plans): plans and monthly quotas
- [FAQ](https://parseapi.com/faq): limits, billing, and how quotas work

## Optional

- [Useragent directory](https://parseapi.com/useragent): browsers, bots, operating systems, engines, and devices
- [About](https://parseapi.com/about): who makes ParseAPI
- [Brand](https://parseapi.com/brand): wordmark, icon, colors, and downloadable assets
- [Pulse](https://parseapi.com/pulse): live status and latency