# APICrate

> Rich & Fast JSON APIs for developers — user-agent parsing, hashing, country lookup, postal codes, timezones, email risk scoring, and more.

## URLs

- Website: https://apicrate.io
- API base: https://api.apicrate.io
- Documentation: https://apicrate.io/docs/
- Endpoints overview: https://apicrate.io/endpoints/
- Pricing: https://apicrate.io/pricing/
- Sign up: https://apicrate.io/accounts/signup/

## Authentication

All API endpoints require authentication via `Authorization: Bearer <jwt>` or `X-API-Key: ac_usr_...`.
Create a free account at https://apicrate.io/accounts/signup/ to get your API key.

## Available API Endpoints

### User Agent
Parse and classify User-Agent strings
- POST https://api.apicrate.io/api/v1/ua — Parse a single User-Agent string
- POST https://api.apicrate.io/api/v1/ua/bulk — Parse multiple User-Agent strings
- POST https://api.apicrate.io/api/v1/ua/compat/device-atlas — Parse User-Agents (DeviceAtlas-compatible format)
- Endpoint details: https://apicrate.io/endpoints/user-agent/

### Hash
Compute cryptographic hashes and key-derivation functions
- POST https://api.apicrate.io/api/v1/hash/md5 — Compute MD5 hash
- POST https://api.apicrate.io/api/v1/hash/sha1 — Compute SHA-1 hash
- POST https://api.apicrate.io/api/v1/hash/sha256 — Compute SHA-256 hash
- POST https://api.apicrate.io/api/v1/hash/sha512 — Compute SHA-512 hash
- POST https://api.apicrate.io/api/v1/hash/bcrypt — Hash with bcrypt
- POST https://api.apicrate.io/api/v1/hash/scrypt — Hash with scrypt
- POST https://api.apicrate.io/api/v1/hash/argon2id — Hash with Argon2id
- Endpoint details: https://apicrate.io/endpoints/hash/

### Countries
Look up ISO 3166 country and subdivision codes
- GET https://api.apicrate.io/api/v1/countries — List countries
- GET https://api.apicrate.io/api/v1/countries/{code} — Get a country by code
- GET https://api.apicrate.io/api/v1/countries/{code}/subdivisions — List subdivisions of a country
- GET https://api.apicrate.io/api/v1/subdivisions/{code} — Get a subdivision by code
- POST https://api.apicrate.io/api/v1/countries/validate — Validate country codes (batch)
- POST https://api.apicrate.io/api/v1/subdivisions/validate — Validate subdivision codes (batch)
- Endpoint details: https://apicrate.io/endpoints/countries/

### Timezones
Timezone lookup, conversion, and difference calculation
- GET https://api.apicrate.io/api/v1/timezones — List timezones
- GET https://api.apicrate.io/api/v1/timezones/{tz_name} — Get timezone details
- GET https://api.apicrate.io/api/v1/timezones-diff — Get hour difference between timezones
- GET https://api.apicrate.io/api/v1/timezones-convert — Convert time between timezones
- Endpoint details: https://apicrate.io/endpoints/timezones/

### Ip
Geolocate and enrich IP addresses
- GET https://api.apicrate.io/api/v1/ip/me — Look up caller's IP
- POST https://api.apicrate.io/api/v1/ip — IP geolocation lookup
- POST https://api.apicrate.io/api/v1/ip/bulk — Bulk IP geolocation lookup
- Endpoint details: https://apicrate.io/endpoints/ip/

### Postal
Search, validate, and look up postal / ZIP codes worldwide
- GET https://api.apicrate.io/api/v1/postal — List postal systems
- POST https://api.apicrate.io/api/v1/postal/validate — Validate postal codes (batch)
- GET https://api.apicrate.io/api/v1/postal/{country_code} — Get postal system for a country
- GET https://api.apicrate.io/api/v1/postal/{country_code}/codes — List all postal codes for a country
- GET https://api.apicrate.io/api/v1/postal/{country_code}/search — Search postal codes
- POST https://api.apicrate.io/api/v1/postal/{country_code}/within — Find postal codes within a polygon
- POST https://api.apicrate.io/api/v1/postal/{country_code}/nearby — Find postal codes near a point
- GET https://api.apicrate.io/api/v1/postal/{country_code}/validate/{postal_code} — Quick-validate a postal code
- GET https://api.apicrate.io/api/v1/postal/{country_code}/{postal_code} — Look up a postal code
- Endpoint details: https://apicrate.io/endpoints/postal/

