IP Geolocation - JSON endpoint

The API base path is

https://i.pn/json/{query}

{query} can be a single IPv4 address. If you don't supply a query the current IP address will be used.

Parameters

Query parameters (such as custom fields) are appended as GET request parameters, for example:

https://i.pn/json/18.117.174.43?fields=61439

fieldsresponse fields optional

There is no API key required.

Quick test

You can edit this query and experiment with the options

GET
response

Returned data

The API can return the following fields and values

If you don't require all the returned fields, use the GET parameter fields to specify which data should be returned. Separate the fields by comma (fields=status,query,country,city) or use a generated, numeric value (to save bandwidth)

name
description
example
type
query
IP used for the query
202.202.202.202
string
status
success or fail
success
string
type
Residential(1), mobile(3) or hosting(4)
1
int
country
Country name
United States
string
countryCode
Two-letter country code
US
string
countryTier
Country tier
1
string
regionName
Region/state
California
string
city
City
Los Angeles
string
cityId
City id
123
int
stateId
State id
123
int
asn
AS number (RIR)
15169
int
as
AS number and organization, separated by space (RIR). Empty for IP blocks not being announced in BGP tables.
AS15169 Google Inc.
string
mobile
Mobile (cellular) connection
true
bool
proxy
Proxy, VPN or Tor exit address
true
bool
hosting
Hosting, colocated or data center
true
bool
blacklists
IP found in blacklists
["spam","abuse"]
string[]
continent
Continent name
North America
string
continentCode
Two-letter continent code
NA
string
region
Region/state short code (FIPS or ISO)
CA
string
asName
AS name (RIR). Empty for IP blocks not being announced in BGP tables.
GOOGLE
string
zip
Zip code
12345
string
lat
Latitude
27.123
float
lon
Longitude
-27.123
float
timezone
Timezone (tz)
America/Los_Angeles
string
offset
Timezone UTC DST offset in seconds
2000
int
currency
National currency
USD
string
isp
ISP name
Google
string
org
Organization name
Google
string
reverse
Reverse DNS of the IP (can delay response)
ip-01.rip.net
string
district
District (subdivision of city)
Farm District
string
generated fields
query,status,country
https://i.pn/json/{query}?fields=query,status,country
generated numeric
11
https://i.pn/json/{query}?fields=11