Loading
Loading
Fast, reliable, and RESTful JSON API for geolocating IP addresses worldwide. Get detailed location data, network information, and more with a single API call.
The IP Location API allows you to track IP address locations with precision, providing detailed information such as country, region, city, coordinates, postal code, and timezone. Perfect for enhancing user insights, improving geographic analysis, and powering location-based features in your applications.
Pass your API key as the apiKey parameter in every request.
This is version v1.0 of the API.
The following parameters can be used in your API requests. All parameters are passed as query string parameters.
ipoptionalStringIPv4, IPv6, or hostname whose geolocation lookup is required
langoptionalStringdefault: enResponse language. Possible values are:
fieldsoptionalStringComma separated list of fields to be included in the response. For example, `location` includes all location fields, `location.city` is a specific field. See the response fields section for more details.
excludesoptionalStringComma separated list of fields except ip to be excluded in the response
includeoptionalStringPossible values are:
A successful request returns a 200 OK response with a JSON object containing the geolocation data. The response includes the top-level fields listed below. See the response preview on the right for the full JSON structure.
ipThe IP address
hostnameThe hostname (if available)
locationThe location information
country_metadataThe country metadata
networkThe network information
currencyThe currency information
securityThe security information
abuseThe abuse information
time_zoneThe time zone information
user_agentThe user agent information
Contains the following fields:
continent_codeContinent code (e.g. NA, EU)
continent_nameContinent name
country_code2ISO 3166-1 alpha-2 country code
country_code3ISO 3166-1 alpha-3 country code
country_nameCountry name
country_name_officialOfficial country name
country_capitalCountry capital
state_provState or province
state_codeState or province code
districtDistrict
cityCity name
localityLocality
accuracy_radiusAccuracy radius in km
confidenceConfidence level (low, medium, high)
zipcodeZip or postal code
latitudeLatitude coordinate
longitudeLongitude coordinate
is_euWhether the country is in the EU
country_flagURL to the country flag image
geoname_idGeoNames ID
country_emojiCountry emoji flag
dma_codeDMA code (US only)
Contains the following fields:
calling_codeInternational calling code
tldTop-level domain
languagesList of languages spoken
Contains the following fields:
asn.as_numberAutonomous System Number
asn.organizationOrganization name
asn.countryCountry code
asn.asn_nameASN name
asn.typeNetwork type (BUSINESS, ISP, etc.)
asn.domainDomain name
asn.date_allocatedDate allocated
asn.allocation_statusAllocation status
asn.num_of_ipv4_routesNumber of IPv4 routes
asn.num_of_ipv6_routesNumber of IPv6 routes
asn.rirRegional Internet Registry
connection_typeConnection type
company.nameCompany name
company.typeCompany type
company.domainCompany domain
Contains the following fields:
codeCurrency code (ISO 4217)
nameCurrency name
symbolCurrency symbol
Contains the following fields:
threat_scoreThreat score (0-100)
is_torWhether IP is a Tor exit node
is_proxyWhether IP is a proxy
proxy_typeType of proxy (VPN, SOCKS, etc.)
proxy_providerProxy provider name
is_anonymousWhether IP is anonymous
is_known_attackerWhether IP is a known attacker
is_spamWhether IP is a spam source
is_botWhether IP is a bot
is_cloud_providerWhether IP is from a cloud provider
cloud_providerCloud provider name
Contains the following fields:
routeNetwork route (CIDR)
countryCountry code
handleAbuse contact handle
nameContact name
organizationOrganization name
roleContact role
kindContact kind (group, individual)
addressPhysical address
emailsList of email addresses
phone_numbersList of phone numbers
Contains the following fields:
nameTimezone name (IANA)
offsetUTC offset in hours
offset_with_dstUTC offset with DST in hours
current_timeCurrent time in timezone
current_time_unixCurrent time as Unix timestamp
current_tz_abbreviationCurrent timezone abbreviation
current_tz_full_nameCurrent timezone full name
standard_tz_abbreviationStandard timezone abbreviation
standard_tz_full_nameStandard timezone full name
is_dstWhether DST is currently active
dst_savingsDST savings in hours
dst_existsWhether DST exists in this timezone
dst_tz_abbreviationDST timezone abbreviation
dst_tz_full_nameDST timezone full name
dst_startDST start information
dst_endDST end information
Contains the following fields:
user_agent_stringFull user agent string
nameUser agent name
typeUser agent type (Browser, Robot, etc.)
versionVersion number
version_majorMajor version number
deviceDevice information
engineBrowser engine information
operating_systemOperating system information
The API uses standard HTTP status codes to indicate the success or failure of requests. For common status codes like 429 (Too Many Requests), refer to the general API documentation.
The request was unacceptable. Typically due to missing or invalid parameters.
Provided IP address '255.255.255.255' doesn't exist in our database.
'127.0.0.1' is a bogon (Internet Assigned Numbers Authority) IP address.