Docs

Overview

GeoQ is a single-endpoint IP intelligence API. One authenticated GET request returns abuse signals, geolocation, network (ASN) data and a transparent risk score for any public IP address.

$ curl "https://api.geoq.io/v1/check?ip=8.8.8.8" \
    -H "Authorization: Bearer geoq_live_***"

What you get

• Abuse signals — is_vpn, is_proxy, is_datacenter (+ datacenter_provider), is_tor, is_bot.
• Risk score — a documented 0–100 score with level and reasons[].
• Geolocation — country, region, city, lat/long, timezone.
• Network — asn and as_org.

Every signal is probabilistic, not a statement of fact. Residential-proxy and bot detection are in beta. GeoQ must not be the sole basis of an automated decision about an individual — see the acceptable use policy.

Next steps

• Quickstart — make your first call in two minutes.
• Authentication — API keys and headers.
• The /v1/check endpoint — full reference.
• Response schema — every field, typed.
• Risk-score methodology — the exact formula.
• SDKs — JavaScript, Python, Go.
• Rate limits and errors.

Base URL

All requests go to:

https://api.geoq.io