CTRL+K

Bulk IP Lookup API

POST

https://api.apifreaks.com/v1.0/geolocation/lookup

Sample Responses

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

The response will be an array of objects, with each object containing geolocation lookup data for the corresponding IP address in the request. Each object will include the following fields:

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.
zipcode	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 belong 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.
time_zone.current_time	String	Mandatory	Current time in yyyy-MM-dd HH:mm:ss.SSS+ZZZ format.
time_zone.current_time_unix	Float	Mandatory	Current time in seconds since 1970.
time_zone.is_dst	Boolean	Mandatory	Is the timezone in daylight savings?
time_zone.dst_savings	Number	Mandatory	Total daylight savings.
security.threat_score	Number	Mandatory	IP address's threat score. It ranges from 0 to 100.100 indicates highest threat and vice versa for lower score.
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).