Location
location.country, location.country_code, location.state, location.city, location.latitude, location.longitude, location.timezone, location.zip — IP-derived estimates when coverage exists.
Docs
A clear path from example to integration. Keep credentials on your server, handle missing fields, and test failure cases before going live.
POST /api/v1/lookup with X-API-Key.Endpoint: POST {ORIGIN}/api/v1/lookup
Auth: header X-API-Key: $SIGNALLAYER_API_KEY
Body JSON:
ip | q required string (IPv4/IPv6)
user_agent optional string (end-user UA)
Response: ipapi.is-shaped JSON (nested asn, location, company, …)
Errors:
401 invalid/missing key
429 daily or burst limit
Missing fields:
absent or null means unavailable — do not treat as false/clean
Never ship the API key in browser bundles.
curl -sS -X POST "https://YOUR_HOST/api/v1/lookup" \
-H "X-API-Key: $SIGNALLAYER_API_KEY" \
-H "Content-Type: application/json" \
-d '{"ip":"8.8.8.8","user_agent":"Mozilla/5.0"}'
location.country, location.country_code, location.state, location.city, location.latitude, location.longitude, location.timezone, location.zip — IP-derived estimates when coverage exists.
asn (nested), company, datacenter, hostname, connection_type, is_vpn, is_proxy, is_datacenter, is_tor, is_bogon, is_mobile.
is_crawler, crawler_name, is_bot, bot_status — from IP ranges and/or supplied User-Agent when sent. Describes the client string, not a unique device.
risk_signals.combined_bucket (LOW/MEDIUM/HIGH), plus nested UA/ASN/context scores when enrichment runs. Also is_abuser, abuse_age.
An IP does not identify a person. Geolocation is not GPS. VPN/proxy/datacenter flags do not prove fraud. A missing field is unavailable — never silently treat it as a reassuring false.
Suggest a region from country_code when present, and always let the user change it.
Combine is_vpn/is_proxy/is_datacenter/is_bot/risk_signals with your own app events. Prefer review queues over automatic hard blocks as a default.
Send the end-user User-Agent on lookups to improve crawler/bot classification. Keep raw UAs out of marketing analytics.
The public playground uses /api/v1/demo/lookup (rate-limited, no customer key). Production traffic must use /api/v1/lookup with X-API-Key. Do not send lookup payloads to third-party LLM services merely to generate explanations.