IPAPI Integration

Official IPAPI API Documentation · Pricing

Look up the approximate location of one explicitly supplied IPv4 or IPv6 address through IPAPI. Use your KeyPool team token and a stable base URL.

This integration uses IPAPI Free access. Current provider pricing lists 100 included lookups per month per free account, location data, HTTPS, and non-commercial use. The number of lookups remaining can be lower; a Free subscription does not guarantee available quota or access to other data fields.

Endpoint

{YOUR_KEYPOOL_BASE_URL}/v1/ipapi

Authentication

Send your KeyPool team token as a bearer token. Do not pass an upstream access_key query parameter.

Authorization: Bearer {KEYPOOL_TOKEN}

Quick Start

Look Up One IP Address

curl "${KEYPOOL_BASE_URL}/v1/ipapi/161.185.160.93" \
  -H "Authorization: Bearer ${KEYPOOL_TOKEN}"

Look Up KeyPool Egress

curl "${KEYPOOL_BASE_URL}/v1/ipapi/check" \
  -H "Authorization: Bearer ${KEYPOOL_TOKEN}"

/check returns the IP address observed on KeyPool's outbound request. It does not reveal the ChatGPT or Codex user's device IP or establish that user's location.

IP-based location is approximate. Use only the fields actually returned by IPAPI. If a request fails because of quota, plan access, or another provider error, retain that error when reporting the result.

Interactive API Reference

For in-browser testing, see API Reference -> IPAPI.