
# Website Search

Website Search helps you find relevant pages and use the ProbeNet Live with CLI-like commands.

## What You Can Do

<video width="100%" controls>
  <source 
    src="https://website-cdn.assets.ipinfo.io/images/developers/website_search.mp4" 
    type="video/mp4"
  />
  Your browser does not support the video tag.
</video>

### Go to a country page

Search by country name or country code to go straight to a country page.

Examples:

- `Germany`
- `UK`
- `Spain`
- `US`
- `GB`

### Get your IP information

To open your IP information page, search for one of the following:

- `me`
- `my ip`
- `whats my ip`

### Use CLI-style commands

The search bar also supports command-style queries.

#### ProbeNet Live: Ping

- Ping your IP address: `ping me`
- Ping a specific IP address: `ping 1.1.1.1`

#### ProbeNet Live: Trace

- Trace your IP: `trace me`
- Trace a specific IP: `trace 8.8.8.8`

#### Star and unstar IPs

- Star an IP: `star 134.58.154.35`
- Unstar an IP: `unstar 134.58.154.35`

## Keyboard Shortcuts

Use these keyboard shortcuts in Website Search:

| Shortcut | Action |
| --- | --- |
| `/` | Start search |
| `G` then `I` | Go to My IP page |
| `G` then `A` | Go to My ASN page |

Libraries

# IPinfo ProbeNet Live

