IP Lookup API

The IP Lookup API provides location information for any valid IP address. It works with both IPv4 and IPv6 addresses.

/v1/iplookup GET

https://api.api-ninjas.com/v1/iplookup

Returns the location of the IP address specified. The response contains both the geographical coordinates (latitude/longitude) as well as the city and country.

Parameters

  • address  required

    IP Address to query. Must be in IPv4 format A.B.C.D(e.g. 73.9.149.180) or IPv6 format X:X:X:X:X:X:X:X(e.g. 2001:0db8:85a3:0000:0000:8a2e:0370:7334).

Headers

  • X-Api-Key  required

    API Key associated with your account.

Response Fields

  • address

    The IP address of the query

  • timezone

    The time zone related to the IP address

  • lat  premium only

    The latitude coordinate of the IP address location

  • lon  premium only

    The longitude coordinate of the IP address location

  • zip  premium only

    The ZIP code of the IP address location

  • city  premium only

    The city where the IP address is located

  • region

    The region name where the IP address is located. In the United States, this is equivalent to the state.

  • region_code

    The region code of the IP address location. In the United States, this is equivalent to the 2-letter state abbreviation.

  • country

    The name of the country where the IP address is located

  • country_code

    The 2-letter country code of the IP address location

  • is_valid

    The validity status of the IP address

  • isp  premium only

    The Internet Service Provider associated with the IP address

Sample Request Live Demo!

address
https://api.api-ninjas.com/v1/iplookup?address=73.9.149.180

Headers

X-Api-KeyLog in or sign up to get your API Key

Sample Response

JSON
1 2 3 4 5 6 7 8 9 10 11 12 13 14 { "is_valid": true, "country": "United States", "country_code": "US", "region_code": "IL", "region": "Illinois", "city": "Chicago", "zip": "60620", "lat": 41.7405, "lon": -87.6587, "timezone": "America/Chicago", "isp": "Comcast Cable Communications, LLC", "address": "73.9.149.180" }

Code Examples

1 2 3 4 5 6 7 8 9 import requests ip_addr = '73.9.149.180' api_url = 'https://api.api-ninjas.com/v1/iplookup?address={}'.format(ip_addr) response = requests.get(api_url, headers={'X-Api-Key': 'YOUR_API_KEY'}) if response.status_code == requests.codes.ok: print(response.text) else: print("Error:", response.status_code, response.text)

If your programming language is not listed in the Code Example above, you can still make API calls by using a HTTP request library written in your programming language and following the above documentation.