The playground

Try any of 1042 endpoints — live.

Pick an endpoint, load a working example, tweak the params, and send — no signup to try. Results render the way the data deserves; raw JSON, headers & code are one tab away.

Playground demo key · api.reefapi.com

post/ip-geolocation/v1/batch2 credits

geolocate up to 100 IPs in one call

Working example

Parameters

ipsrequired

Up to 100 IPv4/IPv6 addresses. A JSON array, OR a comma/space/newline-separated string. Bad/private IPs are kept (per-item status) so one bad entry never fails the call.

langoptional

Preferred language for place names (country/region/city), e.g. en, de, fr, es, ru, ja. Falls back to English when a locale name is unavailable.

request preview

curl -X POST https://api.reefapi.com/ip-geolocation/v1/batch \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"ips":"[\"8.8.8.8\",\"1.1.1.1\",\"192.168.0.1\",\"nonsense\"]"}'

Hit Send to run this endpoint live.