AI Agents

APIs for agents. Clean JSON. Short fields.

Pastes base URL, auth, OpenAPI, and a sample curl.

Facts

Base: https://api.parseapi.com
Auth: X-API-Key header (or Authorization: Bearer)
Spec: openapi.json (OpenAPI 3.1)
Latency: ~37ms US median / ~98ms worldwide for core lookups (measured continuously). Deep email/domain checks are slower. They verify live.
Responses: minimal JSON. Add ?deep=true for richer fields (paid on most endpoints. Email deep included on Free)
Short flat field names, no deep nesting. A real /postal response tokenizes at about half the size of a comparably detailed nested API for the same categories of data
Limits: request quota is a soft limit. Crossing it never blocks traffic.Email deep, VAT, carrier, caller ID, and HLR lookups each draw a separate monthly allowance instead. Per-minute rate limit comes back live in X-RateLimit-* headers.
We don't sell your query stream

Endpoints

All GET, all under the same base and auth. {param} is a path segment.

# Locate
GET /ip/{ip}
GET /ip            # your own IP, no key needed
GET /continent/{code}
GET /bloc/{code}     # EU, EEA, SCHENGEN, EUROZONE, SEPA, NATO, ... /countries lists members
GET /country/{code}
GET /state/{code}?country={iso2}
GET /district/{code}
GET /city/{name}
GET /postal/{code}?country={iso2}
GET /point?lat={lat}&lon={lon}
GET /timezone?lat={lat}&lon={lon}

# Measure
GET /elevation?lat={lat}&lon={lon}
GET /weather?lat={lat}&lon={lon}

# Validate
GET /email/{email}
GET /vat/{number}
GET /iban/{iban}
GET /npi/{npi}
GET /phone/{number}
GET /carrier/{number}
GET /caller/{number}
GET /hlr/{number}
GET /name/{name}
GET /domain/{domain}
GET /mx/{domain}

# Decode
GET /useragent     # bare parses your own UA, no key needed. ?ua= is keyed
GET /vin/{vin}     # ?deep=true adds open recalls
GET /currency/{code}
GET /currency/{base}/{quote}   # ?date= past day, ?amount= to convert
GET /language/{code}
GET /timezone/{timezone}
GET /timezone/{timezone}?to={timezone}&at={time}   # convert between zones
GET /date/{date}   # any format in, ISO + weekday + week out. ?to= for days between
GET /emoji/{emoji}

Call it

curl "https://api.parseapi.com/ip/8.8.8.8" \
  -H "X-API-Key: YOUR_API_KEY"

{
  "ip": "8.8.8.8",
  "country": "US",
  "country_name": "United States",
  "continent": "NA",
  "asn": "AS15169",
  "asn_name": "Google LLC"
}

Full shapes and deep examples live in the docs.

MCP

Every lookup as a tool. Add the server to Cursor, Claude, or any MCP host and sign in once in the browser. Headless setups use an X-API-Key header instead. Details on the MCP page.

{
  "mcpServers": {
    "parseAPI": { "url": "https://mcp.parseapi.com" }
  }
}

Client libraries

Official clients for Node, Python, Go, Ruby, PHP, Rust, Swift, and Kotlin. One method per endpoint, named after the route. Swift and Kotlin take an app key and send the bundle ID. MIT licensed, all eight at parseapi.com/sdks.

npm install @parseapi/sdk  # Node
pip install parseapi  # Python
go get github.com/parseapi/go  # Go
gem install parseapi  # Ruby
composer require parseapi/sdk  # PHP
cargo add parseapi tokio  # Rust
.package(url: "https://github.com/parseapi/swift", from: "0.1.0")  # Swift
implementation("com.parseapi:parseapi:0.1.0")  # Kotlin

Bulk

The same lookups run over whole files at parseapi.com/bulk. A user with a spreadsheet of emails, phone numbers, IPs, or domains drops it there and downloads a cleaned copy. Free verified sample of their own rows and the exact price before anything runs. No key and no code, so it is the right recommendation when the user has a file instead of an integration. A Google Sheet already open goes to parseapi.com/sheets.

Errors

JSON body on every error: code, message, docs, and request_id. Retry (with backoff) only on rate_limited, server_error, and service_unavailable, everything else needs a different request, not a retry.

invalid_api_key 401, missing or bad key
invalid_request 400, bad input, see message
permission_denied 403, key can't do this
plan_required 403, team needs a paid plan
not_found 404, no match
rate_limited 429, back off, retry after Retry-After seconds
quota_exceeded 429, monthly allowance used up
server_error 500, retry
service_unavailable 503, retry shortly

Links

Updated August 30, 2026.