locate-me

The lookup above as a call to /v1/lookup, and the answer exactly as the server sent it.

Waiting for the first lookup.

Lookups need an API key in a header. Health checks and the playground do not.

• GET/v1/lookup/{ip}Locate one address
• GET/v1/lookup/meLocate the caller
• POST/v1/lookupLocate up to 100 addresses at once
• GET/v1/infoDatabase build, key limits, attribution
• GET/healthzLiveness
• GET/readyzReadiness: a database is loaded
• GET/metricsPrometheus metrics on port 9090
• GET/playground/lookup/{ip}Keyless lookups for this page

1. Create a key

   The server prints the key once and a config entry that stores only its SHA-256.

   locate-me gen-key --name my-client

2. Register it and start

   Paste the printed [[api_keys]] block into config.toml. The first start downloads the current DB-IP database.

   docker compose up -d

3. Look up an address

   Send the key in a header. Keys are never accepted in the URL.

   curl -H "X-API-Key: $LOCATE_ME_KEY" \
     http://localhost:8080/v1/lookup/8.8.8.8

Single thread, random addresses, October 2026 database. HTTP: 64 keep-alive connections at about 81,000 requests per second on a 16-core Windows 11 machine.