Reveal Company

Reveal the company behind an IP address

curl --request POST \
  --url https://api.tamradar.com/v1/company-reveal \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "ip": "17.253.144.10"
}
'

import requests

url = "https://api.tamradar.com/v1/company-reveal"

payload = { "ip": "17.253.144.10" }
headers = {
    "x-api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({ip: '17.253.144.10'})
};

fetch('https://api.tamradar.com/v1/company-reveal', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.tamradar.com/v1/company-reveal",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'ip' => '17.253.144.10'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

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

func main() {

	url := "https://api.tamradar.com/v1/company-reveal"

	payload := strings.NewReader("{\n  \"ip\": \"17.253.144.10\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-api-key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.tamradar.com/v1/company-reveal")
  .header("x-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"ip\": \"17.253.144.10\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.tamradar.com/v1/company-reveal")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"ip\": \"17.253.144.10\"\n}"

response = http.request(request)
puts response.read_body

{
  "status": "success",
  "code": 200,
  "timestamp": "2026-10-13T09:00:00Z",
  "request_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
  "data": {
    "ip": "17.253.144.10",
    "ip_geo": {
      "city": "Cupertino",
      "state": "California",
      "country": "United States"
    },
    "companies": [
      {
        "domain": "apple.com",
        "name": "Apple Inc",
        "profile_url": "https://www.linkedin.com/company/apple",
        "industry": "Consumer Product Manufacturing",
        "employees_count": 166000,
        "country": "United States"
      }
    ]
  },
  "usage": {
    "total_usd": 0.05,
    "balance_remaining_usd": 124.95
  }
}

POST

company-reveal

Reveal the company behind an IP address

curl --request POST \
  --url https://api.tamradar.com/v1/company-reveal \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "ip": "17.253.144.10"
}
'

import requests

url = "https://api.tamradar.com/v1/company-reveal"

payload = { "ip": "17.253.144.10" }
headers = {
    "x-api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({ip: '17.253.144.10'})
};

fetch('https://api.tamradar.com/v1/company-reveal', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.tamradar.com/v1/company-reveal",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'ip' => '17.253.144.10'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

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

func main() {

	url := "https://api.tamradar.com/v1/company-reveal"

	payload := strings.NewReader("{\n  \"ip\": \"17.253.144.10\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-api-key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.tamradar.com/v1/company-reveal")
  .header("x-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"ip\": \"17.253.144.10\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.tamradar.com/v1/company-reveal")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"ip\": \"17.253.144.10\"\n}"

response = http.request(request)
puts response.read_body

{
  "status": "success",
  "code": 200,
  "timestamp": "2026-10-13T09:00:00Z",
  "request_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
  "data": {
    "ip": "17.253.144.10",
    "ip_geo": {
      "city": "Cupertino",
      "state": "California",
      "country": "United States"
    },
    "companies": [
      {
        "domain": "apple.com",
        "name": "Apple Inc",
        "profile_url": "https://www.linkedin.com/company/apple",
        "industry": "Consumer Product Manufacturing",
        "employees_count": 166000,
        "country": "United States"
      }
    ]
  },
  "usage": {
    "total_usd": 0.05,
    "balance_remaining_usd": 124.95
  }
}

Send one public IPv4 or IPv6 address and get back the companies behind it and its approximate location. For pricing and best practices, see the Website Visitor Reveal guide.

Website Visitor Reveal must be enabled for your account. Existing customers can request access at support@tamradar.com.

curl -X POST "https://api.tamradar.com/v1/company-reveal" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"ip": "17.253.144.10"}'

Match or no match

Every lookup returns a final answer within 25 seconds. Both outcomes return 200. Check data.companies:

if (response.data.companies.length > 0) {
  // Match: one lookup charge, shown in usage.total_usd
} else {
  // No match: free
}

A company’s country is its headquarters country; the visitor’s approximate location is in data.ip_geo, which can be null.
domain is always present; other company fields are null when unknown.

Request rules

Send only ip in the JSON body. Private and reserved addresses, ports, URLs and CIDR ranges return 400.
Use exactly POST https://api.tamradar.com/v1/company-reveal, with no query parameters or trailing slash.

Authorizations

x-api-key

string

header

required

Body

application/json

JSON object containing only ip. Maximum 2048 bytes.

string

required

One public IPv4 or IPv6 address. Private, reserved, loopback, link-local and multicast addresses are rejected, as are ports, URLs, CIDR ranges and zone IDs.

Maximum string length: 45

Example:

"17.253.144.10"

Response

Lookup completed. An empty companies array means no company was found; that lookup is free.

status

enum<string>

required

Available options:

success

code

enum<integer>

required

Available options:

200

timestamp

string<date-time>

required

request_id

string<uuid>

required

Identifier for this lookup. Quote it to support.

data

object

required

Show child attributes

usage

object

required

Show child attributes

Introduction / Overview

Getting Started

Core Guides

Agentic Setup

API Reference

Bulk

Website Visitor Reveal

Webhooks

Match or no match

Request rules

Authorizations

Body

Response

​Match or no match

​Request rules

Authorizations

Body

Response

Match or no match

Request rules