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 "x-api-key: geoq_live_***"

What you get

• Abuse signals — is_vpn, is_proxy, connection_type (+ datacenter_provider), is_tor, is_drop_listed.
• Verified crawler — is_verified_bot (+ verified_bot_name): a verified good crawler like Googlebot you must not block. Not bad-bot detection, and it carries zero risk weight.
• Evidence — a per-signal evidence label (authoritative / inferred / beta) showing how directly we observe each signal — not a probability claim.
• 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 detection is in beta. GeoQ must not be the sole basis of an automated decision about an individual — see the acceptable use policy. Think we got an IP wrong? Report a false positive.

Next steps

• Quickstart — make your first call in two minutes.
• Authentication — API keys and headers.
• The /v1/check endpoint — full reference.
• Batch lookups — POST /v1/check/batch, up to 100 IPs in one call.
• Response schema — every field, typed.
• Migration mode — the ?format=ipinfo compatibility shape.
• Risk-score methodology — the exact formula.
• SDKs — JavaScript, Python, Go.
• Rate limits and errors.
• Report a false positive — think we got an IP wrong?
• Changelog — what's new in the API.

Migrating from another provider?

Field-mapping tables and before/after code to switch in an afternoon:

• From IPinfo — includes a ?format=ipinfo compatibility mode.
• From IPQualityScore — IP-only at flat pricing, auditable score.
• From MaxMind — hosted one-call API instead of database downloads.

Base URL

All requests go to:

https://api.geoq.io