IP Lookup

GET

api

curl "https://www.osintcat.net/api/ip?query=8.8.8.8" \
     -H "X-API-KEY: YOUR_API_KEY"

import requests

url = "https://www.osintcat.net/api/ip"
params = {"query": "8.8.8.8"}
headers = {"X-API-KEY": "YOUR_API_KEY"}

response = requests.get(url, params=params, headers=headers, timeout=60)
print(response.status_code, response.json())

const response = await fetch("https://www.osintcat.net/api/ip?query=8.8.8.8", {
  headers: { "X-API-KEY": "YOUR_API_KEY" },
});
console.log(response.status, await response.json());

<?php
$curl = curl_init("https://www.osintcat.net/api/ip?query=8.8.8.8");
curl_setopt_array($curl, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ["X-API-KEY: YOUR_API_KEY"],
]);
$response = curl_exec($curl);
$status = curl_getinfo($curl, CURLINFO_RESPONSE_CODE);
curl_close($curl);
echo $status . " " . $response;

package main

import (
    "fmt"
    "io"
    "net/http"
)

func main() {
    req, _ := http.NewRequest("GET", "https://www.osintcat.net/api/ip?query=8.8.8.8", nil)
    req.Header.Set("X-API-KEY", "YOUR_API_KEY")
    resp, err := http.DefaultClient.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()
    body, _ := io.ReadAll(resp.Body)
    fmt.Println(resp.StatusCode, string(body))
}

{
  "ipleaks": {
    "ip_str": "8.8.8.8",
    "ports": [
      53,
      443
    ],
    "hostnames": [
      "dns.google"
    ],
    "org": "Google LLC"
  },
  "ipinfo": {
    "ipAddress": "8.8.8.8",
    "countryName": "United States of America",
    "countryCode": "US",
    "cityName": "Mountain View",
    "asn": "15169",
    "asnOrganization": "Google LLC"
  }
}

Returns what is known about an IP address: open ports and services seen on it, hostnames, and its location and network.

Results for the same address may come from a cache for up to two days.

Parameters

string

required

An IPv4 or IPv6 address.

Headers

string

required

Your API key.

Usage

Counts as one lookup against your plan’s daily allowance (Max: unlimited). When the allowance is used up, the lookup can continue at a per-lookup price charged to your balance (the module’s page in the dashboard shows the price); a lookup that finds nothing is not charged.

Example request

curl "https://www.osintcat.net/api/ip?query=8.8.8.8" \
     -H "X-API-KEY: YOUR_API_KEY"

import requests

url = "https://www.osintcat.net/api/ip"
params = {"query": "8.8.8.8"}
headers = {"X-API-KEY": "YOUR_API_KEY"}

response = requests.get(url, params=params, headers=headers, timeout=60)
print(response.status_code, response.json())

const response = await fetch("https://www.osintcat.net/api/ip?query=8.8.8.8", {
  headers: { "X-API-KEY": "YOUR_API_KEY" },
});
console.log(response.status, await response.json());

<?php
$curl = curl_init("https://www.osintcat.net/api/ip?query=8.8.8.8");
curl_setopt_array($curl, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ["X-API-KEY: YOUR_API_KEY"],
]);
$response = curl_exec($curl);
$status = curl_getinfo($curl, CURLINFO_RESPONSE_CODE);
curl_close($curl);
echo $status . " " . $response;

package main

import (
    "fmt"
    "io"
    "net/http"
)

func main() {
    req, _ := http.NewRequest("GET", "https://www.osintcat.net/api/ip?query=8.8.8.8", nil)
    req.Header.Set("X-API-KEY", "YOUR_API_KEY")
    resp, err := http.DefaultClient.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()
    body, _ := io.ReadAll(resp.Body)
    fmt.Println(resp.StatusCode, string(body))
}

SDK example

The same request with the official SDKs. Each one reads your key from OSINTCAT_API_KEY.

import { OsintCatClient } from "osintcat";

const client = new OsintCatClient(); // reads OSINTCAT_API_KEY

const result = await client.ip.lookup({
    query: "8.8.8.8"
});
console.log(result);

from osintcat import OsintCat