### Bible
Browse and read Bible texts across 30 translations in 26 languages
- GET https://api.apicrate.io/api/v1/bible/languages — List languages
- GET https://api.apicrate.io/api/v1/bible/translations — List translations
- GET https://api.apicrate.io/api/v1/bible/translations/{translation_id} — Get translation detail
- GET https://api.apicrate.io/api/v1/bible/daily — Verse of the day / random verse
- GET https://api.apicrate.io/api/v1/bible/search — Search across translations
- GET https://api.apicrate.io/api/v1/bible/{translation}/search — Search within a translation
- GET https://api.apicrate.io/api/v1/bible/{translation}/books — List books
- GET https://api.apicrate.io/api/v1/bible/{translation}/books/{book} — Get book detail
- GET https://api.apicrate.io/api/v1/bible/{translation}/{book}/chapters — List chapters
- GET https://api.apicrate.io/api/v1/bible/{translation}/{book}/{chapter} — Get chapter content
- GET https://api.apicrate.io/api/v1/bible/{translation}/{book}/{chapter}/{verse_ref} — Get verse or verse range
- Endpoint details: https://apicrate.io/endpoints/bible/

### Email
Assess email addresses for risk indicators
- POST https://api.apicrate.io/api/v1/email/risk — Assess email risk
- POST https://api.apicrate.io/api/v1/email/risk/bulk — Assess email risk (bulk)
- Endpoint details: https://apicrate.io/endpoints/email/

## Common Features

- Field filtering: append `?fields=field1,field2` to reduce response payload
- Rate limiting headers: `X-Quota-Limit`, `X-Quota-Remaining`, `X-Quota-Reset`
- All responses are JSON
- OpenAPI spec: https://api.apicrate.io/openapi.json

## MCP Server

APICrate is available as an MCP (Model Context Protocol) server for AI agents.

- MCP endpoint: https://api.apicrate.io/mcp/
- MCP documentation: https://apicrate.io/docs/mcp/
- Transport: Streamable HTTP
- Authentication: X-API-Key header

### Available MCP Tools

#### 🔍 User-Agent
- apicrate-parse-user-agent (2 cr) — Parse browser, OS, device & bot from a UA string
- apicrate-parse-user-agents-bulk (1/UA) — Batch parse up to 100 UA strings at once

#### 🌐 IP Geolocation
- apicrate-geolocate-ip (5 cr) — Country, city, ISP, ASN & VPN/Tor detection for any IP

#### 🏳️ Countries
- apicrate-lookup-country (1 cr) — Full ISO 3166-1 record — capital, currencies, languages
- apicrate-search-countries (3 cr) — Filter countries by region, sub-region or query
- apicrate-validate-country-codes (1/code) — Validate up to 50 country codes in one call

#### 📮 Postal Codes
- apicrate-lookup-postal-code (2 cr) — Resolve a postal code to city, admin regions & coordinates
- apicrate-validate-postal-code (1 cr) — Check format validity and database existence
- apicrate-search-postal-codes (3 cr) — Search by prefix or place name within a country
- apicrate-list-postal-systems (2 cr) — List all countries with postal code data and their formats
- apicrate-get-postal-system (2 cr) — Get format, regex pattern & examples for a country's postal system
- apicrate-validate-postal-codes-bulk (2/code) — Batch validate up to 50 postal codes with format & existence checks
- apicrate-find-nearby-postal-codes (5 cr) — Find postal codes within a radius of a GPS point, ordered by distance

#### 🕐 Timezones
- apicrate-get-timezone-info (1 cr) — Current time, UTC offset & DST for any IANA timezone
- apicrate-convert-time (1 cr) — Convert a time between two IANA timezones

#### 🔐 Hashing
- apicrate-compute-hash (1 cr) — MD5, SHA-1, SHA-256 or SHA-512 in one call
- apicrate-hash-password (2 cr) — Hash passwords with bcrypt, scrypt or argon2id

#### 📖 Bible
- apicrate-get-bible-verse (1 cr) — Fetch a verse or range across 30 translations
- apicrate-search-bible (3 cr) — Full-text search across all translations

#### 📧 Email Risk
- apicrate-check-email-risk (4 cr) — Assess an email address for fraud risk (syntax, MX, disposable, domain age, abuse list)
- apicrate-check-email-risk-bulk (4/email) — Bulk assess up to 10 email addresses at once