IP and Network Intelligence API

IP Geolocation Lookup

locate an IPv4 or IPv6 address and describe the network behind it.

IP Geolocation Lookup
POST

IP Geolocation API — locate an IPv4 or IPv6 address and describe the network behind it. Returns continent, country, state, district, city, postal code and coordinates, plus country metadata (calling code, TLD, languages, flag emoji), the local currency, the full time zone with current offset and DST state, and the network's ASN and owning company. Pass lang to localise place names. ip_address is optional — omit it to look up the IP that called this API. For threat flags, reverse hostname and abuse contacts in the same call, use IP Geolocation Enrichment.

  • Global coverage
  • Real-time ip and network intelligence lookup
  • Structured JSON response
  • POST request with Bearer auth
Get API Key — Free View Full Docs
Endpoint
POST
https://app.way2api.com/api/v1/ip/geolocation

Content-Type: application/json
Authorization: Bearer YOUR_API_KEY

Request Parameters
Parameter Type Required Description
ip_address string No IPv4 or IPv6 address to locate, e.g. 8.8.8.8. Optional — if omitted, the IP that called this API is used.
lang string No Language for location names: en (default), de, ru, ja, fr, cn, es, cs, it, ko, fa, pt.
Request Example
<?php $ch = curl_init(); curl_setopt_array($ch, [ CURLOPT_URL => "https://app.way2api.com/api/v1/ip/geolocation", CURLOPT_RETURNTRANSFER => true, CURLOPT_POST => true, CURLOPT_HTTPHEADER => [ "Authorization: Bearer YOUR_API_KEY", "Content-Type: application/json" ], CURLOPT_POSTFIELDS => json_encode([ "ip_address" => "8.8.8.8" ]) ]); $response = curl_exec($ch); $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE); curl_close($ch); $data = json_decode($response, true); print_r($data);
const response = await fetch("https://app.way2api.com/api/v1/ip/geolocation", { method: "POST", headers: { "Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json" }, body: JSON.stringify({ "ip_address": "8.8.8.8" }) }); if (!response.ok) { throw new Error(`HTTP error: ${response.status}`); } const data = await response.json(); console.log(data);
curl -X POST https://app.way2api.com/api/v1/ip/geolocation \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{\"ip_address\":\"8.8.8.8\"}'
$.ajax({ url: "https://app.way2api.com/api/v1/ip/geolocation", type: "POST", contentType: "application/json", headers: { "Authorization": "Bearer YOUR_API_KEY" }, data: JSON.stringify({ "ip_address": "8.8.8.8" }), success: function(data) { console.log(data); }, error: function(xhr) { console.error(xhr.responseJSON); } });
const { data } = await axios.post( "https://app.way2api.com/api/v1/ip/geolocation", {"ip_address":"8.8.8.8"}, { headers: { "Authorization": "Bearer YOUR_API_KEY" } } ); console.log(data);
import requests response = requests.post( "https://app.way2api.com/api/v1/ip/geolocation", headers={ "Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json" }, json={ "ip_address": "8.8.8.8" } ) print(response.status_code) print(response.json())
Response Example
200 OK Success Response 
{
    "success": true,
    "message": "",
    "data": {
        "order_id": "W2A1739512345abcdef01",
        "result": {
            "ip_address": "8.8.8.8",
            "location": {
                "continent_code": "NA",
                "continent_name": "North America",
                "country_code": "US",
                "country_code3": "USA",
                "country_name": "United States",
                "country_name_official": "United States of America",
                "country_capital": "Washington, D.C.",
                "state": "California",
                "state_code": "US-CA",
                "district": "Santa Clara",
                "city": "Mountain View",
                "postal_code": "94043-1351",
                "latitude": 37.4224,
                "longitude": -122.08421,
                "is_eu": false,
                "geoname_id": "6301403"
            },
            "country_metadata": {
                "calling_code": "+1",
                "tld": ".us",
                "languages": [
                    "en-US",
                    "es-US",
                    "haw",
                    "fr"
                ],
                "flag_emoji": "\ud83c\uddfa\ud83c\uddf8"
            },
            "network": {
                "route": "8.8.8.0/24",
                "connection_type": "",
                "is_anycast": true
            },
            "currency": {
                "code": "USD",
                "name": "US Dollar",
                "symbol": "$"
            },
            "asn": {
                "number": "AS15169",
                "organization": "Google LLC",
                "country": "US",
                "type": "business",
                "domain": "google.com",
                "registry": "ARIN",
                "allocated_on": "2000-03-30"
            },
            "company": {
                "name": "Google LLC",
                "type": "hosting",
                "domain": "google.com"
            },
            "time_zone": {
                "name": "America/Los_Angeles",
                "offset": -8,
                "offset_with_dst": -7,
                "current_time": "2026-08-04 06:33:45.664-0700",
                "abbreviation": "PDT",
                "is_dst": true
            }
        }
    }
}
4xx Error Response 
{
    "success": false,
    "message": "'255.255.255.255' is a reserved (bogon) IP address.",
    "data": {
        "order_id": "W2A1739512345abcdef01",
        "error_code": "Locked"
    }
}
Common Response Codes
Code Meaning
200 OK — Request successful
400 Bad Request — Missing or invalid parameters
401 Unauthorized — Invalid or missing API key
429 Too Many Requests — Rate limit exceeded
500 Server Error — Try again later
Ready to integrate?

Start with free trial API calls. No credit card required.

Get API Key — Free Browse All APIs
Way2API Way2API
Contact Way2API

Login