Base URL: /api/v1/geoip

Authentication

• Query: ?key=YOUR_API_KEY
• Header: X-API-Key: YOUR_API_KEY
• Header: Authorization: Bearer YOUR_API_KEY

Demo key

Public demo: rha_demo_public_key

Rate limit

Each key has a daily request quota (default 1000). Additionally each IP is limited to 100 requests per day. Exceeding either returns HTTP 429.

Lookup

GET /api/v1/geoip?key=YOUR_API_KEY&ip=8.8.8.8

JSON includes time_ms (server generation time) and header X-Response-Time. Client IP uses Cloudflare CF-Connecting-IP when the request arrives via CF.

Usage

GET /api/v1/usage?key=YOUR_API_KEY

Manage keys · Web lookup

Send request

{}