NewConnect Claude, Gemini, ChatGPT, and other AI agents to API Ninjas via our MCP server →

IP Lookup API

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

(4.6)

From 3,906 users

1,700+

Applications using this API

API Status

Online - All Systems Operational

API Response Times

Average
P50
P75
P90
P95
307ms342ms349ms725ms1054ms

Didn't find what you were looking for? Suggest an improvement

/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

A JSON object with the following fields or an error if the request is unsuccessful.

  • 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

Try our APIs in the API playground

Sign up for a free API key to get started — no credit card required.

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
{
    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 curl -X GET "https://api.api-ninjas.com/v1/iplookup?address=8.8.8.8" \ -H "X-Api-Key: YOUR_API_KEY"

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.

Frequently Asked Questions

  • Yes, but you must have a premium subscription. Commercial use of the IP Lookup API is not permitted on the free tier. See our pricing page to choose a plan that fits your needs.
  • Sign up for a free account to instantly get your API key, then pass it in the X-Api-Key header on every request. The documentation above includes ready-to-run examples in cURL, Python, JavaScript, Node.js, and more.
  • Your API requests will simply be denied once you hit your monthly quota — you will never be charged more than the plan you signed up for. To increase your quota, you can upgrade your plan any time on our pricing page.
  • The API responds with a standard HTTP status code and a JSON error message describing the problem. See our error codes reference for the full list of codes and how to resolve each one, or contact support if you need help.
  • Yes. The address parameter accepts both IPv4 format (e.g. 73.9.149.180) and IPv6 format (e.g. 2001:0db8:85a3:0000:0000:8a2e:0370:7334). If you need to resolve a hostname or domain instead of an IP, see the DNS Lookup API.
  • The lat, lon, zip, city, and isp fields are premium-only, while fields like country, country_code, region, region_code, timezone, and is_valid are available on all plans. See pricing for details on premium access.
  • A successful lookup returns lat and lon fields containing the geographic coordinates of the IP address location (these are premium-only fields). To convert those coordinates back into a human-readable address, pass them to the Reverse Geocoding API.
  • The region field is the region name where the IP is located, and region_code is its code; in the United States these correspond to the state name and its 2-letter state abbreviation respectively. To geolocate a place name or address instead of an IP, use the Geocoding API.