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

Request

import { parseAPI } from '@parseapi/sdk';

const parse = parseAPI("YOUR_API_KEY");
const result = await parse.ip("8.8.8.8");
console.log(result);
Example responsePaid plan
{
  "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.

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

Request

import { parseAPI } from '@parseapi/sdk';

const parse = parseAPI("YOUR_API_KEY");
const result = await parse.ip.self();
console.log(result);
Example response
{
  "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 tagLanguage
enEnglish
arالعربية
cacatalà
hrhrvatski
csčeština
dadansk
nlNederlands
fisuomi
frfrançais
deDeutsch
elΕλληνικά
heעברית
hiहिन्दी
humagyar
idIndonesia
ititaliano
ja日本語
ko한국어
msMelayu
nbnorsk bokmål
plpolski
ptportuguês
roromână
ruрусский
zh-Hans简体中文
skslovenčina
esespañol
svsvenska
thไทย
zh-Hant繁體中文
trTürkçe
ukукраїнська
viTiếng Việt