CTRL+K

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
ip	String	Mandatory	The IP address
hostname	String	Optional	The hostname (if available)
location	Object	Mandatory	The location information
country_metadata	Object	Mandatory	The country metadata
network	Object	Mandatory	The network information
currency	Object	Mandatory	The currency information
security	Object	Optional	The security information
abuse	Object	Optional	The abuse information
time_zone	Object	Optional	The time zone information
user_agent	Object	Optional	The user agent information

"location" Object contains the following fields:

Field	Type	Requirement	Description
continent_code	String	Mandatory	The 2-letter continent code
continent_name	String	Mandatory	The continent name
country_code2	String	Mandatory	The 2-letter country code (ISO 3166-1 alpha-2)
country_code3	String	Mandatory	The 3-letter country code (ISO 3166-1 alpha-3)
country_name	String	Mandatory	The common name of the country
country_name_official	String	Mandatory	The official name of the country
country_capital	String	Mandatory	The capital city of the country
state_prov	String	Mandatory	The state or province name
state_code	String	Mandatory	The state or province code
district	String	Mandatory	The district name
city	String	Mandatory	The city name
locality	String	Mandatory	The locality or neighborhood name
accuracy_radius	String	Mandatory	The accuracy radius of the location (Km)
confidence	String	Mandatory	The confidence level of the location
dma_code	String	Optional	The DMA code
zipcode	String	Mandatory	The ZIP code
latitude	String	Mandatory	The latitude coordinate
longitude	String	Mandatory	The longitude coordinate
is_eu	Boolean	Mandatory	Is the country belong to European Union?
country_flag	String	Mandatory	The URL of the country flag image
geoname_id	String	Mandatory	The Geoname ID of the location
country_emoji	String	Mandatory	The emoji of the country

"country_metadata" Object contains the following fields:

Field	Type	Requirement	Description
calling_code	String	Mandatory	The calling code of the country
tld	String	Mandatory	The top level domain of the country
languages	Array	Mandatory	The languages spoken in the country

"network" Object contains the following fields:

Field	Type	Requirement	Description
asn.as_number	String	Mandatory	The AS number
asn.organization	String	Mandatory	The organization name
asn.country	String	Mandatory	The country code
asn.asn_name	String	Mandatory	The ASN name
asn.type	String	Mandatory	The type of the ASN
asn.domain	String	Mandatory	The domain associated with the ASN
asn.date_allocated	String	Mandatory	The date when the ASN was allocated
asn.allocation_status	String	Mandatory	The allocation status of the ASN
asn.num_of_ipv4_routes	String	Mandatory	The number of IPv4 routes associated with the ASN
asn.num_of_ipv6_routes	String	Mandatory	The number of IPv6 routes associated with the ASN
asn.rir	String	Mandatory	The Regional Internet Registry (RIR) of the ASN
connection_type	String	Mandatory	The type of the connection
company.name	String	Mandatory	The name of the company
company.type	String	Mandatory	The type of the company
company.domain	String	Mandatory	The domain associated with the company

"currency" Object contains the following fields:

Field	Type	Requirement	Description
code	String	Mandatory	The code of the currency
name	String	Mandatory	The name of the currency
symbol	String	Mandatory	The symbol of the currency

"security" Object contains the following fields:

Field	Type	Requirement	Description
threat_score	Number	Mandatory	The threat score of the IP address
is_tor	Boolean	Mandatory	The TOR status of the IP address
is_proxy	Boolean	Mandatory	The proxy status of the IP address
proxy_type	String	Mandatory	The type of the proxy
proxy_provider	String	Mandatory	The provider of the proxy
is_anonymous	Boolean	Mandatory	The anonymous status of the IP address
is_known_attacker	Boolean	Mandatory	The known attacker status of the IP address
is_spam	Boolean	Mandatory	The spam status of the IP address
is_bot	Boolean	Mandatory	The bot status of the IP address
is_cloud_provider	Boolean	Mandatory	The cloud provider status of the IP address
cloud_provider	String	Mandatory	The cloud provider of the IP address

