Phone OSINT

GET

api

phone-osint

curl "https://www.osintcat.net/api/phone-osint?query=%2B4915112345678" \
     -H "X-API-KEY: YOUR_API_KEY"

import requests

url = "https://www.osintcat.net/api/phone-osint"
params = {"query": "+4915112345678"}
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/phone-osint?query=%2B4915112345678", {
  headers: { "X-API-KEY": "YOUR_API_KEY" },
});
console.log(response.status, await response.json());

<?php
$curl = curl_init("https://www.osintcat.net/api/phone-osint?query=%2B4915112345678");
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/phone-osint?query=%2B4915112345678", 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))
}

{
  "module": "phone",
  "query": "+4915112345678",
  "found": true,
  "risk": {
    "score": 12,
    "level": "low"
  },
  "summary": [
    {
      "label": "Number",
      "value": "+4915112345678"
    },
    {
      "label": "Valid number",
      "value": "Yes"
    },
    {
      "label": "Carrier",
      "value": "Telekom Deutschland"
    },
    {
      "label": "Line type",
      "value": "Mobile"
    }
  ],
  "sections": [],
  "raw": {},
  "_meta": {
    "plan": "investigator",
    "lookups_left": 740
  }
}

Returns what is known about a phone number: whether it is valid, the carrier and line type, the country, linked online accounts and a risk score.

Parameters

string

required

The phone number in international format, e.g. +4915112345678. Spaces and dashes are allowed.

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/phone-osint?query=%2B4915112345678" \
     -H "X-API-KEY: YOUR_API_KEY"

import requests

url = "https://www.osintcat.net/api/phone-osint"
params = {"query": "+4915112345678"}
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/phone-osint?query=%2B4915112345678", {
  headers: { "X-API-KEY": "YOUR_API_KEY" },
});
console.log(response.status, await response.json());

<?php
$curl = curl_init("https://www.osintcat.net/api/phone-osint?query=%2B4915112345678");
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/phone-osint?query=%2B4915112345678", 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.phone.lookup({
    query: "+4915112345678"
});
console.log(result);

from osintcat import OsintCat

client = OsintCat()  # reads OSINTCAT_API_KEY

result = client.phone.lookup(
    query="+4915112345678",
)
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.LookupPhoneRequest{
		Query: "+4915112345678",
	}
	result, err := client.Phone.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\Phone\Requests\LookupPhoneRequest;

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

$result = $client->phone->lookup(
    new LookupPhoneRequest([
        'query' => '+4915112345678',
    ]),
);
echo json_encode($result, JSON_PRETTY_PRINT), PHP_EOL;

Response

string

Always phone.

string

The number in E.164 format.

boolean

Whether anything was found.

object

Risk assessment.

Show properties

number

Score from 0 to 100, or null.

string

low, medium, high or unknown.

array

The main facts as {label, value} pairs.

array

Detailed findings, grouped (carrier, location, linked accounts …).

object

The full answer the summary is built from.

object

Your usage after this request (plan, lookups_left).

{
  "module": "phone",
  "query": "+4915112345678",
  "found": true,
  "risk": {
    "score": 12,
    "level": "low"
  },
  "summary": [
    {
      "label": "Number",
      "value": "+4915112345678"
    },
    {
      "label": "Valid number",
      "value": "Yes"
    },
    {
      "label": "Carrier",
      "value": "Telekom Deutschland"
    },
    {
      "label": "Line type",
      "value": "Mobile"
    }
  ],
  "sections": [],
  "raw": {},
  "_meta": {
    "plan": "investigator",
    "lookups_left": 740
  }
}

Errors

Status	Error	When
400	`phone_*`	The number cannot be a valid phone number; `code` says why (e.g. `phone_too_short`).
424	`Upstream provider error`	The lookup could not be completed.
424	`The request timed out.`	The lookup took too long.

See Errors for the responses every endpoint can return.

curl "https://www.osintcat.net/api/phone-osint?query=%2B4915112345678" \
     -H "X-API-KEY: YOUR_API_KEY"

import requests

url = "https://www.osintcat.net/api/phone-osint"
params = {"query": "+4915112345678"}
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/phone-osint?query=%2B4915112345678", {
  headers: { "X-API-KEY": "YOUR_API_KEY" },
});
console.log(response.status, await response.json());

<?php
$curl = curl_init("https://www.osintcat.net/api/phone-osint?query=%2B4915112345678");
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/phone-osint?query=%2B4915112345678", 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))
}

{
  "module": "phone",
  "query": "+4915112345678",
  "found": true,
  "risk": {
    "score": 12,
    "level": "low"
  },
  "summary": [
    {
      "label": "Number",
      "value": "+4915112345678"
    },
    {
      "label": "Valid number",
      "value": "Yes"
    },
    {
      "label": "Carrier",
      "value": "Telekom Deutschland"
    },
    {
      "label": "Line type",
      "value": "Mobile"
    }
  ],
  "sections": [],
  "raw": {},
  "_meta": {
    "plan": "investigator",
    "lookups_left": 740
  }
}

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