Help

Frequently asked questions

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 30,000 · Basic 100,000 · Advanced 1.5M · Business 5M; your first 15 days include every field at the free allowance). One single-IP request counts as one; a batch ipList request counts as one per address. /api/meta is free and never counted. 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, or the endpoint needs a higher plan (plan_required). 404 — the AS or prefix was not found. 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?

Each answer combines geolocation, time-zone, ASN and regional-registry data with VPN, proxy, Tor, cloud, crawler and threat lists. Country and network data are highly reliable; city-level answers locate the network, not the device. See Data coverage for what each signal tells you, and Data sources for every source and licence.

Can I get the raw JSON shape?

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