"abuse" Object contains the following fields:

Field	Type	Requirement	Description
route	String	Mandatory	The IP range of the abuse contact
country	String	Mandatory	The country code of the abuse contact
handle	String	Mandatory	The handle of the abuse contact
name	String	Mandatory	The name of the abuse contact
organization	String	Mandatory	The organization of the abuse contact
role	String	Mandatory	The role of the abuse contact
kind	String	Mandatory	The kind of the abuse contact
address	String	Mandatory	The address of the abuse contact
emails	Array	Mandatory	The list of email addresses of the abuse contact
phone_numbers	Array	Mandatory	The list of phone numbers of the abuse contact

"timezone" Object contains the following fields:

Field	Type	Requirement	Description
name	String	Mandatory	The name of the time zone
offset	Number	Mandatory	The time difference in hours from UTC
offset_with_dst	Number	Mandatory	The time difference in hours from UTC, including DST
current_time	String	Mandatory	The current time in the specified timezone
current_time_unix	Float	Mandatory	The current time in seconds since 1970
current_tz_abbreviation	String	Mandatory	The abbreviation of the current time zone
current_tz_full_name	String	Mandatory	The full name of the current time zone
standard_tz_abbreviation	String	Mandatory	The abbreviation of the standard time zone
standard_tz_full_name	String	Mandatory	The full name of the standard time zone
is_dst	Boolean	Mandatory	Is the timezone in daylight savings?
dst_savings	Number	Mandatory	Total daylight savings.
dst_exists	Boolean	Mandatory	Indicates whether DST exists in the specified timezone.
dst_tz_abbreviation	String	Mandatory	The abbreviation of the DST timezone.
dst_tz_full_name	String	Mandatory	The full name of the DST timezone.
dst_start.utc_time	String	Optional	The date and time in UTC when DST begins.
dst_start.duration	String	Optional	The time change that occurs when DST starts.
dst_start.gap	Boolean	Optional	Is there a gap when the clocks jump forward or not.
dst_start.date_time_after	String	Optional	The local date and time that immediately follows the start of DST.
dst_start.date_time_before	String	Optional	The local date and time immediately before DST begins.
dst_start.overlap	Boolean	Optional	Whether there is an overlap of time due to clocks being set back when DST starts.
dst_end.utc_time	String	Optional	The date and time in UTC when DST ends.
dst_end.duration	String	Optional	The time change that occurs when DST ends.
dst_end.gap	Boolean	Optional	Is there a gap when the clocks jump backward or not.
dst_end.date_time_after	String	Optional	The local date and time that immediately follows the ends of DST.
dst_end.date_time_before	String	Optional	The local date and time immediately before DST ends.
dst_end.overlap	Boolean	Optional	Whether there is an overlap of time due to clocks being set back when DST ends.

"user_agent" Object contains the following fields:

Field	Type	Requirement	Description
user_agent_string	String	Mandatory	User-Agent string
name	String	Mandatory	The name of the browser
type	String	Mandatory	The type of the browser
version	String	Mandatory	The version of the browser
version_major	String	Mandatory	The major version of the browser
device.name	String	Mandatory	The name of the device
device.type	String	Mandatory	The type of the device
device.brand	String	Mandatory	The brand of the device
device.cpu	String	Mandatory	The cpu of the device
engine.name	String	Mandatory	The name of the engine
engine.type	String	Mandatory	The type of the engine
engine.version	String	Mandatory	The version of the engine
engine.version_major	String	Mandatory	The version major of the engine
operating_system.name	String	Mandatory	The name of the operating system
operating_system.type	String	Mandatory	The type of the operating system
operating_system.version	String	Mandatory	The version of the operating system
operating_system.version_major	String	Mandatory	The version major of the operating system
operating_system.build	String	Mandatory	The build of the operating system