IP Geolocation API
GET
https://api.apifreaks.com/v1.0/geolocation/lookup
Sample Responses
404
423
400
LANGUAGE
Python
PHP
Java
Node
Ruby
$ pip install requests
RESPONSE
Click Test it to start the request and see the response here!
API Response
| Field | Type | Requirement | Description |
|---|---|---|---|
| domain | String | Optional | Domain name that is used to lookup geolocation information. It is not returned if an IP address is used to query IP Geolocation API. |
| ip | String | Mandatory | IP address that is used to lookup geolocation information. |
| hostname | String | Mandatory | Hostname of the IP address used to query IP Geolocation API. |
| continent_code | String | Mandatory | 2-letter code of the continent. |
| continent_name | String | Mandatory | Name of the continent. |
| country_code2 | String | Mandatory | Country code (ISO 3166-1 alpha-2) of the country. |
| country_code3 | String | Mandatory | Country code (ISO 3166-1 alpha-3) of the country. |
| country_name | String | Mandatory | Name of the country. |
| country_capital | String | Mandatory | Name of the country's capital. |
| state_prov | String | Optional | Name of the state/province/region. |
| district | String | Optional | Name of the district or county. |
| city | String | Optional | Name of the city. |
| zip_code | String | Optional | ZIP code of the place. |
| latitude | Float | Mandatory | Latitude of the place. |
| longitude | Float | Mandatory | Longitude of the place. |
| is_eu | Boolean | Mandatory | Is the country belongs to European Union? |
| calling_code | String | Mandatory | Calling code of the country. |
| country_tld | String | Mandatory | Top-level domain of the country. |
| languages | String | Mandatory | Comma-separated list of the languages' codes, spoken in the country. |
| country_flag | String | Mandatory | URL to get the country flag. |
| geoname_id | Number | Mandatory | Geoname ID of the place from geonames.org |
| isp | String | Mandatory | Name of the ISP holding the IP address. |
| connection_type | String | Optional | Type of the connection, consuming the IP address. |
| organization | String | Optional | Name of AS organization holding the IP address. |
| asn | String | Optional | Autonomous system number of the autonomous system, to which IP address belongs to. |
| currency.code | String | Mandatory | Currency code (ISO 4217). |
| currency.name | String | Mandatory | Currency name (ISO 4217). |
| currency.symbol | String | Mandatory | Currency symbol. |
| time_zone.name | String | Mandatory | Name (ISO 8601) of the timezone. |
| time_zone.offset | Number | Mandatory | Timezone offset from UTC. |
| timezone.current_time | String | Mandatory | Current time in 'yyyy-MM-dd HH:mm:ss.SSS+ZZZ' format. |
| timezone.current_time_unix | Float | Mandatory | Current time in seconds since 1970. |
| timezone.is_dst | Boolean | Mandatory | Is the timezone in daylight savings? |
| timezone.dst_savings | Number | Mandatory | Total daylight savings. |
| security.threat_score | Number | Mandatory | IP address's threat score. It ranges from 0 (lowest threat) to 100 (highest threat). |
| security.is_tor | Boolean | Mandatory | Indicates if the IP address is being consumed on a Tor endpoint. |
| security.is_proxy | Boolean | Mandatory | Indicates if the IP address belongs to a proxy network. |
| security.proxy_type | String | Optional | Type of the proxy network if the IP address belongs to a proxy network. |
| security.is_anonymous | Boolean | Mandatory | Indicates if the IP address is being used anonymously. |
| security.is_known_attacker | Boolean | Mandatory | Indicates if the IP address is enlisted as an attacking IP address. |
| security.is_cloud_provider | Boolean | Mandatory | Indicates if the IP address belongs to a cloud provider (computing infrastructure providers). |
| user_agent.userAgentString | String | Mandatory | User-Agent string passed along with the query in the User-Agent header. |
| user_agent.name | String | Mandatory | User-Agent Name. |
| user_agent.type | String | Mandatory | User-Agent Class. |
| user_agent.version | String | Mandatory | User-Agent Version. |
| user_agent.versionMajor | String | Mandatory | User-Agent Version Major. |
| user_agent.device.name | String | Mandatory | Device Name. |
| user_agent.device.type | String | Mandatory | Device Type. |
| user_agent.device.brand | String | Mandatory | Device Brand. |
| user_agent.device.CPU | String | Mandatory | Device CPU Model. |
| user_agent.engine.name | String | Mandatory | Layout Engine Name. |
| user_agent.engine.type | String | Mandatory | Layout Engine Class. |
| user_agent.engine.version | String | Mandatory | Layout Engine Version. |
| user_agent.engine.versionMajor | String | Mandatory | Layout Engine Version Major. |
| user_agent.operatingSystem.name | String | Mandatory | Operating System Name. |
| user_agent.operatingSystem.type | String | Mandatory | Operating System Class. |
| user_agent.operatingSystem.version | String | Mandatory | Operating System Version. |
| user_agent.operatingSystem.versionMajor | String | Mandatory | Operating System Version Major. |