Quick answers about the IpQuery.Info API, quotas, and data. Still stuck? See the documentation or contact us.

Getting started

How do I authenticate?

Use an Authorization: Bearer API_KEY header whenever your client supports headers. A default key is created automatically when you start your trial — copy it from the API Keys page. URL-only clients may use ?apiKey=API_KEY when query-key compatibility is enabled, but should use a dedicated restricted key because URLs can be retained by logs, browser history, email scanners, and analytics systems.

Which IP does a request look up?

Pass ip= for a single address, ipList= for a query-string batch, send a POST body for larger bulk lookups, or omit all selectors to look up the address the request comes from. When you call from your back end, "the caller" is your server — pass the visitor's IP explicitly with ip=.

Is IPv6 supported?

Yes. Both IPv4 and IPv6 addresses are accepted anywhere an IP is expected.

Quotas & billing

How does my monthly quota work?

Each plan includes a monthly request allowance (Free trial 1,000 · Basic 100,000 · Advanced 1.5M · Enterprise 5M). One single-IP request counts as one; a batch ipList request counts as one per address. Your remaining allowance and reset cycle are on the Statistics dashboard.

What happens when I run out?

The API returns HTTP 429 until the cycle resets or you upgrade on the Account & Billing page.

Errors & behaviour

What do the status codes mean?

400 — invalid input. 401 — missing or invalid bearer key. 403 — key restrictions rejected the request. 405 — unsupported method. 413 — bulk request too large. 429 — monthly quota or per-key/client-IP rate limit exceeded. 503 — account configuration or enrichment is temporarily unavailable.

What is "Record-Only" mode?

A per-key option (on the API Keys page). A Record-Only key returns just an acknowledgement instead of the enrichment data, so it's safe to use from the browser to feed your Statistics while keeping the dataset private. You can also enable Rate Limit by IP to throttle a single caller to one request per five minutes.

How do I segment my usage?

Add a tag (max 20 chars) to single-address requests — it's recorded with the lookup so you can filter your charts by campaign, product, or source. See Segment usage with tags.

Data & accuracy

Where does the data come from?

Enrichment combines several datasets — MaxMind GeoLite2 and DB-IP (geolocation), RIPE NCC (European network registration), plus VPN/proxy/Tor, cloud, crawler and spam lists. City-level geolocation is approximate by nature; country and network data are highly reliable.

Can I get the raw JSON shape?

Yes — the full field reference and a machine-readable OpenAPI spec are in the documentation.