client = OsintCat()  # reads OSINTCAT_API_KEY

result = client.ip.lookup(
    query="8.8.8.8",
)
print(result)

package main

import (
	"context"
	"fmt"

	osintcat "github.com/OsintCatHQ/osintcat-go"
	osintcatclient "github.com/OsintCatHQ/osintcat-go/client"
)

func main() {
	client := osintcatclient.NewClient() // reads OSINTCAT_API_KEY
	request := &osintcat.LookupIPRequest{
		Query: "8.8.8.8",
	}
	result, err := client.IP.Lookup(context.Background(), request)
	if err != nil {
		panic(err)
	}
	fmt.Printf("%+v\n", result)
}

<?php
require __DIR__ . '/vendor/autoload.php';

use OsintCat\OsintCatClient;
use OsintCat\Ip\Requests\LookupIpRequest;

$client = new OsintCatClient(); // reads OSINTCAT_API_KEY

$result = $client->ip->lookup(
    new LookupIpRequest([
        'query' => '8.8.8.8',
    ]),
);
echo json_encode($result, JSON_PRETTY_PRINT), PHP_EOL;

Response

object

Services seen on the address: open ports, banners, hostnames, known vulnerabilities. {"error": "No information available for that IP."} when nothing was seen.

object

Location and network: country, region, city, coordinates, time zone, ASN and organisation.

{
  "ipleaks": {
    "ip_str": "8.8.8.8",
    "ports": [
      53,
      443
    ],
    "hostnames": [
      "dns.google"
    ],
    "org": "Google LLC"
  },
  "ipinfo": {
    "ipAddress": "8.8.8.8",
    "countryName": "United States of America",
    "countryCode": "US",
    "cityName": "Mountain View",
    "asn": "15169",
    "asnOrganization": "Google LLC"
  }
}

Errors

See Errors for the responses every endpoint can return.

curl "https://www.osintcat.net/api/ip?query=8.8.8.8" \
     -H "X-API-KEY: YOUR_API_KEY"

import requests

url = "https://www.osintcat.net/api/ip"
params = {"query": "8.8.8.8"}
headers = {"X-API-KEY": "YOUR_API_KEY"}

response = requests.get(url, params=params, headers=headers, timeout=60)
print(response.status_code, response.json())

const response = await fetch("https://www.osintcat.net/api/ip?query=8.8.8.8", {
  headers: { "X-API-KEY": "YOUR_API_KEY" },
});
console.log(response.status, await response.json());

<?php
$curl = curl_init("https://www.osintcat.net/api/ip?query=8.8.8.8");
curl_setopt_array($curl, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ["X-API-KEY: YOUR_API_KEY"],
]);
$response = curl_exec($curl);
$status = curl_getinfo($curl, CURLINFO_RESPONSE_CODE);
curl_close($curl);
echo $status . " " . $response;

package main

import (
    "fmt"
    "io"
    "net/http"
)

func main() {
    req, _ := http.NewRequest("GET", "https://www.osintcat.net/api/ip?query=8.8.8.8", nil)
    req.Header.Set("X-API-KEY", "YOUR_API_KEY")
    resp, err := http.DefaultClient.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()
    body, _ := io.ReadAll(resp.Body)
    fmt.Println(resp.StatusCode, string(body))
}

{
  "ipleaks": {
    "ip_str": "8.8.8.8",
    "ports": [
      53,
      443
    ],
    "hostnames": [
      "dns.google"
    ],
    "org": "Google LLC"
  },
  "ipinfo": {
    "ipAddress": "8.8.8.8",
    "countryName": "United States of America",
    "countryCode": "US",
    "cityName": "Mountain View",
    "asn": "15169",
    "asnOrganization": "Google LLC"
  }
}

Overview

Account

Breach & Leak Data

Machine Viewer

E-mail, Phone & Network

Social & Developer Profiles

Gaming

Link Resolvers

Vehicles & Public Records

Currently Unavailable

Parameters

Headers

Usage

Example request

SDK example

Response

Errors

​Parameters

​Headers

​Usage

​Example request

​SDK example

​Response

​Errors

Parameters

Headers

Usage

Example request

SDK example

Response

Errors