# ipdata.info

> Free IP geolocation and network intelligence API. Look up any IPv4/IPv6
> address (or a domain, resolved to its IP) for country, city, region, ASN, ISP,
> timezone, currency, calling code, flag and proxy/VPN/Tor/hosting security
> signals — returned as JSON, XML, CSV, newline-delimited or PHP-serialized.
> Also offers a DNS resolver + EDNS Client Subnet detection API. Free for
> personal and commercial use: 50 requests/minute with no API key; higher
> limits with a key.

## API

- [Documentation](https://ipdata.info/docs): Full endpoint reference, response fields, examples, rate limits and error codes.
- [IP lookup (JSON)](https://ipdata.info/json/8.8.8.8): `GET /json/{ip}` — geolocation + ASN + currency + flag + security for any IP or domain.
- [Your own IP](https://ipdata.info/json/): `GET /json/` — the IP address you connected from.
- [Authenticated API v1](https://ipdata.info/api/v1/8.8.8.8): `GET /api/v1/{ip}` — same data; send `X-Api-Key` for higher limits and paid endpoints.
- [ASN lookup](https://ipdata.info/api/v1/asn/15169): `GET /api/v1/asn/{number}` — organisation, prefixes and address totals for an autonomous system.
- [DNS / EDNS resolver API](https://ipdata.info/docs): `GET http(s)://{token}.d.ipdata.info/json` — detect a client's DNS resolver and EDNS Client Subnet (ip-api.com/docs/dns style), free for commercial use.

## Output formats

- [JSON](https://ipdata.info/json/1.1.1.1): `/json/{ip}` — application/json; nested ipwhois.io-style object plus flat legacy fields.
- [XML](https://ipdata.info/xml/1.1.1.1): `/xml/{ip}` — application/xml.
- [CSV](https://ipdata.info/csv/1.1.1.1): `/csv/{ip}` — text/csv, single row.
- [Newline](https://ipdata.info/line/1.1.1.1): `/line/{ip}` — text/plain, one value per line.
- [PHP serialized](https://ipdata.info/php/1.1.1.1): `/php/{ip}` — text/plain, `unserialize()` into a PHP array.

## Usage

- Rate limit: 50 requests/minute per IP with no key. API keys raise limits (Basic 1,000/day, Pro 50,000/day) — see https://pro.ipdata.info.
- Auth: send the key as an `X-Api-Key: YOUR_KEY` header or `?key=YOUR_KEY` query parameter.
- Field filtering: append `?fields=country,city,asn` to a JSON or XML request to trim the response.
- Attribution: geolocation includes GeoLite2 data created by MaxMind, available from https://www.maxmind.com.

## Optional

- [Output formats page](https://ipdata.info/network): Interactive per-format examples using the caller's own IP.
- [Provider comparison](https://ipdata.info/compare): Side-by-side geolocation from ipdata.info, MaxMind, IP2Location, ipinfo.io and ip-api.com.
- [Pricing](https://ipdata.info/pricing): Free vs paid tiers and limits.
- [ASN page](https://ipdata.info/as/15169): Human-readable autonomous-system detail (prefixes, peers, WHOIS).