IPinfo [ProbeNet Live](/probenet/live) lets you ping or traceroute an IP address (IPv4 or IPv6) from [ProbeNet](https://ipinfo.io/probenet) PoPs (Points of Presence) around the world. Running measurements from multiple regions simultaneously helps you troubleshoot and investigate connectivity issues for any IP address.

## Acesss & Limit

| Feature | Free | Paid |
|---|---|---|
| Rate limits | Lower | Higher |
| Region selection | Continent only | Country and continent |
| Probe assignment | Random within continent | Random within country |

[Paid tier](/pricing) is available to subscribers of any premium IPinfo plan.

Acesss & Limit

## Ping

<video width="100%" controls>
  <source 
    src="https://website-cdn.assets.ipinfo.io/images/developers/probenet_live_ping.mp4" 
    type="video/mp4"
  />
  Your browser does not support the video tag.
</video>


A ping measurement sends 10 packets per probe operation and summarizes results visually in the chart section. Both ICMP and TCP ping are supported. When using TCP, you can select a specific port to send the packets to.

| Field | What it means |
|---|---|
| **Location** | The probe node sending packets to the target IP |
| **Loss** | Percentage of packets sent with no reply received |
| **Sent** | Total packets fired from that probe |
| **Last** | RTT of the most recent packet |
| **Avg** | Mean RTT across all sent packets |
| **Best** | Lowest RTT recorded, closest to true propagation delay |
| **Worst** | Highest RTT recorded, reveals occasional spikes |
| **StDev** | How consistent the RTTs are. Low means stable, high means jittery |

**Frequently Asked Questions (FAQs)**

**Why is the first ping usually the slowest?**
Before sending the first packet, the probe needs to look up the destination's hardware address (ARP) and domain name (DNS). That lookup only happens once and makes the first ping slower than the rest.

**What does packet loss mean?**
The probe sent a packet but never got a reply back. This can happen because of network congestion, a firewall blocking the packets, the target server ignoring ICMP requests, or a broken link somewhere along the path.

**What does 0.0% loss confirm?**
Every packet sent from that probe reached the target and got a reply, meaning the path between them is working cleanly.

**Why might a geographically closer probe show higher latency?**
Internet traffic does not travel in a straight line between two points. It follows routes decided by BGP, a system that prioritizes network policies and agreements over physical distance, sometimes sending traffic through extra hops that add delay.

**What causes a gap between Best and Worst RTT?**
Occasionally a router along the path gets briefly busy and delays the packet before forwarding it. This creates a one-off spike in RTT without indicating a persistent problem.

**Why is ICMP latency not always representative of real application performance?**
Routers treat ping packets as low priority and handle them through a slower processing path. Regular application traffic like web requests gets handled differently, so ping results do not always reflect what a real user would experience.

**What is congestion?**
When more data is being sent through a link than it can carry at that moment, packets pile up in a queue and wait their turn, which adds to RTT. If the queue gets completely full, the router starts dropping packets, which shows up as loss.

Ping

## Trace

<video width="100%" controls>
  <source 
    src="https://website-cdn.assets.ipinfo.io/images/developers/probenet_live_trace.mp4" 
    type="video/mp4"
  />
  Your browser does not support the video tag.
</video>

Trace measurements use MTR, which combines the functionality of traceroute and ping into a single tool. Unlike a standard traceroute that runs once, MTR sends multiple packets per hop and continuously updates the results. Each hop in the results is enriched with IPinfo IP intelligence data including location and ASN. Each traceroute operation sends 3 packets per hop.

| Field | What it means |
|---|---|
| **Hop** | The sequence number of each router the packet passed through on its way to the target |
| **IP Address** | The address of the router at that hop |
| **Location** | The estimated geographic location of that router |
| **ASN** | The network that owns that router, identified by an Autonomous System Number |
| **Loss** | Percentage of packets that got no reply at that specific hop |
| **Sent** | Number of packets sent to that hop |
| **Last** | RTT of the most recent packet to that hop |
| **Avg** | Mean RTT across all packets to that hop |
| **Best** | Lowest RTT recorded to that hop |
| **Worst** | Highest RTT recorded to that hop |
| **StDev** | Consistency of RTT to that hop. Low means stable, high means variable |

**Frequently Asked Questions (FAQs)**

**Why does a hop show 100% loss even when the destination is reachable?**
That router is configured to silently drop ICMP packets but still forwards your actual traffic normally. The hops after it appear fine because they respond to ICMP even though that middle router does not.

**Why does traffic leave the country to reach a nearby destination?**
Routing follows BGP agreements between networks, not maps. If two networks in the same country do not peer directly with each other, traffic may transit through a third country where they do have a connection.

**Why does RTT jump significantly between two adjacent hops?**
Each hop adds the physical propagation delay of the link connecting them. A large jump usually means those two routers are far apart geographically or connected through a slower link.

**Why would traffic route halfway around the world to reach the destination?**
The source network may only have transit agreements that go through distant hubs. BGP selects routes based on policy and cost, not distance, so a technically longer path can be the only available one.

**What happens when traceroute detects a routing loop?**
The same IP addresses start repeating in consecutive hops, meaning packets are bouncing between two or more routers indefinitely. The packet eventually gets dropped when its TTL reaches zero.

**What happens when the hop limit of 30 is exceeded?**
Traceroute stops and reports that the destination was not reached. This usually means there is a routing loop, a firewall blocking TTL-expired replies beyond a certain point, or an unusually long path.

**What is a `* * *` hop?**
The router at that hop did not send back a TTL-expired reply, so traceroute has no information about it. The router exists and is forwarding traffic, it is just not responding to ICMP.

**Why do private IP addresses like `10.x.x.x` or `192.168.x.x` appear mid-trace?**
Those are internal routers inside a carrier or data center network that are not publicly addressable. They are real hops but their location cannot be looked up because private IPs are not registered to any organization.

**Why does an intermediate hop show loss but all hops after it show 0%?**
That specific router deprioritizes or rate-limits ICMP replies when it is busy, but it still forwards traffic normally. The loss is in the router's reply generation, not in the actual forwarding path.

**Why does traceroute take so long to complete?**
Each unresponsive hop waits for a timeout, typically 1 to 3 seconds, before moving on. With 30 possible hops and multiple timeouts along the way, a trace to an unresponsive destination can take over a minute.

**How does loss work when only 3 packets are sent per hop?**
With 3 packets, loss can only be 0%, 33%, 66%, or 100%. A single dropped packet shows as 33%, which can look alarming but may just be a one-off event rather than a real problem. More packets sent gives a more accurate loss percentage.

**Why does a hop have no ASN information?**
That IP address is not announced in the global BGP routing tables, meaning no network has publicly claimed ownership of it. This is common for internal carrier infrastructure or misconfigured network segments.

**Why does the same ASN appear across multiple consecutive hops?**
Those routers all belong to the same network. Traffic often passes through several routers within a single provider before handing off to the next network.

**Why does the location change between hops within the same ASN?**
Large networks span multiple cities and countries. As your packet moves through that network's internal infrastructure, it physically moves between locations before exiting to the next provider.

Trace

ProbeNet Live

# IPinfo Developer Resource

<div style="position: relative; padding-bottom: 56.25%; height: 0; overflow: hidden; max-width: 100%; margin-bottom: 20px;">
  <iframe style="position: absolute; top: 0; left: 0; width: 100%; height: 100%;" src="https://www.youtube.com/embed/oMwqfJZ8Lfc" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
</div>

The quickest and easiest way to get started with IPinfo is to use one of our [official libraries](/developers/libraries), which are available for many popular programming languages and frameworks. If you'd like to write your own library or interact directly with our API, then the documentation below can help you.

![IPinfo Quickstat](https://website-cdn.assets.ipinfo.io/images/developers/ipinfo_quickstart.png)

## Authentication

<video width="100%" controls>
  <source 
    src="https://website-cdn.assets.ipinfo.io/images/developers/ipinfo_api_auth.mp4" 
    type="video/mp4"
  />
  Your browser does not support the video tag.
</video>

Your API token is used to authenticate you with our API and can be provided either as an HTTP Basic Auth username, a bearer token, or alternatively as a token URL parameter.

<Tabs>
  <Tab title="IPinfo Lite">

[IPinfo Lite](/developers/lite-api) is our free tier API service available to all users. The API returns country and ASN information without any API request quota restrictions.

> IPinfo Lite uses the **`api.ipinfo.io`** API URL and **`/lite`** endpoint.


```bash
# With token query parameter
$ curl https://api.ipinfo.io/lite/me?token=$TOKEN
$ curl https://api.ipinfo.io/lite/8.8.8.8?token=$TOKEN

# With Basic Auth
$ curl -u $TOKEN: https://api.ipinfo.io/lite/me
$ curl -u $TOKEN: https://api.ipinfo.io/lite/8.8.8.8

# With Bearer token
$ curl -H "Authorization: Bearer $TOKEN" https://api.ipinfo.io/lite/me
$ curl -H "Authorization: Bearer $TOKEN" https://api.ipinfo.io/lite/8.8.8.8
```

<details>

<summary>API Response</summary>

```json
{
  "ip": "8.8.8.8",
  "asn": "AS15169",
  "as_name": "Google LLC",
  "as_domain": "google.com",
  "country_code": "US",
  "country": "United States",
  "continent_code": "NA",
  "continent": "North America"
}
```

</details>

  </Tab>

  <Tab title="IPinfo Core">

[IPinfo Core](/developers/core-api) is our entry-level premium API service that combines granular geolocation, ASN data, and network flags.

> IPinfo Core uses the **`api.ipinfo.io`** API URL and **`/lookup`** endpoint.

```bash
# With token query parameter
$ curl https://api.ipinfo.io/lookup/me?token=$TOKEN
$ curl https://api.ipinfo.io/lookup/8.8.8.8?token=$TOKEN

# With Basic Auth
$ curl -u $TOKEN: https://api.ipinfo.io/lookup/me
$ curl -u $TOKEN: https://api.ipinfo.io/lookup/8.8.8.8

# With Bearer token
$ curl -H "Authorization: Bearer $TOKEN" https://api.ipinfo.io/lookup/me
$ curl -H "Authorization: Bearer $TOKEN" https://api.ipinfo.io/lookup/8.8.8.8
```

<details>

<summary>API Response</summary>

```json
{
  "ip": "8.8.8.8",
  "hostname": "dns.google",
  "geo": {
    "city": "Mountain View",
    "region": "California",
    "region_code": "CA",
    "country": "United States",
    "country_code": "US",
    "continent": "North America",
    "continent_code": "NA",
    "latitude": 37.4056,
    "longitude": -122.0775,
    "timezone": "America/Los_Angeles",
    "postal_code": "94043"
  },
  "as": {
    "asn": "AS15169",
    "name": "Google LLC",
    "domain": "google.com",
    "type": "hosting"
  },
  "is_anonymous": false,
  "is_anycast": true,
  "is_hosting": true,
  "is_mobile": false,
  "is_satellite": false
}
```

</details>

  </Tab>

  <Tab title="IPinfo Lookup">

[IPinfo Plus](/developers/plus-api) API service provides granular geolocation information with accuracy radius, mobile carrier details, anonymous IP address data, and network flags.

> IPinfo Plus uses the **`api.ipinfo.io`** API URL and **`/lookup`** endpoint.

```bash
# With token query parameter
$ curl https://api.ipinfo.io/lookup/me?token=$TOKEN
$ curl https://api.ipinfo.io/lookup/8.8.8.8?token=$TOKEN

# With Basic Auth
$ curl -u $TOKEN: https://api.ipinfo.io/lookup/me
$ curl -u $TOKEN: https://api.ipinfo.io/lookup/8.8.8.8

# With Bearer token
$ curl -H "Authorization: Bearer $TOKEN" https://api.ipinfo.io/lookup/me
$ curl -H "Authorization: Bearer $TOKEN" https://api.ipinfo.io/lookup/8.8.8.8
```

<details>

<summary>API Response</summary>

```json
{
  "ip": "8.8.8.8",
  "hostname": "dns.google",
  "geo": {
    "city": "Mountain View",
    "region": "California",
    "region_code": "CA",
    "country": "United States",
    "country_code": "US",
    "continent": "North America",
    "continent_code": "NA",
    "latitude": 38.00881,
    "longitude": -122.11746,
    "timezone": "America/Los_Angeles",
    "postal_code": "94043",
    "dma_code": "807",
    "geoname_id": "5375478",
    "radius": 500
  },
  "as": {
    "asn": "AS15169",
    "name": "Google LLC",
    "domain": "google.com",
    "type": "hosting",
    "last_changed": "2021-05-01"
  },
  "mobile": {},
  "anonymous": {
    "is_proxy": false,
    "is_relay": false,
    "is_tor": false,
    "is_vpn": false
  },
  "is_anonymous": false,
  "is_anycast": true,
  "is_hosting": true,
  "is_mobile": false,
  "is_satellite": false
}
```

</details>

  </Tab>

  <Tab title="IPinfo Max">

[IPinfo Max](/developers/max-api) API service provides granular geolocation information with accuracy radius, mobile carrier details, anonymous IP address data, residential proxy detection, and network flags.

> IPinfo Max uses the **`api.ipinfo.io`** API URL and **`/lookup`** endpoint.

```bash
# With token query parameter
$ curl https://api.ipinfo.io/lookup/me?token=$TOKEN
$ curl https://api.ipinfo.io/lookup/8.8.8.8?token=$TOKEN

# With Basic Auth
$ curl -u $TOKEN: https://api.ipinfo.io/lookup/me
$ curl -u $TOKEN: https://api.ipinfo.io/lookup/8.8.8.8

# With Bearer token
$ curl -H "Authorization: Bearer $TOKEN" https://api.ipinfo.io/lookup/me
$ curl -H "Authorization: Bearer $TOKEN" https://api.ipinfo.io/lookup/8.8.8.8
```

<details>

<summary>API Response</summary>

```json
{
  "ip": "1.0.66.247",
  "hostname": "247.66.0.1.megaegg.ne.jp",
  "geo": {
    "city": "Hiroshima",
    "region": "Hiroshima",
    "region_code": "34",
    "country": "Japan",
    "country_code": "JP",
    "continent": "Asia",
    "continent_code": "AS",
    "latitude": 34.4,
    "longitude": 132.45,
    "timezone": "Asia/Tokyo",
    "postal_code": "730-0011",
    "geoname_id": "1862415",
    "radius": 1000,
    "last_changed": "2023-07-02"
  },
  "as": {
    "asn": "AS18144",
    "name": "Enecom,Inc.",
    "domain": "enecom.co.jp",
    "type": "business",
    "last_changed": "2021-05-01"
  },
  "mobile": {},
  "anonymous": {
    "name": "anyIP",
    "last_seen": "2026-03-30",
    "percent_days_seen": 25,
    "is_proxy": false,
    "is_relay": false,
    "is_tor": false,
    "is_vpn": false,
    "is_res_proxy": true
  },
  "is_anonymous": true,
  "is_anycast": false,
  "is_hosting": false,
  "is_mobile": false,
  "is_satellite": false
}
```

</details>
  </Tab>

  <Tab title="IPinfo Enterprise">

The [IPinfo Enterprise API](/developers/enterprise-api) service is a highly customizable service that may include all different types of IP metadata. This schema can vary for users customized to their needs.

```bash
# With token query parameter
$ curl https://ipinfo.io?token=$TOKEN
$ curl https://ipinfo.io/8.8.8.8?token=$TOKEN

# With Basic Auth
$ curl -u $TOKEN: https://ipinfo.io
$ curl -u $TOKEN: https://ipinfo.io/8.8.8.8

# With Bearer token
$ curl -H "Authorization: Bearer $TOKEN" https://ipinfo.io
$ curl -H "Authorization: Bearer $TOKEN" https://ipinfo.io/8.8.8.8
```

<details>

<summary>API Response</summary>

```json
{
  "ip": "82.102.30.130",
  "city": "Los Angeles",
  "region": "California",
  "country": "US",
  "loc": "34.0522,-118.2437",
  "org": "AS9009 M247 Europe SRL",
  "postal": "90012",
  "timezone": "America/Los_Angeles",
  "asn": {
    "asn": "AS9009",
    "name": "M247 Europe SRL",
    "domain": "m247global.com",
    "route": "82.102.30.0/24",
    "type": "hosting"
  },
  "company": {
    "name": "VENUS BUSINESS COMMUNICATIONS LIMITED",
    "domain": "m247.com",
    "type": "hosting"
  },
  "privacy": {
    "vpn": true,
    "proxy": false,
    "tor": false,
    "relay": false,
    "hosting": true,
    "service": "PrivateVPN",
    "confidence": 3,
    "coverage": 1,
    "census": false,
    "census_ports": "",
    "device_activity": false,
    "inferred": false,
    "vpn_config": false,
    "whois": false,
    "first_seen": "2025-10-14",
    "last_seen": "2026-01-11"
  },
  "abuse": {
    "address": "Turing House, Archway 5, Manchester, M15 5RL, UNITED KINGDOM",
    "country": "GB",
    "email": "network.infrastructure@m247.com",
    "name": "M247 UK Ltd Network Infrastructure",
    "network": "82.102.30.128/25",
    "phone": ""
  },
  "domains": {
    "ip": "82.102.30.130",
    "total": 53,
    "domains": [
      "hdchina.org",
      "ymjump.com",
      "musicool.cn",
      "viewpointcloud.com",
      "itempurl.com"
    ]
  },
  "resproxy": {
    "last_seen": "2026-01-05",
    "percent_days_seen": 13,
    "service": "ProxyScrape"
  },
  "is_anycast": false,
  "is_mobile": false,
  "is_anonymous": true,
  "is_satellite": false,
  "is_hosting": true
}
```

</details>
  </Tab>
</Tabs>

Authentication

## IP Address Parameter

The API supports passing in a single IPv4 or IPv6 IP address. Alternatively, if you do not pass in any IP address, we'll return details for the calling address. This allows you to look up your own (or a visitor to your site) IP address details without knowing the IP address in advance.

### URL Structure

The API follows a consistent URL structure with the following components:

| Component | Description | Examples |
|-----------|-------------|----------|
| **Base URL** | The base domain for all API requests | `api.ipinfo.io` |
| **Endpoint** | The API version endpoint | `lite` (IPinfo Lite)<br>`lookup` (Core/Plus) |
| **IP Address** | The IP to lookup (optional, defaults to requester's IP) | `me` (your IP)<br>`8.8.8.8` (IPv4)<br>`2001:4860:4860::8888` (IPv6) |
| **Field Filter** | Optional filter to return only specific fields (returned as plaintext) | `/country`<br>`/asn`<br>`/country_code`<br>`/is_proxy` |
| **Token** | Your authentication token (query parameter) | `?token=$TOKEN` |

**Example URLs:**

```
https://api.ipinfo.io/lite/me?token=$TOKEN
https://api.ipinfo.io/lookup/8.8.8.8?token=$TOKEN
https://api.ipinfo.io/lite/2001:4860:4860::8888/country?token=$TOKEN
```

<Tabs>
  <Tab title="IPinfo Lite">

```bash
# Get details for 8.8.8.8
$ curl https://api.ipinfo.io/lite/8.8.8.8?token=$TOKEN

# Get details for 2001:4860:4860::8888
$ curl https://api.ipinfo.io/lite/2001:4860:4860::8888?token=$TOKEN

# Get details for your own IP address, which'll be included in the response
$ curl https://api.ipinfo.io/lite/me?token=$TOKEN
```

  </Tab>
  <Tab title="IPinfo Lookup">

```bash
# Get details for 8.8.8.8
$ curl https://api.ipinfo.io/lookup/8.8.8.8?token=$TOKEN

# Get details for 2001:4860:4860::8888
$ curl https://api.ipinfo.io/lookup/2001:4860:4860::8888?token=$TOKEN

# Get details for your own IP address, which'll be included in the response
$ curl https://api.ipinfo.io/lookup/me?token=$TOKEN
```

  </Tab>
  <Tab title="IPinfo Legacy">

```bash
# Get details for 8.8.8.8
$ curl https://ipinfo.io/8.8.8.8?token=$TOKEN

# Get details for 2001:4860:4860::8888
$ curl https://ipinfo.io/2001:4860:4860::8888?token=$TOKEN

# Get details for your own IP address, which'll be included in the response
$ curl https://ipinfo.io?token=$TOKEN
```

  </Tab>
</Tabs>

> Our API is available over a secure HTTPS connection for all users. Simply add `https://` to the request URLs to make the requests secure.

IP Address Parameter

## Rate Limits

IPinfo Lite offers unlimited access to our API. Paid plans include monthly request limits with configurable alerts to help you stay in control. If you exceed your plan’s limit, you’ll receive a 429 HTTP status code—but with metered billing, you can automatically extend your usage without interruptions.

[Paid plans](/pricing) come with higher monthly limits, and configurable alerts.

Rate Limits

## Filtering Responses

<video width="100%" controls>
  <source 
    src="https://website-cdn.assets.ipinfo.io/images/developers/api_filtering_response.mp4" 
    type="video/mp4"
  />
  Your browser does not support the video tag.
</video>

You can filter the API response down to specific fields or objects by adding the field or object name to the URL. In the case of a field you'll get it returned in plaintext, and an object will get returned as JSON.

<Tabs>
  <Tab title="IPinfo Lite">

```bash
# Get the ASN
$ curl https://api.ipinfo.io/lite/8.8.8.8/asn?token=$TOKEN
AS15169

# Get country ISO code as plaintext
$ curl https://api.ipinfo.io/lite/8.8.8.8/country_code?token=$TOKEN
US
```

  </Tab>
  <Tab title="IPinfo Lookup">

```bash

Filtering Responses

## Get all the Geolocation data as a JSON object
$ curl https://api.ipinfo.io/lookup/8.8.8.8/geo?token=$TOKEN

Get all the Geolocation data as a JSON object

## Get the city name as a string
$ curl https://api.ipinfo.io/lookup/8.8.8.8/geo/city?token=$TOKEN

Get the city name as a string

## Get the ASN data as a JSON object
$ curl https://api.ipinfo.io/lookup/8.8.8.8/as?token=$TOKEN

Get the ASN data as a JSON object

## Get the ASN as a string
$ curl https://api.ipinfo.io/lookup/8.8.8.8/as/asn?token=$TOKEN

Get the ASN as a string

## Get network flag data as a string
$ curl https://api.ipinfo.io/lookup/8.8.8.8/is_anonymous?token=$TOKEN
$ curl https://api.ipinfo.io/lookup/8.8.8.8/is_satellite?token=$TOKEN
```

  </Tab>
  <Tab title="IPinfo Enterprise">

```bash
# Get the organization field
$ curl https://ipinfo.io/8.8.8.8/org?token=$TOKEN
AS15169 Google Inc.

# Get just the city as plaintext
$ curl https://ipinfo.io/8.8.8.8/city?token=$TOKEN
Mountain View

# Get country ISO code as plaintext
$ curl https://ipinfo.io/8.8.8.8/country?token=$TOKEN
US
```

  </Tab>
</Tabs>

Dual Stack API Service

## JSONP/CORS Requests

JSONP and CORS are supported, allowing you to use ipinfo.io entirely in client-side code. For JSONP you just need to specify the callback parameter, e.g. `http://ipinfo.io/?callback=callback&token=$TOKEN`.

<Tabs>
  <Tab title="Fetch API (Promise)">

```javascript
fetch("https://api.ipinfo.io/lite/me?token=$TOKEN")
  .then((response) => response.json())
  .then((jsonResponse) => console.log(jsonResponse.ip, jsonResponse.country));
```

  </Tab>
  <Tab title="Fetch API (Async/Await)">

```javascript
const request = await fetch("https://api.ipinfo.io/lite/me?token=$TOKEN");
const jsonResponse = await request.json();

console.log(jsonResponse.ip, jsonResponse.country);
```

  </Tab>
  <Tab title="JSONP">

```html
<script>
  function recordData(data) {
    console.log(data.ip, data.country);
  }
</script>
<script src="https://ipinfo.io/json?callback=recordData"></script>
```

  </Tab>
</Tabs>

JSONP/CORS Requests

Getting Started

IPinfo Lite API

IPinfo Core API

IPinfo Plus API

IPinfo Max API

IPinfo Places API

IPinfo Business API

IPinfo Enterprise API

Residential Proxy API

Privacy Extended API

ASN API

IP Ranges API

Hosted Domains API

IP Whois API

# IPinfo Lite API

**Available for**: Every IPinfo user

The [IPinfo Lite API](/lite) is our free-tier API access plan, which includes unlimited country-level geolocation information and unlimited basic ASN information. Geolocation information provided by the IPinfo Lite API service includes country and continent information, while ASN information includes ASN, organization name, and domain name.

The API has no daily or monthly limit and provides unlimited access. The API is based on our IPinfo Lite IP database.

> You can access IPinfo Lite data as a downloadable dataset as well: **[IPinfo Lite IP Data Downloads](/developers/ipinfo-lite-database)**

# IPinfo Core API

The [IPinfo Core API](/core) is our entry-level premium API access plan, which includes granular [geolocation information](/developers/data-types#geolocation-data), ASN information, network flags, and access to the [dedicated ASN API](/developers/asn).

- **Geolocation information**: City, Region/State, Country, Postal code etc.
- **ASN information**: ASN (Autonomous System Number), AS Name, ASN Domain and ASN Type
- **Network flags**: Anonymous IP address (VPN, proxy, Tor, or relay), Hosting IP address (data center or server IP), Anycast IP, Carrier mobile IP flag, and Satellite IP address

> IPinfo Core data is also available as a downloadable database for enterprise customers. Database downloads are not included in self-serve API plans and require a separate enterprise subscription. Learn more: **[IPinfo Core IP Data Downloads](/developers/ipinfo-core-database)**

# IPinfo Plus API

The [IPinfo Plus](/plus) API is our most popular API service that provides detailed IP address data, including geolocation, ASN information, mobile carrier details, privacy-related flags and access to the [dedicated ASN API](/developers/asn).

- **Geolocation information**: City, Region/State, Country, Postal code etc. and accuracy radius and last change date.
- **ASN information**: ASN (Autonomous System Number), AS Name, ASN Domain, ASN Type and last change date
- **Anonymous IP address**: Identifies whether an IP address is associated with privacy services such as VPNs, proxies, Tor nodes, or relay services.
- **Carrier information**: Provides details about the mobile carrier, including the carrier name, Mobile Country Code (MCC), and Mobile Network Code (MNC).
- **Network flags**: Anonymous IP address (VPN, proxy, Tor, or relay), Hosting IP address (data center or server IP), Anycast IP, Carrier mobile IP flag, and Satellite IP address

> IPinfo Plus data is also available as a downloadable database for enterprise customers. Database downloads are not included in self-serve API plans and require a separate enterprise subscription. Learn more: **[IPinfo Plus IP Data Downloads](/developers/ipinfo-plus-database)**

# IPinfo Max API

The [IPinfo Max](/pricing) API is our most comprehensive API service, building on all IPinfo Plus features with full anonymization coverage including residential proxy behavioral signals.

- **Geolocation information**: City, Region/State, Country, Postal code etc. and accuracy radius and last change date.
- **ASN information**: ASN (Autonomous System Number), AS Name, ASN Domain, ASN Type and last change date
- **Anonymous IP address**: Identifies whether an IP address is associated with privacy services such as VPNs, proxies, Tor nodes, relay services.
- **Residential Proxy detection**: Residential proxy information as well as time-bound behavioral activity and frequency metadata.
- **Carrier information**: Provides details about the mobile carrier, including the carrier name, Mobile Country Code (MCC), and Mobile Network Code (MNC).
- **Network flags**: Anonymous IP address (VPN, proxy, Tor, or relay), Hosting IP address (data center or server IP), Anycast IP, Carrier mobile IP flag, and Satellite IP address

# IPinfo Places API

The **[IPinfo Places](/data/places)** API identifies the real-world location associated with an IP address at the building level. It matches IP addresses observed on venue Wi-Fi networks to verified physical places such as hotels, airports, museums, stadiums, transit stations, and 30+ other categories.

- **Place name**: The name of the venue or building associated with the IP address. This information can be used to identify the brand of the business as well.
- **Location category**: One of 30+ standardized location tags (e.g., `hotel`, `museum`, `airport`).
- **Network SSID**: The Wi-Fi network name observed at the venue.
- **Coordinates**: The building-level latitude and longitude of the matched place.

> **IPinfo Places is currently in public beta.** Access is available via API. Additional fields and data (including brand, building dimensions, polygon boundaries, BSSIDs, and last-seen date) are available for select use cases.
> 
> [Request access](/data/places#form) to learn more.

# IPinfo Business

> The Business API is no longer available for new customers. Existing customers retain full access.

Our IPinfo Business plan includes access to multiple data fields besides ASN and geolocation, including `privacy`, `abuse`, `company`, `carrier` and limited `domains` hosted on the IP. 

```bash
curl  https://ipinfo.io/8.8.8.8/json?token=$TOKEN
```

```json
{
  "ip": "8.8.8.8",
  "hostname": "dns.google",
  "anycast": true,
  "city": "Mountain View",
  "region": "California",
  "country": "US",
  "loc": "37.4056,-122.0775",
  "postal": "94043",
  "timezone": "America/Los_Angeles",
  "asn": {
    "asn": "AS15169",
    "name": "Google LLC",
    "domain": "google.com",
    "route": "8.8.8.0/24",
    "type": "hosting"
  },
  "company": {
    "name": "Google LLC",
    "domain": "google.com",
    "type": "hosting"
  },
  "privacy": {
    "vpn": false,
    "proxy": false,
    "tor": false,
    "relay": false,
    "hosting": true,
    "service": ""
  },
  "abuse": {
    "address": "US, CA, Mountain View, 1600 Amphitheatre Parkway, 94043",
    "country": "US",
    "email": "network-abuse@google.com",
    "name": "Abuse",
    "network": "8.8.8.0/24",
    "phone": "+1-650-253-0000"
  },
  "domains": {
    "ip": "8.8.8.8",
    "total": 9791,
    "domains": [
      "musicool.cn",
      "kagou.vip",
      "nmgk2.com",
      "91xiazai.com",
      "bits-hyderabad.ac.in"
    ]
  }
}
```

You can also query domains data separately. Check [how you can find domains hosted on IP](/developers/hosted-domains) using [Hosted Domains API](/data/hosted-domains).

```bash
curl https://ipinfo.io/domains/8.8.8.8?token=$TOKEN
```

```json
{
  "ip": "8.8.8.8",
  "total": 11606,
  "domains": [
    "41.cn",
    "onionflix.cc",
    "newmax.info",
    "ftempurl.com",
    "itempurl.com"
  ]
}
```

# Enterprise API

The Enterprise API is a custom solution where customers select specific API services and a request quota tailored to their needs. Rather than a fixed package, it allows you to build a custom API response by combining the services you require.

The following API services are available through the Enterprise plan:

- [IP Geolocation](/developers/ip-geolocation-api-data)
- [IP to ASN](/developers/ip-asn-api-data)
- [ASN API](/developers/asn)
- [IP to Company](/developers/data-types#company-data)
- [Privacy Detection API](/developers/ip-privacy-detection-api-data)
- [IP to Residential Proxy Detection](/developers/residential-proxy-api)
- [Extended Privacy Detection API](/developers/privacy-extended-api)
- [Carrier Detection (Mobile IP Data) API](/developers/ip-carrier-api-data)
- [Abuse Contact API](/developers/data-types#abuse-contact-data)
- [IP WHOIS](/developers/whois)
- [IP Ranges](/developers/ranges)
- [Hosted Domains API](/developers/hosted-domains)
- Our Standard off the shelf API service: [IPinfo Max](/developers/max-api), [IPinfo Plus](/developers/plus-api) or, [IPinfo Core](/developers/core-api)

Some of these services, such as IP WHOIS, IP to Company, Abuse Contact API, IP Ranges, and Full Hosted Domains, are only available through the Enterprise plan.

> **Note:** The Enterprise API does not automatically include all of the services listed above. You choose only the services and request quota that match your needs.

---

# Residential Proxy Detection API

The IPinfo Residential Proxy Detection API provides detailed insights into IP addresses associated with residential, mobile, or datacenter proxy networks, including activity patterns, and service identification.

> You can access IPinfo IP to Residential Proxy Detection data as a downloadable dataset as well: **[IPinfo Residential Proxy Data Downloads](/developers/ip-to-residential-proxy)**

# Privacy Detection API (Extended)

The IPinfo IP to Privacy Detection (Extended) API service provides detection methodology related metadata to support risk scoring, confidence metrics, and IP reputation aspects behind each IP address that IPinfo detects to be anonymous.

IPinfo uses multi-modal detection methods to detect anonymous IP addresses, which includes internet measurement, IP address behavior and characteristics, internet records metadata, etc. This multi-data detection method makes for a robust detection process and can be used to fine-tune fraud detection models based on the risk models of companies.

> You can access IPinfo Anonymous IP Detection (Extended) data as a downloadable dataset as well: **[Privacy Detection Extended Data Downloads](/developers/privacy-detection-extended)**

# ASN API

**Available in**: IPinfo Core, IPinfo Plus, and IPinfo Enterprise

ASN API allows you to programmatically access details about an ASN, such as the assigned prefixes, related domain, and more. The ASN API is available at `/ASXX/json`.

# IP Ranges

**Available in**: IPinfo Enterprise

Our [IP address ranges API](/products/ranges-api) returns a list of all of the IP addresses ranges assigned to or operated by a company, identified by the provided domain name.

```bash
curl https://ipinfo.io/ranges/nytimes.com?token=$TOKEN
```

```json
{
  "domain": "nytimes.com",
  "redirects_to": null,
  "num_ranges": 24,
  "ranges": [
    "80.4.179.80/28",
    "97.67.74.80/29",
    "2a00:2381:2ebf::/56",
    "194.73.217.40/29",
    "2a00:2381:2ebf:100::/56",
    ...
  ]
}
```

Even though the foundational data of the IP ranges API is based on the [IP to Company Database](/data/ip-company), the API accepts domain inputs that ultimately resolve to an organization's domain. The target domain that the input domain redirects to is mentioned in the `redirects_to` key.

```bash
curl https://ipinfo.io/ranges/times.com?token=$TOKEN
```

```json
{
  "domain": "times.com",
  "redirects_to": "nytimes.com",
  "num_ranges": 24,
  "ranges": [
    "80.4.179.80/28",
    "97.67.74.80/29",
    "2a00:2381:2ebf::/56",
    "194.73.217.40/29",
    "2a00:2381:2ebf:100::/56",
    ...
  ]
}
```

# Hosted Domains API

**Available in**: IPinfo Enterprise

Our Hosted Domains, or [Reverse IP API](/data/hosted-domains) returns a list of all of the domains hosted on the provided IP address. IPinfo Enterprise plan users receive up to 1,000 domains per API request.

```bash
curl "ipinfo.io/domains/198.35.26.96?token=$TOKEN"
```

```json
{
  "ip": "198.35.26.96",
  "total": 16596,
  "domains": [
    "wikipedia.org",
    "wikimedia.org",
    "wiktionary.org",
    "wikisource.org",
    "wikibooks.org"
    ...
  ]
}
```

# IP Whois API

**Available in**: IPinfo Enterprise

IP Whois API allows you to programmatically access Whois data by IP, ID or domain. The API is available at `/whois`.

The `page` query parameter can be used to go through paginated records. `page` starts at 0 and the parameter is part of the response when included in the request. The API returns up to 50 records per page.

IPinfo APIs

IP ASN API Data

Mobile IP API Data

IP Geolocation API Data

Privacy Detection API Data

# IP Data Types

When you make a request to IPinfo using a token, the API returns all the data the token has access to for the target IP address.

> Please note that:
> 
> - `https://api.ipinfo.io` is used for updated API tiers: [IPinfo Lite](/developers/lite-api), [IPinfo Core](/developers/core-api) and [IPinfo Plus](/developers/plus-api).
> - `https://ipinfo.io` is used for [IPinfo Enterprise](/developers/enterprise-api).

## Geolocation Data

IPinfo's IP geolocation data is available through multiple API services, from free to enterprise. Each tier offers varying levels of granularity from country and continent up to city, postal code, coordinates, and accuracy metadata.

Learn more: [IPinfo API - IP Geolocation Data](/developers/ip-geolocation-api-data)

Geolocation Data

## Privacy Detection Data

IPinfo's privacy detection data identifies whether an IP address is associated with anonymization services such as VPNs, proxies, Tor, or relays. It is available across Core, Plus, and Enterprise API plans, with each tier offering increasing levels of detail.

Learn about them here: [IPinfo API - IP Privacy Detection Data](/developers/ip-privacy-detection-api-data)

Privacy Detection Data

## ASN Data

IPinfo's ASN data provides information about the Autonomous System associated with an IP address, including the ASN number, organization name, domain, and type. It is available across Lite, Core, Plus, and Enterprise API plans, with each tier offering additional fields such as route/prefix information and record change history.

Learn about them here: [IPinfo API - IP ASN Data](/developers/ip-asn-api-data)

ASN Data

## Carrier Data

IPinfo's carrier data identifies the mobile network associated with an IP address, including the carrier name and its Mobile Country Code (MCC) and Mobile Network Code (MNC). It is available across Core, Plus, and Enterprise API plans, where Core returns a basic mobile flag and the higher tiers return the full carrier details.

Learn about them here: [IPinfo API - Carrier or Mobile IP Data](/developers/ip-carrier-api-data)

Carrier Data

## Company Data

**Available in**: [IPinfo Enterprise](/developers/enterprise-api)

[Company Data](/data/ip-company) identifies the `name` of the organization behind the IP, the `type` of business, and its `domain` . We source this information from various publicly available datasets. 

```bash
curl https://ipinfo.io/8.8.8.8?token=$TOKEN
```

```json
{
  ...
  "company": {
    "name": "Google LLC",
    "domain": "google.com",
    "type": "business"
  }
}
```

> **Note**: The ability of IPinfo to tell the company depends on the size of the company and how it runs its network. 
>
> Suppose, WeWork NYC has rented its space to a startup. If someone from that startups visits your website, we might not be able to identify the company since it's small and uses its building's network. We will, however, be able to tell you that it's from WeWork.

Company Data

## Hosted Domains Data

**Available in**: [IPinfo Enterprise](/developers/enterprise-api)

[Hosted Domains Data](/data/hosted-domains) returns the `total` count of domains being hosted on the IP address and a list of domains.

```bash
curl https://ipinfo.io/66.87.125.72?token=$TOKEN
```

```json
{
  ...
  "domains": {
    "ip": "8.8.8.8",
    "total": 11606,
    "domains": [
      "41.cn",
      "onionflix.cc",
      "newmax.info",
      "ftempurl.com",
      "itempurl.com"
    ]
  }
}
```

The number of domains returned per API request depends on the user's pricing tier:

- [IPinfo Enterprise](/developers/enterprise-api) tier: Up to 1,000 domains are returned per API request.
- Hosted Domains database download: Up to 1,000 domains are available per IP address entry.

[IPinfo Enterprise](/developers/enterprise-api) users have access to a total of 1,000 domain names. The documentation and API parameters for the Hosted Domains endpoint are available in the [Hosted Domains API documentation section](/developers/hosted-domains).

Hosted Domains Data

## Abuse Contact Data

**Available in**: [IPinfo Enterprise](/developers/enterprise-api)

[Abuse Contact Data](/data/ip-abuse-contact) is contact information (usually of the network administrator) which can be used to report IP addresses that are engaged in fraudulent/malicious activites. 

```bash
curl https://ipinfo.io/1.1.1.1?token=$TOKEN
```

```json
{
  ...
  "abuse": {
    "address": "PO Box 3646, South Brisbane, QLD 4101, Australia",
    "country": "AU",
    "email": "abuse@apnic.net",
    "name": "APNIC RESEARCH",
    "network": "1.1.1.0/24",
    "phone": "+61-7-3858-3188"
  }
}
```

Abuse Contact Data

## IP Type Data

**Available in**: [IPinfo Lite](/developers/lite-api), [IPinfo Core](/developers/core-api), [IPinfo Plus](/developers/plus-api), and [IPinfo Enterprise](/developers/enterprise-api).

If the IP address is an [anycast](https://support.ipinfo.io/hc/en-us/articles/30792495607442-What-is-Anycast-IP-address) or a [bogon](https://support.ipinfo.io/hc/en-us/articles/30792495147794-What-is-a-bogon-IP-address), the API returns a field indicating that.

**Bogon Address Information**

```bash
curl https://ipinfo.io/127.0.0.1?token=$TOKEN
```

```json
{
  "ip": "127.0.0.1",
  "bogon": true
}
```

**Anycast Information**

```bash
curl https://ipinfo.io/8.8.8.8?token=$TOKEN
```

```json
{
  "ip": "8.8.8.8",
  "hostname": "dns.google",
  "anycast": true,
  "city": "Mountain View",
  //...
}
```

IP Type Data

# IP ASN API Data

**Available in**: [IPinfo Lite](/developers/lite-api) (Limited), [IPinfo Core](/developers/core-api), [IPinfo Plus](/developers/plus-api), and [IPinfo Enterprise](/developers/enterprise-api)

Along with detailed ASN information, the [paid API tiers](/pricing) provide access to the dedicated [ASN API service](/data/ip-asn), which returns information related to the ASN (Autonomous System Number) of the current or queried IP.

- In the [IPinfo Lite](/developers/lite-api) plan, the API will return the ASN, AS Organization name, and AS Domain name.
- In the [IPinfo Core](/developers/core-api) and [IPinfo Plus](/developers/plus-api) API tiers, you will have access to the ASN, AS Organization name, AS Domain name, and AS type. IPinfo Plus additionally includes the date the ASN record was last changed. This also includes access to the [ASN API service](/developers/asn) (ASN → ASN Information).
- In the [IPinfo Enterprise](/developers/enterprise-api) API services, you will have the ASN, AS Organization name, AS Domain name, AS type, and AS route/prefix information for the queried IP address. This also includes access to the [ASN API service](/developers/asn) for ASN Information.

# Carrier or Mobile IP API Data

**Available in**: [IPinfo Core](/developers/core-api) (Partial), [IPinfo Plus](/developers/plus-api), and [IPinfo Enterprise](/developers/enterprise-api)

[Carrier Data](/data/ip-carrier) returns mobile or carrier-related information for the IP address.

- In limited capability, [IPinfo Core](/developers/core-api) also contains IP to carrier information, flagging carrier IP addresses.
- The full IP to Carrier response is available across [IPinfo Plus](/developers/plus-api) and [IPinfo Enterprise](/developers/enterprise-api), which include the mobile carrier's name, its Mobile Country Code (MCC), and Mobile Network Code (MNC).

# IP Geolocation API Data

**Available in**: IPinfo Lite (Limited), IPinfo Core, IPinfo Plus, and IPinfo Enterprise

- Country-level geolocation data is offered in the IPinfo Lite API.
- The full IP geolocation response is available across all our paid plans.
- The IPinfo Plus API service comes with accuracy radius and geolocation stability fields.

# IP to Privacy Detection API Data

**Available in**: IPinfo Core (Limited), IPinfo Plus, IPinfo IP to Privacy Detection API (Enterprise), and IPinfo IP to Privacy Detection Extended API (Enterprise)

- The IPinfo Core API returns only limited information via IP flags for detecting non-residential IP addresses.
- The IPinfo Plus API returns a summary anonymous IP detection response via the `/anonymous` endpoint, while in the enterprise plan it is returned via the `/privacy` endpoint.
- The IPinfo IP to Privacy Detection Extended API includes additional confidence, coverage, and signal fields.

Data Types

# Batch Enrichment API

![IPinfo bulk image header](https://website-cdn.assets.ipinfo.io/images/developers/ipinfo_bulk_header_docs.png)

Our `/batch` API endpoint allows you to group up to 1,000 IPinfo API requests into a single request. This can significantly speed up the processing of bulk IP lookups, and it is also useful if you want to look up information across our different APIs.

## Endpoints

The `/batch` API endpoint is available in both the legacy (`ipinfo.io`) and updated (`api.ipinfo.io`) API services.

For the updated API system the batch API endpoint is available at:

```
api.ipinfo.io/batch
```

The default API endpoint (`api.ipinfo.io/batch`) inherently supports the `/lookup` endpoint to query IP addresses, meaning that you do not have to prefix your IP address with `/lookup`. If you want to use `lite`, `resproxy`, or another API endpoint, please use the URL patterns method described in the next section.

**`api.ipinfo.io/batch/lite`** - Explicitly for the `lite` API endpoint. When using this API endpoint, you do not need to prefix `lite/` to IP addresses. Lite calls can be added to the legacy API `ipinfo.io/batch` requests as well. Please note that the `/lookup` API is dedicated to our paid tier API service. Therefore, if you are on the free tier and use the default bulk API endpoint (`api.ipinfo.io/batch`), you will encounter an error. For this reason, we recommend our free tier users use: `api.ipinfo.io/batch/lite`.

The Bulk or Batch API works identically with the legacy API endpoint (`ipinfo.io`) at the following API endpoint:

```
https://ipinfo.io/batch?token=$TOKEN
```

Endpoints

## URL Patterns

We provide different types of IP data services through various API endpoints like `lite`, general IP information lookup (`lookup`), `resproxy`, etc. Additionally, users may not need the full API response payload; they might only need specific information from the API response, such as `/country`, `/city`, `asn`, etc. To support a diverse set of inputs and outputs, our batch API endpoint supports URL patterns.


```txt
115.227.65.62
lookup/71.181.13.80
lite/157.47.66.225
lookup/74.75.228.56/anonymous
lite/23.1.118.150/country_code
resproxy/164.53.56.110
```

URL Patterns

## Request Formats

![IPinfo bulk image usage example](https://website-cdn.assets.ipinfo.io/images/developers/ipinfo_bulk_demo_docs.gif)

The `/batch` endpoint accepts a list of IPs or URL patterns and returns a JSON object with the inputs as keys and the responses as values. The list of IPs can be provided as a newline-separated list of URLs, a space-separated list, or as a JSON array object. Below are examples of each approach, as well as the corresponding content-type headers required.


### JSON Array

```bash
curl -XPOST --data '["lite/8.8.4.4", "lite/8.8.4.4/country", "8.8.4.4/anonymous", "1.1.1.1"]' \
"api.ipinfo.io/batch?token=$TOKEN"
```


```json
{
  "lite/8.8.4.4/country": "United States",
  "lite/8.8.4.4": {
    "ip": "8.8.4.4",
    "asn": "AS15169",
    "as_name": "Google LLC",
    "as_domain": "google.com",
    "country_code": "US",
    "country": "United States",
    "continent_code": "NA",
    "continent": "North America"
  },
  "8.8.4.4/anonymous": {
    "is_proxy": false,
    "is_relay": false,
    "is_tor": false,
    "is_vpn": false
  },
  "1.1.1.1": {
    "ip": "1.1.1.1",
    "hostname": "one.one.one.one",
    "geo": {
      "city": "Brisbane",
      "region": "Queensland",
      "region_code": "QLD",
      "country": "Australia",
      "country_code": "AU",
      "continent": "Oceania",
      "continent_code": "OC",
      "latitude": -27.48159,
      "longitude": 153.0175,
      "timezone": "Australia/Brisbane",
      "postal_code": "4101",
      "geoname_id": "2174003",
      "radius": 10,
      "last_changed": "2024-10-20"
    },
    "as": {
      "asn": "AS13335",
      "name": "Cloudflare, Inc.",
      "domain": "cloudflare.com",
      "type": "hosting",
      "last_changed": "2025-03-09"
    },
    "mobile": {},
    "anonymous": {
      "is_proxy": false,
      "is_relay": false,
      "is_tor": false,
      "is_vpn": false
    },
    "is_anonymous": false,
    "is_anycast": true,
    "is_hosting": true,
    "is_mobile": false,
    "is_satellite": false
  }
}
```


### Newline-Separated List

```bash
echo -e "lite/8.8.4.4\nlite/8.8.4.4/country\n8.8.4.4/anonymous\n1.1.1.1" | \
curl -X POST \
--data-binary @- "https://api.ipinfo.io/batch?token=$TOKEN"
```

```json
{
  "lite/8.8.4.4/country": "United States",
  "lite/8.8.4.4": {
    "ip": "8.8.4.4",
    "asn": "AS15169",
    "as_name": "Google LLC",
    "as_domain": "google.com",
    "country_code": "US",
    "country": "United States",
    "continent_code": "NA",
    "continent": "North America"
  },
  "1.1.1.1": {
    "ip": "1.1.1.1",
    "hostname": "one.one.one.one",
    "geo": {
      "city": "Brisbane",
      "region": "Queensland",
      "region_code": "QLD",
      "country": "Australia",
      "country_code": "AU",
      "continent": "Oceania",
      "continent_code": "OC",
      "latitude": -27.48159,
      "longitude": 153.0175,
      "timezone": "Australia/Brisbane",
      "postal_code": "4101",
      "geoname_id": "2174003",
      "radius": 10,
      "last_changed": "2024-10-20"
    },
    "as": {
      "asn": "AS13335",
      "name": "Cloudflare, Inc.",
      "domain": "cloudflare.com",
      "type": "hosting",
      "last_changed": "2025-03-09"
    },
    "mobile": {},
    "anonymous": {
      "is_proxy": false,
      "is_relay": false,
      "is_tor": false,
      "is_vpn": false
    },
    "is_anonymous": false,
    "is_anycast": true,
    "is_hosting": true,
    "is_mobile": false,
    "is_satellite": false
  },
  "8.8.4.4/anonymous": {
    "is_proxy": false,
    "is_relay": false,
    "is_tor": false,
    "is_vpn": false
  }
}
```

### Space-Separated List

```bash
curl --request POST --url https://api.ipinfo.io/batch?token=$TOKEN \
--header 'Content-Type: text/plain' \
--data 'lite/8.8.4.4 lite/8.8.4.4/country 8.8.4.4/anonymous 1.1.1.1'
```

```json
{
  "lite/8.8.4.4": {
    "ip": "8.8.4.4",
    "asn": "AS15169",
    "as_name": "Google LLC",
    "as_domain": "google.com",
    "country_code": "US",
    "country": "United States",
    "continent_code": "NA",
    "continent": "North America"
  },
  "8.8.4.4/anonymous": {
    "is_proxy": false,
    "is_relay": false,
    "is_tor": false,
    "is_vpn": false
  },
  "1.1.1.1": {
    "ip": "1.1.1.1",
    "hostname": "one.one.one.one",
    "geo": {
      "city": "Brisbane",
      "region": "Queensland",
      "region_code": "QLD",
      "country": "Australia",
      "country_code": "AU",
      "continent": "Oceania",
      "continent_code": "OC",
      "latitude": -27.48159,
      "longitude": 153.0175,
      "timezone": "Australia/Brisbane",
      "postal_code": "4101",
      "geoname_id": "2174003",
      "radius": 10,
      "last_changed": "2024-10-20"
    },
    "as": {
      "asn": "AS13335",
      "name": "Cloudflare, Inc.",
      "domain": "cloudflare.com",
      "type": "hosting",
      "last_changed": "2025-03-09"
    },
    "mobile": {},
    "anonymous": {
      "is_proxy": false,
      "is_relay": false,
      "is_tor": false,
      "is_vpn": false
    },
    "is_anonymous": false,
    "is_anycast": true,
    "is_hosting": true,
    "is_mobile": false,
    "is_satellite": false
  },
  "lite/8.8.4.4/country": "United States"
}
```

### IP List from File

```bash
$ cat ips.txt
58.155.106.199
102.158.180.80
76.185.163.245
```

```
cat ips.txt | curl -XPOST --data-binary @- https://api.ipinfo.io/batch?token=$TOKEN
```

```json
{
  "58.155.106.199": {
    "ip": "58.155.106.199",
    "geo": {
      "city": "Haidian",
      "region": "Beijing",
      "region_code": "BJ",
      "country": "China",
      "country_code": "CN",
      "continent": "Asia",
      "continent_code": "AS",
      "latitude": 39.99064,
      "longitude": 116.28868,
      "timezone": "Asia/Shanghai",
      "postal_code": "100000",
      "geoname_id": "1809104",
      "radius": 100,
      "last_changed": "2025-08-03"
    },
    "as": {
      "asn": "AS4538",
      "name": "China Education and Research Network Center",
      "domain": "cernet.edu.cn",
      "type": "education",
      "last_changed": "2025-03-09"
    },
    "mobile": {},
    "anonymous": {
      "is_proxy": false,
      "is_relay": false,
      "is_tor": false,
      "is_vpn": false
    },
    "is_anonymous": false,
    "is_anycast": false,
    "is_hosting": false,
    "is_mobile": false,
    "is_satellite": false
  },
  "102.158.180.80": {
    "ip": "102.158.180.80",
    "geo": {
      "city": "Tunis",
      "region": "Tunis Governorate",
      "region_code": "11",
      "country": "Tunisia",
      "country_code": "TN",
      "continent": "Africa",
      "continent_code": "AF",
      "latitude": 36.81897,
      "longitude": 10.16579,
      "timezone": "Africa/Tunis",
      "geoname_id": "2464470",
      "radius": 50
    },
    "as": {
      "asn": "AS37705",
      "name": "TOPNET",
      "domain": "topnet.tn",
      "type": "isp",
      "last_changed": "2025-03-09"
    },
    "mobile": {},
    "anonymous": {
      "is_proxy": false,
      "is_relay": false,
      "is_tor": false,
      "is_vpn": false
    },
    "is_anonymous": false,
    "is_anycast": false,
    "is_hosting": false,
    "is_mobile": false,
    "is_satellite": false
  },
  "76.185.163.245": {
    "ip": "76.185.163.245",
    "hostname": "syn-076-185-163-245.res.spectrum.com",
    "geo": {
      "city": "San Antonio",
      "region": "Texas",
      "region_code": "TX",
      "country": "United States",
      "country_code": "US",
      "continent": "North America",
      "continent_code": "NA",
      "latitude": 29.4275,
      "longitude": -98.4601,
      "timezone": "America/Chicago",
      "postal_code": "78202",
      "dma_code": "641",
      "geoname_id": "4726206",
      "radius": 10
    },
    "as": {
      "asn": "AS11427",
      "name": "Charter Communications Inc",
      "domain": "charter.com",
      "type": "isp",
      "last_changed": "2025-03-09"
    },
    "mobile": {},
    "anonymous": {
      "is_proxy": false,
      "is_relay": false,
      "is_tor": false,
      "is_vpn": false
    },
    "is_anonymous": false,
    "is_anycast": false,
    "is_hosting": false,
    "is_mobile": false,
    "is_satellite": false
  }
}
```

Request Formats

## Lite Endpoint Option

You can also use the Lite API-based batch enrichment for all these applications.

```bash
cat ips.txt | curl -XPOST --data-binary @- https://api.ipinfo.io/batch/lite?token=$TOKEN
```

```json
{
  "76.185.163.245": {
    "ip": "76.185.163.245",
    "asn": "AS11427",
    "as_name": "Charter Communications Inc",
    "as_domain": "charter.com",
    "country_code": "US",
    "country": "United States",
    "continent_code": "NA",
    "continent": "North America"
  },
  "102.158.180.80": {
    "ip": "102.158.180.80",
    "asn": "AS37705",
    "as_name": "TOPNET",
    "as_domain": "topnet.tn",
    "country_code": "TN",
    "country": "Tunisia",
    "continent_code": "AF",
    "continent": "Africa"
  },
  "58.155.106.199": {
    "ip": "58.155.106.199",
    "asn": "AS4538",
    "as_name": "China Education and Research Network Center",
    "as_domain": "cernet.edu.cn",
    "country_code": "CN",
    "country": "China",
    "continent_code": "AS",
    "continent": "Asia"
  }
}
```


**URL Patterns**
```
$ cat ip_urls.txt
8.8.4.4/anonymous
1.1.1.1
lite/8.8.4.4
lite/8.8.4.4/country
```

```bash
cat ip_urls.txt | curl -XPOST --data-binary @- https://api.ipinfo.io/batch?token=$TOKEN
```

```json
{
  "1.1.1.1": {
    "ip": "1.1.1.1",
    "hostname": "one.one.one.one",
    "geo": {
      "city": "Brisbane",
      "region": "Queensland",
      "region_code": "QLD",
      "country": "Australia",
      "country_code": "AU",
      "continent": "Oceania",
      "continent_code": "OC",
      "latitude": -27.48159,
      "longitude": 153.0175,
      "timezone": "Australia/Brisbane",
      "postal_code": "4101",
      "geoname_id": "2174003",
      "radius": 10,
      "last_changed": "2024-10-20"
    },
    "as": {
      "asn": "AS13335",
      "name": "Cloudflare, Inc.",
      "domain": "cloudflare.com",
      "type": "hosting",
      "last_changed": "2025-03-09"
    },
    "mobile": {},
    "anonymous": {
      "is_proxy": false,
      "is_relay": false,
      "is_tor": false,
      "is_vpn": false
    },
    "is_anonymous": false,
    "is_anycast": true,
    "is_hosting": true,
    "is_mobile": false,
    "is_satellite": false
  },
  "lite/8.8.4.4/country": "United States",
  "8.8.4.4/anonymous": {
    "is_proxy": false,
    "is_relay": false,
    "is_tor": false,
    "is_vpn": false
  },
  "lite/8.8.4.4": {
    "ip": "8.8.4.4",
    "asn": "AS15169",
    "as_name": "Google LLC",
    "as_domain": "google.com",
    "country_code": "US",
    "country": "United States",
    "continent_code": "NA",
    "continent": "North America"
  }
}
```

**Filter Option**

There is also an optional `filter` parameter, which if set will result in any URLs for which there's no response being removed from the response. This can be useful for things like finding hostnames that exist for a range of IPs:

```bash
ipinfo → ~ $ echo -e '8.8.8.8/hostname\n8.8.8.9/hostname' |  curl -XPOST --data-binary @- "api.ipinfo.io/batch?token=$TOKEN"
{
  "8.8.8.9/hostname": null,
  "8.8.8.8/hostname": "dns.google"
}
ipinfo → ~ $ echo -e '8.8.8.8/hostname\n8.8.8.9/hostname' |  curl -XPOST --data-binary @- "api.ipinfo.io/batch?token=$TOKEN&filter=1"
{
  "8.8.8.8/hostname": "dns.google"
}
```

Note that for the purposes of request volume tracking, the call to `/batch` itself isn't counted, but all of the URLs within the call are. So the example above counts as 2 requests, and a single call to `/batch` with 100 URLs would count as 100 requests.

The batch endpoint works across all of our APIs. So you can use it with our ASN, IP ranges, and hosted domains endpoints too.

Lite Endpoint Option

Batch API

## Downloading Database

You can download your subscribed IPinfo database in two different ways:

- Database download from your dashboard on the webpage
- Database download from using `curl` on your terminal

### Option 1: Database download from the account dashboard

You can visit the [Data Downloads](/account/data-downloads) page to download your IPinfo database.

*Or,* you can go to:

1. your account [Dashboard](/account/home)
2. select [Data Downloads](/account/data-downloads)
3. and from there if you scroll down you will find your database that you can have subscribed to.

![Video showing steps to download a database file from the dashboard](https://website-cdn.assets.ipinfo.io/images/developers/database_download_demo.gif)

### Option 2: Database download using `cURL`

You can also download your IPinfo database using `cURL`. Please make sure you add the `-L` flag to your `cURL` command, which enables `cURL` to follow redirects.

```bash
curl -L https://ipinfo.io/data/location.csv.gz?token=$TOKEN -o location.csv.gz
```

![Image showing steps to download a database file with cURL](https://cdn.assets.ipinfo.io/static/images/docs/getting-started-with-database/data-download-terminal.gif)

We use `gzip` to compress our database. After downloading the database, you can extract the content or decompress the database using `gzip`, `gunzip`, or any compression software of your choice.

Downloading Database

## Database Operations

### Getting specific country location

You can filter out the IP addresses from any specific country by using the `grep` command from your terminal. One thing to remember is that you must start and end the country code with commas, for example: `,US,`, `,IN,`, `,CA,` etc.

```bash
(head -1 location.csv;grep ",US," location.csv) > location_us.csv
```

If you use the solution above, your outputted CSV file will contain the header row as well.

![Image showing how to get specific country by location](https://cdn.assets.ipinfo.io/static/images/docs/getting-started-with-database/getting-country-by-location.gif)

### Filtering the database with multiple countries/ASNs

Like filtering the database based on a single country or ASN, creating a sub-database containing multiple specific countries or ASNs is also possible. Let’s demonstrate that using multiple country filters. Get started by creating a text file(`countries.txt`) that contains your target countries in the following fashion:

```bash
,CA,
,FR,
,US,
,DE,
,UK,
```

As we will be using grep, your country code information must include the starting and trailing commas. Then using the -f option (stands for fixed-strings) run the following command.

```bash
(head -1 location.csv;grep -f countries.txt location.csv) > filtered_location.csv
```

This will create a filtered_locations.csv contains IP information of only the countries included in the countries.txt filter list.

![Image showing filtering the CSV database based on multiple country inputs](https://cdn.assets.ipinfo.io/static/images/docs/getting-started-with-database/multiple-country-filter.gif)

### Convert IP addresses to IP ranges

### Convert IP addresses to IP ranges

If you want to convert the IP address range columns (`start_ip`, `end_ip`) to their CIDR equivalent, you can use our [IPinfo CLI app](https://github.com/ipinfo/cli). The `range2cidr` command of the IPinfo CLI will convert the two columns to their individual CIDR equivalent. For example:

| Input (Start IP - End IP) | Output (CIDR) |
| --- | --- |
| 91.232.89.0 — 91.232.89.255 | 91.232.89.0/24 |

![Image showing how to convert IP addresses to IP ranges](https://cdn.assets.ipinfo.io/static/images/docs/getting-started-with-database/cidr2range.gif)

How to use the range2cidr command:

1. Install the [IPinfo CLI from GitHub](https://github.com/ipinfo/cli)
2. Unzip the downloaded IPinfo CSV database
3. Run then `range2cidr` command of the IPinfo CLI and save the output to a file
4. The outputted file would have the `start_ip` and `end_ip` columns converted to `cidr` column

```bash
ipinfo range2cidr location.csv > location_range.csv
```

### Exploring `MMDB` files using mmdbctl

Our open source [mmdbtctl](https://github.com/ipinfo/mmdbctl) makes exploration and management of MMDB files exceptionally easy.

Feel free to explore the documentation here: https://github.com/ipinfo/mmdbctl

| Code Snippet | Description |
| --- | --- |
| `mmdbctl read -f json-pretty 8.8.8.8 location.mmdb` | Lookup specific IP address (8.8.8.8) and output information as JSON from location.mmdb file |
| `mmdbctl read 8.8.8.0/31 location.mmdb` | Checking CIDR (8.8.8.0/31) data |
| `mmdbctl read 8.8.8.0-8.8.8.1 location.mmdb` | Getting IP range (8.8.8.0-8.8.8.1) data |
| `mmdbctl import --in data.csv --out data.mmdb` | Converting a CSV file (data.csv) to an MMDB file (data.mmdb) |
| `mmdbctl export data.mmdb data.csv` | Outputting CSV data (data.csv) from MMDB file (data.mmdb) |

![Image showing how to explore files using mmdbctl command](https://cdn.assets.ipinfo.io/static/images/docs/getting-started-with-database/mmdbctl-demo.gif)

Database Operations

## MMDB reader libraries

If you want to read the MMDB database file using a programming language, you can use an MMDB reader library. The MMDB reader libraries supported by IPinfo are:

- [C](https://github.com/maxmind/libmaxminddb)
- [C#](https://github.com/maxmind/MaxMind-DB-Reader-dotnet)
- [Java](https://github.com/maxmind/MaxMind-DB-Reader-java)
- [Perl](https://github.com/maxmind/MaxMind-DB-Reader-perl)
- [PHP](https://github.com/maxmind/MaxMind-DB-Reader-php)
- [Python](https://github.com/maxmind/MaxMind-DB-Reader-python)
- [Ruby](https://github.com/maxmind/MaxMind-DB-Reader-ruby)
- [Nodejs](https://github.com/runk/node-maxmind) (v3.0.1+ and Node v22+ required for MMDBs larger than 4GiB)

Using the MMDB reader library, you can open the database and lookup an IP address. Using the mmdbctl tool, you can create your own custom MMDB databases as well. If you need any assistance with using these libraries, feel free to reach out to us.

MMDB reader libraries

## Downloads Rate limit

We restrict the number of times a database can be downloaded to ten (10) times per day. This restriction applies to each unique IP address for an individual device. However, we are happy to accommodate requests to increase download limits. [Learn more about rate limits on data downloads.](https://community.ipinfo.io/t/announcement-we-are-adding-rate-limits-to-data-downloads/358)

Downloads Rate limit

## Checksums 

Checksums are essential for ensuring data integrity and security. By comparing the calculated hash values with the provided checksums, users can verify that their downloaded files haven't been tampered with or corrupted during transit.

We offer checksums API endpoints for every data download, supporting all the file formats. Checksums API response includes three hash values: md5, sha1, and sha256. Aside from the API endpoint, you can view checksums from your [data downloads page](/account/data-downloads) on your account dashboard.

```bash
curl https://ipinfo.io/data/free/country.csv.gz/checksums?token=$TOKEN
```

```json
{
  "checksums": {
    "md5": "75405cbe6ae89342dc4c58eede9f4bb2",
    "sha1": "8713da968c5bc0d89eba45ea349f75ac5569e21a",
    "sha256": "376f8148b250948bd236c00f4a00c95d2a22696ed3313141e9666af852f9bf1c"
  }
}
```

Checksums

## Cloud Data Delivery

We have the facilities to deliver our IP databases directly to your cloud storage buckets. As part of our IPinfo Enterprise plan, we support multiple cloud platforms and can deliver our IP database downloads directly to user's cloud storage bucket at regular intervals. The facilities we currently support are:

<table>
  <tbody>
    <tr>
      <td><strong>Cloud Storage Platform</strong></td>
      <td>
        <ul>
          <li>Google Cloud Storage</li>
          <li>AWS S3</li>
          <li>Azure Blob Storage</li>
        </ul>
      </td>
    </tr>
    <tr>
      <td><strong>Supported File Format</strong></td>
      <td>
        <ul>
          <li>CSV</li>
          <li>MMDB</li>
          <li>JSON</li>
          <li>Parquet</li>
        </ul>
      </td>
    </tr>
    <tr>
      <td><strong>Delivery Interval</strong></td>
      <td>
        <ul>
          <li>Daily</li>
          <li>Weekly</li>
          <li>Monthly</li>
        </ul>
      </td>
    </tr>
  </tbody>
</table>

If you don't see the cloud platform or format you are looking for, reach out to our [data experts](/contact) and we will get you set up.

Cloud Data Delivery

## Ecosystem Integrations

![IPinfo Data Consumption methods explained](https://cdn.assets.ipinfo.io/static/images/docs/getting-started-with-database/data_consumption_compared.png)

Through our ecosystem integrations program you can access IPinfo's data download capabilities in a number of leading data, IT and security software platforms. Compared to the standard data download and data push mechanisms, our ecosystem integrations offer more enhanced user benefits including; 'on-platform' purchases, out of the box optimized user functions and often an easier path for integrating IPinfo's data across the broader enterprise technology landscape.

Some of the platforms we currently support are:

- Snowflake via [Snowflake Marketplace](/snowflake)
- Google BigQuery via [Google Analytics Hub](https://console.cloud.google.com/bigquery/analytics-hub/exchanges;cameo=analyticshub;pageName=search;pageResource=?visibility=&queryText=ipinfo)
- [Graylog Cloud](https://go2docs.graylog.org/4-1/what_is_graylog/what_is_graylog_cloud.html)
- [Splunk](https://splunkbase.splunk.com/app/4070)

The data push mechanism, although it will deliver the data at your specified interval, it does not facilitate usage of the data across different marketplaces and does not include any out of the box optimized user functions.

If you are interested in exploring our ecosystem integrations, or have a requirement for an integration that we do not currently support, please contact alliances@ipinfo.io

Ecosystem Integrations

## Column/Field Types

Field types can differ depending on the download format:

- Parquet: fully typed, preserves booleans, numbers, and nulls.
- CSV: untyped, all values are strings; empty fields represents nulls.
- JSON: mostly untyped; numbers and booleans preserved when present, optional fields may be omitted.
- MMDB: typed for most IP database products; booleans and numbers preserved, optional fields may be absent.

Column/Field Types

## Database Guides

You can read some of our blog articles that showcase how to use our database:

- [Ingesting IPinfo geolocation data with PostgreSQL 13](https://ipinfo.io/blog/ingesting-ipinfo-geolocation-data-with-postgresql-13/)
- [Introducing a Simpler Way to get IP Address Data in Snowflake](https://ipinfo.io/blog/ip-address-data-in-snowflake/)
- [Data downloads vs API, or both?](https://ipinfo.io/blog/data-downloads-vs-api-or-both/)
- [Migrating from MaxMind to IPinfo](https://ipinfo.io/blog/migrating-from-maxmind-to-ipinfo/)
- [Our downloadable IP WHOIS data sets are live!](https://ipinfo.io/blog/our-downloadable-ip-whois-data-sets-are-live/)
- [How to choose the best file format for your IPinfo database?](https://ipinfo.io/blog/ipinfo-database-formats/)
- [IP data enrichment with IPinfo: 4 ways to add insights to your traffic/server logs](https://ipinfo.io/blog/ip-data-enrichment-in-4-ways/)

Want to share your experience as an IPinfo customer by writing an article? Email us at hello@ipinfo.io with an idea, we will get you set up.

Database Guides

Database Download

# IP Database Downloads Filenames

Reference Table includes:

- Database download names
- Database file types: `CSV`, `JSON`, `MMDB`, and `Parquet` filename references
- The `CSV` and `JSON` files are compressed in `gzip` format


**Database download command using `curl`**

```bash
curl -L https://ipinfo.io/data/standard_location.json.gz?token=$TOKEN -o location.json.gz
```

**Using the sample datasets**

Each sample dataset is updated daily. It contains 100 rows of data in a systematic, randomized pattern. The data across all the different file formats for the same IP database download is identical. 

We recommend using these sample datasets for testing and integration development purposes. You can download the sample datasets without an IPinfo Access Token.

## [IPinfo Lite](/developers/ipinfo-lite-database)

| File Format | Database Download URI                                                                                                 | Sample Dataset URI                                                                                   |
|-------------|------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------|
| **CSV**     | [https://ipinfo.io/data/**ipinfo_lite.csv.gz**?token=$TOKEN](https://ipinfo.io/data/ipinfo_lite.csv.gz?token=$TOKEN)   | [https://ipinfo.io/data/sample/**ipinfo_lite.csv**](https://ipinfo.io/data/sample/ipinfo_lite.csv)   |
| **JSON**    | [https://ipinfo.io/data/**ipinfo_lite.json.gz**?token=$TOKEN](https://ipinfo.io/data/ipinfo_lite.json.gz?token=$TOKEN) | [https://ipinfo.io/data/sample/**ipinfo_lite.json**](https://ipinfo.io/data/sample/ipinfo_lite.json) |
| **MMDB**    | [https://ipinfo.io/data/**ipinfo_lite.mmdb**?token=$TOKEN](https://ipinfo.io/data/ipinfo_lite.mmdb?token=$TOKEN)       | [https://ipinfo.io/data/sample/**ipinfo_lite.mmdb**](https://ipinfo.io/data/sample/ipinfo_lite.mmdb) |
| **Parquet** | [https://ipinfo.io/data/**ipinfo_lite.parquet**?token=$TOKEN](https://ipinfo.io/data/ipinfo_lite.parquet?token=$TOKEN) |[https://ipinfo.io/data/sample/**ipinfo_lite.parquet**](https://ipinfo.io/data/sample/ipinfo_lite.parquet) |

[IPinfo Lite](/developers/ipinfo-lite-database)

## [IPinfo Core](/developers/ipinfo-core-database)

| File Format | Database Download URI                                                                                                  | Sample Dataset URI                                                                                   |
|-------------|------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------|
| **CSV**     | [https://ipinfo.io/data/**ipinfo_core.csv.gz**?token=$TOKEN](https://ipinfo.io/data/ipinfo_core.csv.gz?token=$TOKEN)   | [https://ipinfo.io/data/sample/**ipinfo_core.csv**](https://ipinfo.io/data/sample/ipinfo_core.csv)   |
| **JSON**    | [https://ipinfo.io/data/**ipinfo_core.json.gz**?token=$TOKEN](https://ipinfo.io/data/ipinfo_core.json.gz?token=$TOKEN) | [https://ipinfo.io/data/sample/**ipinfo_core.json**](https://ipinfo.io/data/sample/ipinfo_core.json) |
| **MMDB**    | [https://ipinfo.io/data/**ipinfo_core.mmdb**?token=$TOKEN](https://ipinfo.io/data/ipinfo_core.mmdb?token=$TOKEN)       | [https://ipinfo.io/data/sample/**ipinfo_core.mmdb**](https://ipinfo.io/data/sample/ipinfo_core.mmdb) |
| **Parquet** | [https://ipinfo.io/data/**ipinfo_core.parquet**?token=$TOKEN](https://ipinfo.io/data/ipinfo_core.parquet?token=$TOKEN) |[https://ipinfo.io/data/sample/**ipinfo_core.parquet**](https://ipinfo.io/data/sample/ipinfo_core.parquet) |

[IPinfo Core](/developers/ipinfo-core-database)

## [IPinfo Plus](/developers/ipinfo-plus-database)

| File Format | Database Download URI                                                                                                  | Sample Dataset URI                                                                                   |
|-------------|------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------|
| **CSV**     | [https://ipinfo.io/data/**ipinfo_plus.csv.gz**?token=$TOKEN](https://ipinfo.io/data/ipinfo_plus.csv.gz?token=$TOKEN)   | [https://ipinfo.io/data/sample/**ipinfo_plus.csv**](https://ipinfo.io/data/sample/ipinfo_plus.csv)   |
| **JSON**    | [https://ipinfo.io/data/**ipinfo_plus.json.gz**?token=$TOKEN](https://ipinfo.io/data/ipinfo_plus.json.gz?token=$TOKEN) | [https://ipinfo.io/data/sample/**ipinfo_plus.json**](https://ipinfo.io/data/sample/ipinfo_plus.json) |
| **MMDB**    | [https://ipinfo.io/data/**ipinfo_plus.mmdb**?token=$TOKEN](https://ipinfo.io/data/ipinfo_plus.mmdb?token=$TOKEN)       | [https://ipinfo.io/data/sample/**ipinfo_plus.mmdb**](https://ipinfo.io/data/sample/ipinfo_plus.mmdb) |
| **Parquet** | [https://ipinfo.io/data/**ipinfo_plus.parquet**?token=$TOKEN](https://ipinfo.io/data/ipinfo_plus.parquet?token=$TOKEN) |[https://ipinfo.io/data/sample/**ipinfo_plus.parquet**](https://ipinfo.io/data/sample/ipinfo_plus.parquet) |

[IPinfo Plus](/developers/ipinfo-plus-database)

## [Residential Proxy Detection Database](/developers/ip-to-residential-proxy)

| File Format | Database Download URI                                                                                            | Sample Dataset URI                                                                             |
|-------------|------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------|
| **CSV**     | [https://ipinfo.io/data/**resproxy.csv.gz**?token=$TOKEN](https://ipinfo.io/data/resproxy.csv.gz?token=$TOKEN)   | [https://ipinfo.io/data/sample/**resproxy.csv**](https://ipinfo.io/data/sample/resproxy.csv)   |
| **JSON**    | [https://ipinfo.io/data/**resproxy.json.gz**?token=$TOKEN](https://ipinfo.io/data/resproxy.json.gz?token=$TOKEN) | [https://ipinfo.io/data/sample/**resproxy.json**](https://ipinfo.io/data/sample/resproxy.json) |
| **MMDB**    | [https://ipinfo.io/data/**resproxy.mmdb**?token=$TOKEN](https://ipinfo.io/data/resproxy.mmdb?token=$TOKEN)       | [https://ipinfo.io/data/sample/**resproxy.mmdb**](https://ipinfo.io/data/sample/resproxy.mmdb) |
| **Parquet** | [https://ipinfo.io/data/**resproxy.parquet**?token=$TOKEN](https://ipinfo.io/data/resproxy.parquet?token=$TOKEN) |[https://ipinfo.io/data/sample/**resproxy.parquet**](https://ipinfo.io/data/sample/resproxy.parquet) |

[Residential Proxy Detection Database](/developers/ip-to-residential-proxy)

## [IP to Geolocation Database](/developers/ip-to-geolocation-database)

| File Format | Database Download URI                                                                                                          | Sample Dataset URI                                                                                           |
|-------------|--------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------|
| **CSV**     | [https://ipinfo.io/data/**ipinfo_location.csv.gz**?token=$TOKEN](https://ipinfo.io/data/ipinfo_location.csv.gz?token=$TOKEN)   | [https://ipinfo.io/data/sample/**ipinfo_location.csv**](https://ipinfo.io/data/sample/ipinfo_location.csv)   |
| **JSON**    | [https://ipinfo.io/data/**ipinfo_location.json.gz**?token=$TOKEN](https://ipinfo.io/data/ipinfo_location.json.gz?token=$TOKEN) | [https://ipinfo.io/data/sample/**ipinfo_location.json**](https://ipinfo.io/data/sample/ipinfo_location.json) |
| **MMDB**    | [https://ipinfo.io/data/**ipinfo_location.mmdb**?token=$TOKEN](https://ipinfo.io/data/ipinfo_location.mmdb?token=$TOKEN)       | [https://ipinfo.io/data/sample/**ipinfo_location.mmdb**](https://ipinfo.io/data/sample/ipinfo_location.mmdb) |
| **Parquet** | [https://ipinfo.io/data/**ipinfo_location.parquet**?token=$TOKEN](https://ipinfo.io/data/ipinfo_location.parquet?token=$TOKEN) |[https://ipinfo.io/data/sample/**ipinfo_location.parquet**](https://ipinfo.io/data/sample/ipinfo_location.parquet) |

[IP to Geolocation Database](/developers/ip-to-geolocation-database)

## [ASN Database](/developers/asn-database)

| File Format | Database Download URI                                                                                                | Sample Dataset URI                                                                                 |
|-------------|----------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------|
| **CSV**     | [https://ipinfo.io/data/**ipinfo_asn.csv.gz**?token=$TOKEN](https://ipinfo.io/data/ipinfo_asn.csv.gz?token=$TOKEN)   | [https://ipinfo.io/data/sample/**ipinfo_asn.csv**](https://ipinfo.io/data/sample/ipinfo_asn.csv)   |
| **JSON**    | [https://ipinfo.io/data/**ipinfo_asn.json.gz**?token=$TOKEN](https://ipinfo.io/data/ipinfo_asn.json.gz?token=$TOKEN) | [https://ipinfo.io/data/sample/**ipinfo_asn.json**](https://ipinfo.io/data/sample/ipinfo_asn.json) |
| **MMDB**    | [https://ipinfo.io/data/**ipinfo_asn.mmdb**?token=$TOKEN](https://ipinfo.io/data/ipinfo_asn.mmdb?token=$TOKEN)       | [https://ipinfo.io/data/sample/**ipinfo_asn.mmdb**](https://ipinfo.io/data/sample/ipinfo_asn.mmdb) |
| **Parquet** | [https://ipinfo.io/data/**ipinfo_asn.parquet**?token=$TOKEN](https://ipinfo.io/data/ipinfo_asn.parquet?token=$TOKEN) |[https://ipinfo.io/data/sample/**ipinfo_asn.parquet**](https://ipinfo.io/data/sample/ipinfo_asn.parquet) |

[ASN Database](/developers/asn-database)

## [IP to Privacy Detection Database](/developers/privacy-detection-database)

| File Format | Database Download URI                                                                                                        | Sample Dataset URI                                                                                         |
|-------------|------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------|
| **CSV**     | [https://ipinfo.io/data/**ipinfo_privacy.csv.gz**?token=$TOKEN](https://ipinfo.io/data/ipinfo_privacy.csv.gz?token=$TOKEN)   | [https://ipinfo.io/data/sample/**ipinfo_privacy.csv**](https://ipinfo.io/data/sample/ipinfo_privacy.csv)   |
| **JSON**    | [https://ipinfo.io/data/**ipinfo_privacy.json.gz**?token=$TOKEN](https://ipinfo.io/data/ipinfo_privacy.json.gz?token=$TOKEN) | [https://ipinfo.io/data/sample/**ipinfo_privacy.json**](https://ipinfo.io/data/sample/ipinfo_privacy.json) |
| **MMDB**    | [https://ipinfo.io/data/**ipinfo_privacy.mmdb**?token=$TOKEN](https://ipinfo.io/data/ipinfo_privacy.mmdb?token=$TOKEN)       | [https://ipinfo.io/data/sample/**ipinfo_privacy.mmdb**](https://ipinfo.io/data/sample/ipinfo_privacy.mmdb) |
| **Parquet** | [https://ipinfo.io/data/**ipinfo_privacy.parquet**?token=$TOKEN](https://ipinfo.io/data/ipinfo_privacy.parquet?token=$TOKEN) |[https://ipinfo.io/data/sample/**ipinfo_privacy.parquet**](https://ipinfo.io/data/sample/ipinfo_privacy.parquet) |

[IP to Privacy Detection Database](/developers/privacy-detection-database)

## [IP to Company Database](/developers/ip-to-company-database)

| File Format | Database Download URI                                                                                                            | Sample Dataset URI                                                                           |
|-------------|----------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------|
| **CSV**     | [https://ipinfo.io/data/**standard_company.csv.gz**?token=$TOKEN](https://ipinfo.io/data/standard_company.csv.gz?token=$TOKEN)   | [https://ipinfo.io/data/sample/**company.csv**](https://ipinfo.io/data/sample/company.csv)   |
| **JSON**    | [https://ipinfo.io/data/**standard_company.json.gz**?token=$TOKEN](https://ipinfo.io/data/standard_company.json.gz?token=$TOKEN) | [https://ipinfo.io/data/sample/**company.json**](https://ipinfo.io/data/sample/company.json) |
| **MMDB**    | [https://ipinfo.io/data/**standard_company.mmdb**?token=$TOKEN](https://ipinfo.io/data/standard_company.mmdb?token=$TOKEN)       | [https://ipinfo.io/data/sample/**company.mmdb**](https://ipinfo.io/data/sample/company.mmdb) |
| **Parquet** | [https://ipinfo.io/data/**standard_company.parquet**?token=$TOKEN](https://ipinfo.io/data/standard_company.parquet?token=$TOKEN) |[https://ipinfo.io/data/sample/**company.parquet**](https://ipinfo.io/data/sample/company.parquet) |

[IP to Company Database](/developers/ip-to-company-database)

## [IP to Mobile Carrier Database](/developers/ip-to-mobile-carrier-database)

| File Format | Database Download URI                                                                                                        | Sample Dataset URI                                                                                         |
|-------------|------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------|
| **CSV**     | [https://ipinfo.io/data/**ipinfo_carrier.csv.gz**?token=$TOKEN](https://ipinfo.io/data/ipinfo_carrier.csv.gz?token=$TOKEN)   | [https://ipinfo.io/data/sample/**ipinfo_carrier.csv**](https://ipinfo.io/data/sample/ipinfo_carrier.csv)   |
| **JSON**    | [https://ipinfo.io/data/**ipinfo_carrier.json.gz**?token=$TOKEN](https://ipinfo.io/data/ipinfo_carrier.json.gz?token=$TOKEN) | [https://ipinfo.io/data/sample/**ipinfo_carrier.json**](https://ipinfo.io/data/sample/ipinfo_carrier.json) |
| **MMDB**    | [https://ipinfo.io/data/**ipinfo_carrier.mmdb**?token=$TOKEN](https://ipinfo.io/data/ipinfo_carrier.mmdb?token=$TOKEN)       | [https://ipinfo.io/data/sample/**ipinfo_carrier.mmdb**](https://ipinfo.io/data/sample/ipinfo_carrier.mmdb) |
| **Parquet** | [https://ipinfo.io/data/**ipinfo_carrier.parquet**?token=$TOKEN](https://ipinfo.io/data/ipinfo_carrier.parquet?token=$TOKEN) |[https://ipinfo.io/data/sample/**ipinfo_carrier.parquet**](https://ipinfo.io/data/sample/ipinfo_carrier.parquet) |

[IP to Mobile Carrier Database](/developers/ip-to-mobile-carrier-database)

## [Hosted Domains Database](/developers/hosted-domains-database)

| File Format | Database Download URI                                                                                                                                | Sample Dataset URI                                                                                                                 |
|-------------|------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------|
| **CSV**     | [https://ipinfo.io/data/**standard_ip_hosted_domains.csv.gz**?token=$TOKEN](https://ipinfo.io/data/standard_ip_hosted_domains.csv.gz?token=$TOKEN)   | [https://ipinfo.io/data/sample/**standard_ip_hosted_domains.csv**](https://ipinfo.io/data/sample/standard_ip_hosted_domains.csv)   |
| **JSON**    | [https://ipinfo.io/data/**standard_ip_hosted_domains.json.gz**?token=$TOKEN](https://ipinfo.io/data/standard_ip_hosted_domains.json.gz?token=$TOKEN) | [https://ipinfo.io/data/sample/**standard_ip_hosted_domains.json**](https://ipinfo.io/data/sample/standard_ip_hosted_domains.json) |
| **MMDB**    | [https://ipinfo.io/data/**standard_ip_hosted_domains.mmdb**?token=$TOKEN](https://ipinfo.io/data/standard_ip_hosted_domains.mmdb?token=$TOKEN)       | [https://ipinfo.io/data/sample/**standard_ip_hosted_domains.mmdb**](https://ipinfo.io/data/sample/standard_ip_hosted_domains.mmdb) |
| **Parquet**    | [https://ipinfo.io/data/**standard_ip_hosted_domains.parquet**?token=$TOKEN](https://ipinfo.io/data/standard_ip_hosted_domains.parquet?token=$TOKEN)       | [https://ipinfo.io/data/sample/**standard_ip_hosted_domains.parquet**](https://ipinfo.io/data/sample/standard_ip_hosted_domains.parquet) |

[Hosted Domains Database](/developers/hosted-domains-database)

## [Abuse Contact Database](/developers/abuse-contact-database)

| File Format | Database Download URI                                                                                                        | Sample Dataset URI                                                                                         |
|-------------|------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------|
| **CSV**     | [https://ipinfo.io/data/**standard_abuse.csv.gz**?token=$TOKEN](https://ipinfo.io/data/standard_abuse.csv.gz?token=$TOKEN)   | [https://ipinfo.io/data/sample/**standard_abuse.csv**](https://ipinfo.io/data/sample/standard_abuse.csv)   |
| **JSON**    | [https://ipinfo.io/data/**standard_abuse.json.gz**?token=$TOKEN](https://ipinfo.io/data/standard_abuse.json.gz?token=$TOKEN) | [https://ipinfo.io/data/sample/**standard_abuse.json**](https://ipinfo.io/data/sample/standard_abuse.json) |
| **MMDB**    | [https://ipinfo.io/data/**standard_abuse.mmdb**?token=$TOKEN](https://ipinfo.io/data/standard_abuse.mmdb?token=$TOKEN)       | [https://ipinfo.io/data/sample/**standard_abuse.mmdb**](https://ipinfo.io/data/sample/standard_abuse.mmdb) |
| **Parquet** | [https://ipinfo.io/data/**standard_abuse.parquet**?token=$TOKEN](https://ipinfo.io/data/standard_abuse.parquet?token=$TOKEN) |[https://ipinfo.io/data/sample/**standard_abuse.parquet**](https://ipinfo.io/data/sample/standard_abuse.parquet) |

[Abuse Contact Database](/developers/abuse-contact-database)

## [RIR WHOIS](/developers/ip-whois-database#rir-whois-database)

| File Format | Database Download URI                                                                                  | Sample Dataset URI                                                                   |
|-------------|--------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------|
| **CSV**     | [https://ipinfo.io/data/**rir.csv.gz**?token=$TOKEN](https://ipinfo.io/data/rir.csv.gz?token=$TOKEN)   | [https://ipinfo.io/data/sample/**rir.csv**](https://ipinfo.io/data/sample/rir.csv)   |
| **JSON**    | [https://ipinfo.io/data/**rir.json.gz**?token=$TOKEN](https://ipinfo.io/data/rir.json.gz?token=$TOKEN) | [https://ipinfo.io/data/sample/**rir.json**](https://ipinfo.io/data/sample/rir.json) |
| **MMDB**    | [https://ipinfo.io/data/**rir.mmdb**?token=$TOKEN](https://ipinfo.io/data/rir.mmdb?token=$TOKEN) | [https://ipinfo.io/data/sample/**rir.mmdb**](https://ipinfo.io/data/sample/rir.mmdb) |
| **Parquet**    | [https://ipinfo.io/data/**rir.parquet**?token=$TOKEN](https://ipinfo.io/data/rir.parquet?token=$TOKEN) | [https://ipinfo.io/data/sample/**rir.parquet**](https://ipinfo.io/data/sample/rir.parquet) |

[RIR WHOIS](/developers/ip-whois-database#rir-whois-database)

## [RWHOIS](/developers/ip-whois-database#rwhois-database)

| File Format | Database Download URI                                                                                        | Sample Dataset URI                                                                         |
|-------------|--------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------|
| **CSV**     | [https://ipinfo.io/data/**rwhois.csv.gz**?token=$TOKEN](https://ipinfo.io/data/rwhois.csv.gz?token=$TOKEN)   | [https://ipinfo.io/data/sample/**rwhois.csv**](https://ipinfo.io/data/sample/rwhois.csv)   |
| **JSON**    | [https://ipinfo.io/data/**rwhois.json.gz**?token=$TOKEN](https://ipinfo.io/data/rwhois.json.gz?token=$TOKEN) | [https://ipinfo.io/data/sample/**rwhois.json**](https://ipinfo.io/data/sample/rwhois.json) |
| **MMDB**    | [https://ipinfo.io/data/**rwhois.mmdb**?token=$TOKEN](https://ipinfo.io/data/rwhois.mmdb?token=$TOKEN) | [https://ipinfo.io/data/sample/**rwhois.mmdb**](https://ipinfo.io/data/sample/rwhois.mmdb) |
| **Parquet**    | [https://ipinfo.io/data/**rwhois.parquet**?token=$TOKEN](https://ipinfo.io/data/rwhois.parquet?token=$TOKEN) | [https://ipinfo.io/data/sample/**rwhois.parquet**](https://ipinfo.io/data/sample/rwhois.parquet) |

[RWHOIS](/developers/ip-whois-database#rwhois-database)

## [IP to Geolocation Extended Database](/developers/ip-to-geolocation-extended)

| File Format | Database Download URI                                                                                                                    | Sample Dataset URI                                                                                                     |
|-------------|------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------|
| **CSV**     | [https://ipinfo.io/data/**location_extended_v2.csv.gz**?token=$TOKEN](https://ipinfo.io/data/location_extended_v2.csv.gz?token=$TOKEN)   | [https://ipinfo.io/data/sample/**location_extended_v2.csv**](https://ipinfo.io/data/sample/location_extended_v2.csv)   |
| **JSON**    | [https://ipinfo.io/data/**location_extended_v2.json.gz**?token=$TOKEN](https://ipinfo.io/data/location_extended_v2.json.gz?token=$TOKEN) | [https://ipinfo.io/data/sample/**location_extended_v2.json**](https://ipinfo.io/data/sample/location_extended_v2.json) |
| **MMDB**    | [https://ipinfo.io/data/**location_extended_v2.mmdb**?token=$TOKEN](https://ipinfo.io/data/location_extended_v2.mmdb?token=$TOKEN)       | [https://ipinfo.io/data/sample/**location_extended_v2.mmdb**](https://ipinfo.io/data/sample/location_extended_v2.mmdb) |
| **Parquet**    | [https://ipinfo.io/data/**location_extended_v2.parquet**?token=$TOKEN](https://ipinfo.io/data/location_extended_v2.parquet?token=$TOKEN)       | [https://ipinfo.io/data/sample/**location_extended_v2.parquet**](https://ipinfo.io/data/sample/location_extended_v2.parquet) |

[IP to Geolocation Extended Database](/developers/ip-to-geolocation-extended)

## [IP to Privacy Detection Extended Database](/developers/privacy-detection-extended)

| File Format | Database Download URI                                                                                                                          | Sample Dataset URI                                                                                                           |
|-------------|------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------|
| **CSV**     | [https://ipinfo.io/data/**ipinfo_privacy_extended.csv.gz**?token=$TOKEN](https://ipinfo.io/data/ipinfo_privacy_extended.csv.gz?token=$TOKEN)   | [https://ipinfo.io/data/sample/**ipinfo_privacy_extended.csv**](https://ipinfo.io/data/sample/ipinfo_privacy_extended.csv)   |
| **JSON**    | [https://ipinfo.io/data/**ipinfo_privacy_extended.json.gz**?token=$TOKEN](https://ipinfo.io/data/ipinfo_privacy_extended.json.gz?token=$TOKEN) | [https://ipinfo.io/data/sample/**ipinfo_privacy_extended.json**](https://ipinfo.io/data/sample/ipinfo_privacy_extended.json) |
| **MMDB**    | [https://ipinfo.io/data/**ipinfo_privacy_extended.mmdb**?token=$TOKEN](https://ipinfo.io/data/ipinfo_privacy_extended.mmdb?token=$TOKEN)       | [https://ipinfo.io/data/sample/**ipinfo_privacy_extended.mmdb**](https://ipinfo.io/data/sample/ipinfo_privacy_extended.mmdb) |
| **Parquet** | [https://ipinfo.io/data/**ipinfo_privacy_extended.parquet**?token=$TOKEN](https://ipinfo.io/data/ipinfo_privacy_extended.parquet?token=$TOKEN) |[https://ipinfo.io/data/sample/**ipinfo_privacy_extended.parquet**](https://ipinfo.io/data/sample/ipinfo_privacy_extended.parquet) |


If you are interested in learning which database format suits your needs, check out our article: **[How to choose the best file format for your IPinfo database?](https://ipinfo.io/blog/ipinfo-database-formats/)**

[IP to Privacy Detection Extended Database](/developers/privacy-detection-extended)

Database Filenames

IPinfo Lite

IPinfo Core

IPinfo Plus

IP to Geolocation

Privacy Detection

IP to Residential Proxy

IP to Device Count

IP to Company

ASN Database

IP to Mobile Carrier

Hosted Domains

Abuse Contact

IP WHOIS

IP to Geolocation Extended

Privacy Detection Extended

# IP Database Types

We provide a number of different database products covering different aspects and dimensions of IP information.

IPinfo Bundle Databases

## Standard Databases

Our paid databases include the following:

- [IP to Geolocation](/developers/ip-to-geolocation-database)
- [IP to Company](/developers/ip-to-company-database)
- [ASN Database](/developers/asn-database)
- [IP to Privacy Detection](/developers/privacy-detection-database)
- [IP to Mobile Carrier](/developers/ip-to-mobile-carrier-database)
- [Hosted Domains](/developers/hosted-domains-database)
- [Abuse Contact](/developers/abuse-contact-database)
- [IP WHOIS](/developers/ip-whois-database)
- [IP to Residential Proxy Database](/developers/ip-to-residential-proxy)

Standard Databases

## Extended Databases

IPinfo offers extended databases that covers IP geolocation precision data with accuracy radius and comprehensive IP privacy detection database with detection methodology.

- [IP to Geolocation Extended](/developers/ip-to-geolocation-extended)
- [IP to Privacy Detection Extended](/developers/privacy-detection-extended)

If you are interested in a customized database or historical data, please feel free to [reach out to us](/contact).

Extended Databases

# IPinfo Lite Database

The IPinfo Lite database is part of our [free IP data downloads offering](/lite). The IPinfo Lite database is our ultimate free IP database combining both country and ASN information in a single database.

The IPinfo Lite Database includes:

- **Country-level geolocation data**: Country and continent information for IP addresses.
- **Basic ASN data**: Autonomous System Number (ASN), organization name, and domain name.

> You can access IPinfo Lite data through our unlimited requests API service: **[IPinfo Lite API](/developers/lite-api)**

# IPinfo Core Database

IPinfo Core is a robust IP database that combines our location, ASN, network flags data in a single database.

> Database downloads are a separate enterprise offering and are not included in [IPinfo Core API](/developers/core-api) self-serve plans. Please [contact our sales team](/contact) for enterprise pricing and access.

# IPinfo Plus Database

IPinfo's Plus is an enterprise-grade IP database that combines our location, insights, and confidence with ASN, privacy, carrier, and network flags in a single database.

> Database downloads are a separate enterprise offering and are not included in [IPinfo Plus API](/developers/plus-api) self-serve plans. Please [contact our sales team](/contact) for enterprise pricing and access.

# IP to Geolocation Database

[IP to Geolocation](/data/ip-geolocation) database provides geolocation information such as city, region/state, country, postal code, timezone, geographic coordinates (latitude & longitude) etc. identified from IP addresses.

# IP Privacy Detection Database

[Privacy Detection or Anonymous IP database](/data/proxy-vpn-detection) provides data on IP addresses that are associated with VPN, Tor, proxies, relays, and hosting services.

<div style="position: relative; padding-bottom: 56.25%; height: 0; overflow: hidden; max-width: 100%; margin-bottom: 20px;">
  <iframe style="position: absolute; top: 0; left: 0; width: 100%; height: 100%;" src="https://www.youtube.com/embed/qHTaCHwSYRg" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
</div>

# IP to Residential Proxy Database

The IP to Residential Proxy dataset provides information on IP addresses associated with residential, mobile, or datacenter proxy networks, allowing developers to identify proxy IPs, understand their type, and use usage-based signals to build risk or filtering logic. The IP to Residential Proxy Database identifies residential proxy IP addresses from over 100 services, including residential connections, carrier/phone, and data center proxies, and tracks both IPv4 and IPv6 IPs, providing details on the associated proxy service, last seen date, and percentage of days active over a certain time window period—all in a single, comprehensive database. This detection can identify SIM farm-based, compromised device, and smartphone SDK-based proxy IP addresses and more.

# IP to Device Count Database

The [IP to Device Count dataset](/data/device-count) provides network-level intelligence on how many devices share an IP address and whether that sharing is concurrent or rotating over time. This goes far beyond simple "[residential](/data/ip-asn)" or "[mobile](/data/ip-carrier)" labels. The IP to Device Count database reveals whether an IP is used by 1 device, 10, or 10,000+, and whether that sharing happens all at once (concurrent CGNAT) or one device at a time with ISP rotation (dynamic residential).

The database covers currently (as of April 10, 2026) 7.7 million networks globally, with 1.3 million networks exhibiting daily device sharing patterns, and includes validated coverage for major carriers worldwide.

> **Status:** Alpha (Early Access)

# IP to Company Database

The [IP to Company](/data/ip-company) database provides firmographic data such as the name of the company, company domain, company type, company country, and AS level data.

# ASN Database

The [ASN (Autonomous System Number) database](/data/ip-asn) provides AS-related data such as IP ranges within the AS, ASN, domain name of the AS, name of the AS, AS type (ISP, hosting, government, education, business), and country of the AS.

# IP to Mobile Carrier Database

IPinfo’s [IP to Mobile Carrier Database](/data/ip-carrier) provides insights such as IP addresses of mobile devices and their respective carrier name, mobile country code (MCC) and mobile country name (MNC).

# Hosted Domains Database

[Hosted Domains or Reverse IP database](/data/hosted-domains) shows the number and the list of domains hosted on an IP Address. The Hosted Domains database contains upto 1,000 domains per IP address entry.

# IP Abuse Contact Database

The [Abuse Contact database](/data/ip-abuse-contact) provides abuse contact information of ISPs and hosting services for reporting malicious activities.

# IP WHOIS

Comprehensive, contextual, and updated [IP WHOIS database](/data/whois) allows you to look up an IP address and domain ownership, point of contact, organization, networks etc. The different types of WHOIS database we offer are:

- RWHOIS
- RIR WHOIS
- Additional Databases
  - WHOIS ASN (Autonomous System Numbers)
  - WHOIS MNT (Maintainer)
  - WHOIS NET (Network)
  - WHOIS ORG (Organization)
  - WHOIS POC (Point of Contact)

# IP to Geolocation Extended Database

IP to Geolocation Extended database offers comprehensive geolocation information such as city, region/state, country, postal code, timezone, and geographic coordinates (latitude & longitude). Additionally, it includes data accuracy measurement in the form of radius data.

# IP Privacy Detection Extended Database

Privacy Detection extended database reveals IP addresses linked to VPNs, Tor, proxies, relays, and hosting services. The database helps users to understand how we detect anonymous IP addresses so that they can use this information to build personalized cybersecurity policies.

Database Types

# Integrations Overview

IPinfo has partnered with data marketplaces, workflow automation platforms, cybersecurity applications, and IT administration systems. Our goal is to provide an integrated environment that enables users to get and up running with IP data. You can check out our full list of integrations from our [integrations page](/integrations).

The current list of IPinfo Platform integrations includes:

- [Snowflake Data Marketplace](/developers/snowflake)
- [Google BigQuery / Google Cloud Data Marketplace](/developers/gcp-integration)
- [Splunk](/developers/splunk)
- [Cribl](https://community.ipinfo.io/t/using-ipinfo-s-databases-in-cribl/5262)

We provide help in building your own platform-specific IPinfo integration using a [Bring Your Own License integration](/developers/byol-integration).

## Platform Integrations

- [Auth0](https://marketplace.auth0.com/integrations/ipinfo)
- [Beam AI](https://beam.ai/integrations/ipinfoio)
- [Crowdstrike SOAR Action](https://marketplace.crowdstrike.com/listings/ipinfo-io-soar-actions/)
- [Dropzone AI](https://docs.dropzone.ai/integrations/data/ipinfo-io)
- [Heroku](https://elements.heroku.com/addons/ipinfo)
- [Integrately](https://integrately.com/integrations/ipinfo)
- [Lindy](https://www.lindy.ai/integrations/ipinfo-io)
- [n8n](https://n8n.io/integrations/ipinfo/)
- [Palo Alto Cortex](https://cortex.marketplace.pan.dev/marketplace/details/ipinfo/)
- [Pipedream](https://pipedream.com/apps/ipinfo-io)
- [Relevance AI](https://relevanceai.com/integrations/ipinfo-io)
- [Rube](https://rube.app/marketplace/ipinfo_io)
- [Sumo Logic](https://www.sumologic.com/help/docs/platform-services/automation-service/app-central/integrations/ipinfo/)
- [Zapier](https://zapier.com/apps/ipinfo/integrations)

Platform Integrations

Integrations Overview

# IPinfo on Snowflake Marketplace

IPinfo is the premier IP data provider in the **[Snowflake Marketplace](https://app.snowflake.com/marketplace/providers/GZSTZ3VDMAT/IPinfo%20Inc.)**. To make the most of our data in Snowflake, we recommend that you go through this documentation.

![Snowflake header image](https://cdn.assets.ipinfo.io/static/images/docs/snowflake/snowflake-header.gif)

## IPinfo on the Snowflake Marketplace

<div style="position: relative; padding-bottom: 56.25%; height: 0; overflow: hidden; max-width: 100%; margin-bottom: 20px;">
  <iframe style="position: absolute; top: 0; left: 0; width: 100%; height: 100%;" src="https://www.youtube.com/embed/jMP6frL5mZw" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
</div>

You can check out our IP databases from [our storefront](https://app.snowflake.com/marketplace/listings/IPinfo) as well. Each listing page contains a description of the product, available column/field names, use cases, sample queries, and other useful information to get you up and running. We currently have the following IP datasets available in the Snowflake Marketplace.

| Product                                                                                                             | Description                                                                                                                                                   |
| ------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [IPinfo Lite](https://app.snowflake.com/marketplace/listing/GZSTZSHKQ55S)                                           | Open access, full-accuracy IP datasets that provide IP-to-country and ASN details.                                                                           |
| [IPinfo Core](https://app.snowflake.com/marketplace/listing/GZSTZSHKQ56D)                                           | City-level precision and network connection context (anonymous+, satellite, and carrier).                                                                       |
| [IPinfo Plus](https://app.snowflake.com/marketplace/listing/GZSTZSHKQ56H)                                           | Comprehensive IP intelligence, including location, anonymity/privacy, ASN, carrier, and stability.                                                            |
| [IPinfo Residential Proxy](https://app.snowflake.com/marketplace/listing/GZSTZSHKQ55W)                              | Detect residential and mobile proxy IPs with service and usage metrics.                                                                                       |
| [IPinfo IP Geolocation](https://app.snowflake.com/marketplace/listing/GZSTZ3VDMFI)                                  | Accurate IP location with detailed and granular precision.                                                                                                    |
| [IPinfo Company IP Address Data](https://app.snowflake.com/marketplace/listing/GZSTZ3VDMEX)                         | Identify companies and organizations through IP addresses.                                                                                                    |
| [IPinfo Privacy Detection (VPN, TOR, Relay, Proxy etc.)](https://app.snowflake.com/marketplace/listing/GZSTZ3VDMFU) | Detect hosting, VPN, proxy, Relay and Tor IPs.                                                                                                                |
| [Comprehensive IP WHOIS Data](https://app.snowflake.com/marketplace/listing/GZSTZ3VDMFY)                            | Structured IP WHOIS data for ASN, Organization, Maintainer, Network & POC Records                                                                             |
| [IPinfo: IP Geolocation Training/Education Sample](https://app.snowflake.com/marketplace/listing/GZSTZ3VDMEH)       | Snowflake's "[The Hands-On Essentials Workshop Series](https://www.snowflake.com/en/resources/learn/snowflake-essentials-training/)" workshop practices data. |

IPinfo on the Snowflake Marketplace

## Database Operations

Let's discuss some of the basic IPinfo IP database operations. For this guide, we expect that you are familiar with the Snowflake platform. However, if you need any assistance, [our data experts are happy to guide you](/contact).

**IPinfo Basic UDFs (User-Defined Functions)**

To ease the process of using our database products and enable our users to use the best-performing solutions, we have developed many handy UDFs (User Defined Functions).

🔗 [Snowflake Documentation on UDF](https://docs.snowflake.com/en/sql-reference/user-defined-functions.html).

Our basic UDFs are scalar in nature and output a single value in `TEXT` or multiple values contained within an `ARRAY`.

| User-Defined Functions (UDF) | Description                                                                                                    |     |
| ---------------------------- | -------------------------------------------------------------------------------------------------------------- | --- |
| **`RANGE_TO_CIDR`**          | Converts `start_ip` and `end_ip` columns to their network range / CIDR equivalent. Data outputted as an array. |
| **`RAND_IP`**                | Returns an array of random IPv4 or IPv6 addresses.                                                             |     |
| **`IP_CONTINENT`**           | Returns the continent name for a single IP address lookup.                                                     |     |
| **`COUNT_IP`**               | Counts the IP addresses between the `start_ip` and `end_ip` values.                                            |     |

Additionally, we provide a complimentary table called “COUNTRIES” that includes country codes, country names, and continent names.

**Account and share status and metadata**

For account and listing metadata information, you can use our included UDTFs: `STATUS` and `STATUS_DETAILS`.

**`STATUS`** returns artifact/dataset and account-related information. The returned table contains the following information:

- `ACCT`: Account ID.
- `ORG`: Organization ID.
- `REGION`: Cloud platform and region name.
- `REFRESH_FREQUENCY`: The update frequency of the current dataset/artifact.
- `LAST_ALTERED`: Last alter or update date and time.

```sql
SELECT *
FROM TABLE(IPINFO.PUBLIC.STATUS());
```

![Status table UDF](https://cdn.assets.ipinfo.io/static/images/docs/snowflake/status_udtf.png)

The `IPINFO` is the dataset name.

**`STATUS_DETAILS`** returns the following information for all the resources included in an IPinfo Snowflake dataset:

- `NAME`: Name of the resource
- `TYPE`: Type of the resource
- `REFRESH_FREQUENCY`: The refresh frequency of the resource
- `LAST_ALTERED`: Last alter or update date and time.

```sql
SELECT *
FROM TABLE(IPINFO.PUBLIC.STATUS_DETAILS());
```

![Status Details table UDF](https://cdn.assets.ipinfo.io/static/images/docs/snowflake/status_details_udtf.png)

**Sample IP address table**

With all of our listings, we include the `ip_sample` table, which contains 1,000 sample IP addresses, including 500 IPv4 addresses and 500 IPv6 addresses. You can use these IP addresses for query testing.

![Log data IP sample](https://cdn.assets.ipinfo.io/static/images/docs/snowflake/ip_sample.png)

**IPinfo Query Function**

The IPinfo Query Functions are UDTFs or Table Functions that return tabular data when queried against a specific IP dataset using IP addresses. To enable faster and more efficient IP address lookups from our database, we have developed these UDTFs. These custom functions remove the guesswork from querying our database and ensure best practices.

![UDTF demo](https://cdn.assets.ipinfo.io/static/images/docs/snowflake/UDTF_demo.png)

The query functions are available in the `public` schema of the database listing. When you purchase our listing, you have the option to provide a name for the shared database. You can learn more about this in our [IPinfo community post](https://community.ipinfo.io/t/using-our-daily-updated-databases-on-snowflake/1100#differences-in-data-class-name-2).


If you have purchased our [IP geolocation listing](https://app.snowflake.com/marketplace/listing/GZSTZ3VDMFI/) and named our shared database `ipinfo`, then your functions, views, and tables will be available in the `ipinfo.public` namespace. Here, `ipinfo` is the name of the shared database, and `public` is the schema. To access the `IP_LOCATION` UDTF, you would call `ipinfo.public.ip_location`. Similarly, you can access the `IP_GEOLOCATION` view by calling `ipinfo.public.ip_geolocation`.

If you have access to the database product, you will also have access to the associated UDTFs. Each UDTF corresponds to its respective database.

## Views, UDTFs and Database Names

Reference list for the database names, views/tables, and UDTFs.

**Database Name**: The database name is assigned when you purchase or trial our database listing. We recommend changing the name upon purchasing the database, as the standard database names can be quite long. We are mentioning the standard database names here for reference purposes only.

**View**: This is where our data lives. Please note that composite database listings may contain multiple views as they usually consist of multiple databases.

**Query Function - UDTF**: A table function used to query our IP databases.

**Composite listings**: Some of our listings contain multiple IP databases. They include multiple views and multiple UDTFs under one database. For example: [IPinfo Whois Full Data](https://app.snowflake.com/marketplace/listing/GZSTZ3VDMFY/)

<table>
    <thead>
        <tr>
            <th>Product</th>
            <th>UDTF</th>
            <th>VIEW / TABLE</th>
        </tr>
    </thead>
    <tbody>
    <tr>
        <td><a href="https://app.snowflake.com/marketplace/listing/GZSTZSHKQ55S">IPinfo Lite</a></td>
        <td>GET_IP_LITE</td>
        <td>LITE </td>
    </tr>
    <tr>
        <td><a href="https://app.snowflake.com/marketplace/listing/GZSTZSHKQ56D">IPinfo Core</a></td>
        <td>GET_IP_CORE</td>
        <td>IP_CORE</td>
    </tr>
    <tr>
        <td><a href="https://app.snowflake.com/marketplace/listing/GZSTZSHKQ56H">IPinfo Plus</a></td>
        <td>GET_IP_PLUS</td>
        <td>IP_PLUS</td>
    </tr>
    <tr>
        <td><a href="https://app.snowflake.com/marketplace/listing/GZSTZSHKQ55W">IPinfo Residential Proxy</a></td>
        <td>IP_PROXY_RESIDENTIAL </td>
        <td>IP_PROXY_RESIDENTIAL </td>
    </tr>
    <tr>
        <td><a href="https://app.snowflake.com/marketplace/listing/GZSTZ3VDMFI">IPinfo IP Geolocation</a></td>
        <td>IP_LOCATION </td>
        <td>IP_GEOLOCATION </td>
    </tr>
    <tr>
        <td><a href="https://app.snowflake.com/marketplace/listing/GZSTZ3VDMEX">IPinfo Company IP Address Data</a></td>
        <td>IP_COMPANY </td>
        <td>IP_COMPANY </td>
    </tr>
    <tr>
        <td><a href="https://app.snowflake.com/marketplace/listing/GZSTZ3VDMFU">IPinfo Privacy Detection (VPN, TOR, Relay, Proxy etc.)</a></td>
        <td>IP_PRIVACY </td>
        <td>IP_PRIVACY </td>
    </tr>
    <tr>
        <td><a href="https://app.snowflake.com/marketplace/listing/GZSTZ3VDMFY">Comprehensive IP WHOIS Data</a></td>
        <td></td>
        <td>
        	<ul>
        		<li>IP_WHOIS_NET</li>
            <li>IP_WHOIS_ASN</li>
            <li>IP_WHOIS_MNT</li>
            <li>IP_WHOIS_ORG</li>
            <li>IP_WHOIS_POC</li>
        	</ul>
        </td>
    </tr>
    </tbody>
</table>

Beyond the standard functions, we internally use a handful of helper functions to enhance our core UDTF experience. For example: `TO_INT`, `TO_IP`, `TO_JOIN_KEY`, `TO_IP6`, etc. These functions are not meant to be used in regular operations.

Views, UDTFs and Database Names

## Accessing Our Daily Updated Databases on Snowflake Marketplace


Our standard database listings on Snowflake Marketplace are updated on a monthly basis. However, we offer a daily updated database as part of our offering. Learn more from our [IPinfo community post](https://community.ipinfo.io/t/using-our-daily-updated-databases-on-snowflake/1100).

Our IPinfo Lite data on Snowflake is updated daily and provides full accuracy.

Accessing Our Daily Updated Databases on Snowflake Marketplace

## Joining our database to your database using UDTFs

Our User-Defined Table Functions (UDTFs) provide a highly efficient method for merging our database insights with your log or IP address column. We have presented a list of all the available UDTFs in the preceding section.

For example, let's consider our logs database, which appears as follows:

![joining_database_sample_ip](https://cdn.assets.ipinfo.io/static/images/docs/snowflake/joining_database_sample_ip.png)

`IP_LOCATION` UDTF using the IP to Geolocation database:

```sql
SELECT *
FROM logs l
JOIN TABLE (ipinfo.public.ip_location(l.ip));
```

Result:

![joining_database_sample_ips_enriched_with_ip_location_udtf](https://cdn.assets.ipinfo.io/static/images/docs/snowflake/joining_database_sample_ips_enriched_with_ip_location_udtf.png)

UDTF code Template:

```sql
SELECT *
FROM <db_table> <db_alias>
JOIN TABLE(<ipinfo_database_name>.<ipinfo_schema>.<UDTF_name>(<table_alias>.<column_containing_ip_addresses>));
```

- `<input_db>`: The input database contains IP addresses. It can be a table, view, database, or even a CTE. In the example, it is `logs`.
- `<db_alias>`: Just an alias for the input database. In the example, we used `l`.
- `<ipinfo_database_name>`: The IPinfo database name of the share. It is usually the "Standard Listing Name" we discussed in the "Views, UDTFs, and Database Names" section. But you can also change it to anything you want when purchasing the listing. In the example, it is just `ipinfo`.
- `ipinfo_schema`: Usually, the value is `public`.
- `UDTF_name`: The UDTF you want to use to enrich your log or IP database. In the example, we want to add location information to our IP logs, so we used the `IP_LOCATION` UDTF.
- `<column_containing_ip_addresses>`: The column that contains the IP addresses in your input database. In the example, it is `ip`.

Another example of a UDTF, `IP_HOSTED_DOMAINS` UDTF uses the [IP to Hosted Domains](https://app.snowflake.com/marketplace/listing/GZSTZ3VDMF2/):

```sql
WITH sample_ips (ip) AS (
    SELECT *
    FROM (
        VALUES ('8.8.8.8'),
               ('198.35.26.98')
    )
)
SELECT *
FROM (
    SELECT ip
    FROM sample_ips -- sample log database
) logs
JOIN TABLE (ipinfo.public.ip_hosted_domains(logs.ip));
```

![sample_ips_enriched_with_hosted_domains_udtf](https://cdn.assets.ipinfo.io/static/images/docs/snowflake/sample_ips_enriched_with_hosted_domains_udtf.png)

Let's look at another UDTF, `IP_PRIVACY`, which comes with our [IP to Privacy Detection](https://app.snowflake.com/marketplace/listing/GZSTZ3VDMFU/) database. We will be using our logs table again.

```sql
SELECT *
FROM logs l
JOIN TABLE(ipinfo.public.ip_privacy(l.ip));
```

![identifying_vpn_hosting_tor_proxy_ip_addresses_with_ip_privacy_udtf](https://cdn.assets.ipinfo.io/static/images/docs/snowflake/identifying_vpn_hosting_tor_proxy_ip_addresses_with_ip_privacy_udtf.png)

Please note that even though the logs table contains multiple IP addresses, we can only see a few rows here. That is because the code used performs an INNER JOIN.

Joining our database to your database using UDTFs

## IPinfo Lite - IPinfo's Free IP database on Snowflake Marketplace

With our open access [IPinfo Lite](https://app.snowflake.com/marketplace/listing/GZSTZSHKQ55S)'s `GET_IP_LITE` you can get the country and asn information of IP addresses.

```sql
SELECT *
FROM logs l
JOIN TABLE(GET_IP_LITE(l.ip));
```

![get_ip_lite_udtf](https://cdn.assets.ipinfo.io/static/images/docs/snowflake/get_ip_lite_udtf.png)

Shortcut	Action
`/`	Start search
`G` then `I`	Go to My IP page
`G` then `A`	Go to My ASN page