Documentation for IPinfo API Service
IPinfo's API services provide a mix of geolocation, ASN, privacy, carrier detection, and confidence metrics across different tiers of API services.
IPinfo Bundle APIs
- IPinfo Lite: A free API with unlimited requests provides general location data (country, country code, continent, continent code) and ASN details (ASN, name, domain).
- IPinfo Core: The IPinfo Core API plan provides detailed IP address information including geolocation (city, region, country, continent, latitude/longitude, timezone, postal code), ASN and ISP details (ASN, name, domain, type), and network characteristics such as anonymity, anycast, hosting, mobile, and satellite status.
- IPinfo Plus: The IPinfo Plus API plan provides comprehensive IP data including full geolocation (city, region, country, continent, coordinates, timezone, postal code, geoname ID, radius, and last change date), ASN details (ASN, name, domain, type), and extensive network characteristics such as mobile, anonymous proxy, relay, Tor, VPN, anycast, hosting, and satellite status.
| Field Name | Description | Example | IPinfo Lite | IPinfo Core | IPinfo Plus | |
|---|---|---|---|---|---|---|
ip | The IP address being queried. | 51.68.57.72 |  | | | |
hostname | The hostname associated with the IP address. | generic.hostname.com | | | | |
geo | city | The city where the IP address is located. | Lille |  | | |
region | The region or state where the IP address is located. | Hauts-de-France | | | | |
region_code | The two-letter region code in ISO 3166 format. | HDF | | | | |
country | The country where the IP address is located. | France | | | | |
country_code | The ISO 3166 country code of the IP address. | FR | | | | |
continent | The continent where the IP address is located. | Europe | | | | |
continent_code | The two-letter continent code. | EU | | | | |
latitude | The latitude coordinate of the IP address location. | 50.63297 | | | | |
longitude | The longitude coordinate of the IP address location. | 3.05858 | | | | |
timezone | The local timezone of the IP address location, formatted according to the IANA Time Zone Database. | Europe/Paris | | | | |
postal_code | The postal or zip code associated with the IP address location. | 59000 | | | | |
dma_code | The Designated Market Area (DMA) code, representing a TV media market region. | 59 | | | | |
geoname_id | The unique numerical identifier for geographic locations from Geonames.org. | 2998324 | | | | |
radius | The location accuracy radius in kilometers. | 200 | | | | |
last_changed | The date when the IP address's location was last updated, in YYYY-MM-DD format (ISO-8601). | 2025-06-15 | | | | |
as | asn | The Autonomous System Number (ASN) identifying the organization that owns or operates the IP address. | AS16276 | | | |
name | The official name of the Autonomous System (AS) organization. | OVH SAS | | | | |
domain | The official domain name of the Autonomous System (AS) organization. | ovhcloud.com | ||||
type | The type of the Autonomous System (AS) organization, such as hosting, ISP, education, government, or business. | hosting | | | | |
last_changed | The date when the IP address's ASN was last updated, in YYYY-MM-DD format (ISO-8601). | 2025-03-09 | | | | |
mobile | name | The name of the mobile carrier organization. | dtac | | | |
mcc | The Mobile Country Code (MCC) of the carrier. | 520 | | | | |
mnc | The Mobile Network Code (MNC) of the carrier. | 05 | | | | |
anonymous | is_proxy | Indicates whether the IP address is an open web proxy. | false | | | |
is_relay | Indicates whether the IP address is part of an anonymous relay service, such as iCloud Private Relay. | false | | | | |
is_tor | Indicates whether the IP address is a TOR (The Onion Router) exit node. | false | | | | |
is_vpn | Indicates whether the IP address is a Virtual Private Network (VPN) exit node. | true | | | | |
name | The name of the privacy service provider, such as a VPN, Proxy, or Relay service provider. | NordVPN | | | | |
is_anonymous | Indicates whether the IP address is anonymous. true if the IP address is associated with an IP privacy service. | false | | | | |
is_anycast | Indicates whether the IP address is an anycast IP. true if the IP address maps to multiple physical servers. | false | | | | |
is_hosting | Indicates whether the IP address is an internet service hosting IP address. | true | | | | |
is_mobile | Indicates whether the IP address belongs to a mobile network. | false | | | | |
is_satellite | Indicates whether the IP address is part of a satellite internet connection. | false | | | | |
Currently, we have the following API services available directly for customers.
- IPinfo Lite: The IPinfo Lite API is our free plan that includes unlimited country-level geolocation and basic ASN information.
- IPinfo Core: Our basic premium API plan that includes detailed geolocation data, ASN information, network flags, and access to the dedicated ASN API.
- IPinfo Plus: IPinfo Plus API provides detailed IP address data, including geolocation, ASN information, carrier details, anonymous IP address data details, and geolocation and ASN change frequency.
- IPinfo Business: Our IPinfo Business plan includes access to various data fields such as ASN, geolocation, privacy, abuse, company, carrier, and limited domains hosted on the IP.
- IPinfo Enterprise: The IPinfo Enterprise plan includes everything in the Business plan plus IP Whois, IP Ranges, IP Activity, and a full list of domains hosted on the IP.
Other IP APIs
Besides providing information about IP Addresses, IPInfo also offers APIs that can be used to get:
- ASN API: Detailed information about ASNs
- IP ranges API: IP ranges owned by a company.
- Hosted Domains API: Domains hosted on an IP address
- IP WHOIS API: Programmatically Access WHOIS Data
- Residential Proxy Detection API: Detection and detailed insights of residential proxy services