IP Address API
Where an IP is from, country, ASN, network.
Look up where an IP is coming from. Country, continent, ASN, and network name come back in the core response. IPv4 and IPv6.
Paid plans automatically include datacenter, relay, and Tor flags, plus state and city where the network operator publishes them.
LookupCopy link
GET /ip/{ip}API Explorer ↗Country, continent and ASN. Paid plans include available location detail and flags
Parameters
- ipstring · path · required
IPv4 or IPv6 address
- langstring · query · optional
Display language as one BCP 47 tag, such as fr or zh-Hant. Changes supported display labels only; IDs, codes, native names, facts, parsing and deep access stay unchanged. Omit for the original response. Unsupported regions use the supported language base; unsupported languages or scripts use English. Missing labels retain their source value. Accept-Language is not read automatically. Available on the current API contract; frozen 1.0.0 is unchanged.
Length: 2 to 64 characters
import { parseAPI } from '@parseapi/sdk';
const parse = parseAPI("YOUR_API_KEY");
const result = await parse.ip("8.8.8.8");
console.log(result);{
"ip": "8.8.8.8",
"country": "US",
"country_name": "United States",
"continent": "NA",
"asn": "AS15169",
"asn_name": "Google LLC",
"city": null,
"state": null,
"registry": "arin",
"datacenter": false,
"relay": false,
"tor": false,
"vpn": false,
"provider": null
}Response fields
- ipLink to ipstring
- Queried IP address
- countryLink to countrystring or null
- ISO 3166-1 alpha-2 code
- country_nameLink to country_namestring or null
- Country name
- continentLink to continentstring or null
- Continent code
- asnLink to asnstring or null
- Autonomous system number
- asn_nameLink to asn_namestring or null
- Network operator / organization name
Your IPCopy link
GET /ip returns the IP that made the request. No key needed.
GET /ipAPI Explorer ↗Same lookup, using the caller's address. No key needed
Parameters
- langstring · query · optional
Display language as one BCP 47 tag, such as fr or zh-Hant. Changes supported display labels only; IDs, codes, native names, facts, parsing and deep access stay unchanged. Omit for the original response. Unsupported regions use the supported language base; unsupported languages or scripts use English. Missing labels retain their source value. Accept-Language is not read automatically. Available on the current API contract; frozen 1.0.0 is unchanged.
Length: 2 to 64 characters
import { parseAPI } from '@parseapi/sdk';
const parse = parseAPI("YOUR_API_KEY");
const result = await parse.ip.self();
console.log(result);{
"ip": "203.0.113.10",
"country": "US",
"country_name": "United States",
"continent": "NA",
"asn": "AS15169",
"asn_name": "Google LLC"
}Included dataCopy link
Paid. State and city are included where known. The flags identify cloud or CDN address space (datacenter), privacy relay egress (relay), and known Tor exits (tor). A false flag is not proof of a residential connection.
Paid plan fields
- state_nameLink to state_namestring or null
- Supported state or province name, matching deep.state and the response country
- postalLink to postalstring or null
- Supported operator-declared range postal code; string preserves leading zeros. Null when unknown
- latitudeLink to latitudenumber or null
- Approximate range latitude in decimal degrees; not device GPS. Null when unsupported
- longitudeLink to longitudenumber or null
- Approximate range longitude in decimal degrees; not device GPS. Null when unsupported
- timezoneLink to timezonestring or null
- Supported IANA timezone for the approximate location; null when unknown
- networkLink to networkstring or null
- Selected routed CIDR, or null when unavailable
- asn_typeLink to asn_typestring or null
- Origin AS category: isp, hosting, business, education or government; null when unknown. Not subscriber connection technology
- proxyLink to proxyboolean or null
- Recent known public proxy exit. false means unlisted; null means incomplete evidence for the cached block
- stateLink to statestring or null
- Supported state / province code. Null when unavailable. Broader geography does not imply a city or county
- cityLink to citystring or null
- Supported approximate city. Null when unavailable
- countyLink to countystring or null
- Supported administrative county code, qualified by country. U.S. counties use FIPS. Omitted when unavailable
- county_nameLink to county_namestring or null
- Name of the supported administrative county. Omitted when unavailable
- census_divisionLink to census_divisionstring or null
- Supported U.S. Census division. Omitted when unavailable
- census_regionLink to census_regionstring or null
- Supported U.S. Census region. Omitted when unavailable
- registryLink to registrystring or null
- Regional internet registry (arin, ripencc, apnic, lacnic, afrinic)
- datacenterLink to datacenterboolean
- Cloud or CDN address space (AWS, GCP, Azure, Oracle, Cloudflare, Fastly, DigitalOcean, Linode, Vultr)
- relayLink to relayboolean
- Privacy relay egress (Apple iCloud Private Relay)
- torLink to torboolean
- Known Tor exit node
- vpnLink to vpnboolean
- Published egress of a commercial VPN provider we track. false means not on our list, never proof of a home connection
- providerLink to providerstring or null
- Provider behind the flag (aws, gcp, azure, oracle, cloudflare, fastly, digitalocean, linode, vultr, apple, mullvad, nordvpn, pia)
Display languageCopy link
Pass lang with a language tag such as fr, pt-BR, or zh-Hant. Existing country_name. IP addresses, network names and source city text stay unchanged.
Omitting lang preserves the original response. Codes, IDs, numeric facts and native-name fields stay unchanged. Missing translations keep their existing source value; unknown values stay null. A preserved name_local may equal the translated name.
Send a chosen browser preference explicitly, for example { lang: navigator.language } in your JavaScript SDK options. The API does not read Accept-Language automatically. Unsupported regions fall back to their supported base language; unsupported languages or scripts use English. Empty, invalid or repeated tags return 400.
Content-Language identifies languages used in translated display fields and known English fallbacks. Display language is available on API 2.1.0; requests selecting frozen 1.0.0 retain their original contract. See API versions.
33 display language choices
| Language tag | Language |
|---|---|
| en | English |
| ar | العربية |
| ca | català |
| hr | hrvatski |
| cs | čeština |
| da | dansk |
| nl | Nederlands |
| fi | suomi |
| fr | français |
| de | Deutsch |
| el | Ελληνικά |
| he | עברית |
| hi | हिन्दी |
| hu | magyar |
| id | Indonesia |
| it | italiano |
| ja | 日本語 |
| ko | 한국어 |
| ms | Melayu |
| nb | norsk bokmål |
| pl | polski |
| pt | português |
| ro | română |
| ru | русский |
| zh-Hans | 简体中文 |
| sk | slovenčina |
| es | español |
| sv | svenska |
| th | ไทย |
| zh-Hant | 繁體中文 |
| tr | Türkçe |
| uk | українська |
| vi | Tiếng Việt |