IPQuery Docs

Home to the main documentation for ipquery.io. IPQuery aims to provide a straightforward and simplistic api for working with ip address's.

Basic Request

GET /

Returns your IP Address.

Defaults the response format to text when fetching your own ip address. If you want to include additional fields checkout the Changing Response Formats section.

Python Example

import requests

req = requests.get("https://api.ipquery.io/")
print(req.text) # Your ip address

Response

1.1.1.1

Query Specific IP Address

GET /1.1.1.1

Returns the ip address queried along with all of the fields.

Defaults the response format to json when querying a specific ip address. To change this checkout the Changing Response Formats section.

Python Example

import requests

req = requests.get("https://api.ipquery.io/1.1.1.1")
print(req.text)

Response

{
    "ip": "1.1.1.1",
    "isp": {
        "asn": "AS13335",
        "org": "Cloudflare, Inc.",
        "isp": "Cloudflare, Inc."
    },
    "location": {
        "country": "Australia",
        "country_code": "AU",
        "city": "Sydney",
        "state": "New South Wales",
        "zipcode": "1001",
        "latitude": -33.854548400186665,
        "longitude": 151.20016200912815,
        "timezone": "Australia/Sydney",
        "localtime": "2024-09-03T22:22:52"
    },
    "risk": {
        "is_mobile": false,
        "is_vpn": false,
        "is_tor": false,
        "is_proxy": false,
        "is_datacenter": true,
        "risk_score": 0
    }
}

Bulk Query A List of IP Address's

IPQuery supports bulk lookups, each address can be seperated with a comma.

The maximum number of allowed lookups in batch mode is capped at 10,000.

GET /1.1.1.1,2.2.2.2

Python Example

import requests

req = requests.get("https://api.ipquery.io/1.1.1.1,2.2.2.2")
print(req.text)

Response Example

[
    {
        "ip": "1.1.1.1",
        "isp": {
            "asn": "AS13335",
            "org": "Cloudflare, Inc.",
            "isp": "Cloudflare, Inc."
        },
        "location": {
            "country": "Australia",
            "country_code": "AU",
            "city": "Sydney",
            "state": "New South Wales",
            "zipcode": "1001",
            "latitude": -33.854548400186665,
            "longitude": 151.20016200912815,
            "timezone": "Australia/Sydney",
            "localtime": "2024-09-03T22:23:42"
        },
        "risk": {
            "is_mobile": false,
            "is_vpn": false,
            "is_tor": false,
            "is_proxy": false,
            "is_datacenter": true,
            "risk_score": 0
        }
    },
    ... // Results for 2.2.2.2
]

Changing Response Formats

IPQuery supports the following response formats:

• Text

• JSON

• YAML

• XML

The response format can be changed by adding the ?format= parameter.

GET /1.1.1.1?format=yaml

Python Example

import requests

req = requests.get("https://api.ipquery.io/1.1.1.1?format=yaml")
print(req.text)

Response

ip: 1.1.1.1
isp:
  asn: AS13335
  org: Cloudflare, Inc.
  isp: Cloudflare, Inc.
location:
  country: Australia
  country_code: AU
  city: Sydney
  state: New South Wales
  zipcode: "1001"
  latitude: -33.854548400186665
  longitude: 151.20016200912815
  timezone: Australia/Sydney
  localtime: 2024-09-03T22:45:50
risk:
  is_mobile: false
  is_vpn: false
  is_tor: false
  is_proxy: false
  is_datacenter: true
  risk_score: 0

GET /1.1.1.1?format=xml

Python Example

import requests

req = requests.get("https://api.ipquery.io/1.1.1.1?format=xml")
print(req.text)

Response

<IPInfo>
    <ip>1.1.1.1</ip>
    <isp>
        <asn>AS13335</asn>
        <org>Cloudflare, Inc.</org>
        <isp>Cloudflare, Inc.</isp>
    </isp>
    <location>
        <country>Australia</country>
        <country_code>AU</country_code>
        <city>Sydney</city>
        <state>New South Wales</state>
        <zipcode>1001</zipcode>
        <latitude>-33.854548400186665</latitude>
        <longitude>151.20016200912815</longitude>
        <timezone>Australia/Sydney</timezone>
        <localtime>2024-09-03T22:51:11</localtime>
    </location>
    <risk>
        <is_datacenter>true</is_datacenter>
    </risk>
</IPInfo>