Create Company Radar

Create a company radar

curl --request POST \
  --url https://api.tamradar.com/v1/radars/companies \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "domain": "stripe.com",
  "radar_type": "company_new_hires",
  "webhook_url": "https://webhook.site/your-webhook-id",
  "departments": [
    "Engineering",
    "Product Management"
  ],
  "seniorities": [
    "Senior",
    "Manager"
  ],
  "profile_url": "https://www.linkedin.com/company/stripe",
  "custom_fields": {
    "campaign_id": "q4-2024-hiring",
    "priority": "high"
  }
}
'

import requests

url = "https://api.tamradar.com/v1/radars/companies"

payload = {
    "domain": "stripe.com",
    "radar_type": "company_new_hires",
    "webhook_url": "https://webhook.site/your-webhook-id",
    "departments": ["Engineering", "Product Management"],
    "seniorities": ["Senior", "Manager"],
    "profile_url": "https://www.linkedin.com/company/stripe",
    "custom_fields": {
        "campaign_id": "q4-2024-hiring",
        "priority": "high"
    }
}
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({
    domain: 'stripe.com',
    radar_type: 'company_new_hires',
    webhook_url: 'https://webhook.site/your-webhook-id',
    departments: ['Engineering', 'Product Management'],
    seniorities: ['Senior', 'Manager'],
    profile_url: 'https://www.linkedin.com/company/stripe',
    custom_fields: {campaign_id: 'q4-2024-hiring', priority: 'high'}
  })
};

fetch('https://api.tamradar.com/v1/radars/companies', 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/radars/companies",
  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([
    'domain' => 'stripe.com',
    'radar_type' => 'company_new_hires',
    'webhook_url' => 'https://webhook.site/your-webhook-id',
    'departments' => [
        'Engineering',
        'Product Management'
    ],
    'seniorities' => [
        'Senior',
        'Manager'
    ],
    'profile_url' => 'https://www.linkedin.com/company/stripe',
    'custom_fields' => [
        'campaign_id' => 'q4-2024-hiring',
        'priority' => 'high'
    ]
  ]),
  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/radars/companies"

	payload := strings.NewReader("{\n  \"domain\": \"stripe.com\",\n  \"radar_type\": \"company_new_hires\",\n  \"webhook_url\": \"https://webhook.site/your-webhook-id\",\n  \"departments\": [\n    \"Engineering\",\n    \"Product Management\"\n  ],\n  \"seniorities\": [\n    \"Senior\",\n    \"Manager\"\n  ],\n  \"profile_url\": \"https://www.linkedin.com/company/stripe\",\n  \"custom_fields\": {\n    \"campaign_id\": \"q4-2024-hiring\",\n    \"priority\": \"high\"\n  }\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/radars/companies")
  .header("x-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"domain\": \"stripe.com\",\n  \"radar_type\": \"company_new_hires\",\n  \"webhook_url\": \"https://webhook.site/your-webhook-id\",\n  \"departments\": [\n    \"Engineering\",\n    \"Product Management\"\n  ],\n  \"seniorities\": [\n    \"Senior\",\n    \"Manager\"\n  ],\n  \"profile_url\": \"https://www.linkedin.com/company/stripe\",\n  \"custom_fields\": {\n    \"campaign_id\": \"q4-2024-hiring\",\n    \"priority\": \"high\"\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.tamradar.com/v1/radars/companies")

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  \"domain\": \"stripe.com\",\n  \"radar_type\": \"company_new_hires\",\n  \"webhook_url\": \"https://webhook.site/your-webhook-id\",\n  \"departments\": [\n    \"Engineering\",\n    \"Product Management\"\n  ],\n  \"seniorities\": [\n    \"Senior\",\n    \"Manager\"\n  ],\n  \"profile_url\": \"https://www.linkedin.com/company/stripe\",\n  \"custom_fields\": {\n    \"campaign_id\": \"q4-2024-hiring\",\n    \"priority\": \"high\"\n  }\n}"

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

{
  "status": "success",
  "code": 201,
  "timestamp": "2024-03-20T10:15:30.000Z",
  "message": "Radar created successfully",
  "data": {
    "radar_id": "759199a6-5817-4a7d-b812-66abe65f3ce2",
    "radar_type": "company_new_hires",
    "domain": "stripe.com",
    "webhook_url": "https://webhook.site/your-webhook-id",
    "radar_status": "active",
    "created_at": "2024-03-20T10:15:30.000Z",
    "deactivated_at": null,
    "next_charge_at": "2024-04-20T10:15:30.000Z",
    "custom_fields": {
      "campaign_id": "q4-2024-hiring",
      "priority": "high"
    },
    "departments": [
      "Engineering",
      "Product Management"
    ],
    "seniorities": [
      "Senior",
      "Manager"
    ],
    "profile_url": "https://www.linkedin.com/company/stripe"
  }
}

POST

radars

companies

Create a company radar

curl --request POST \
  --url https://api.tamradar.com/v1/radars/companies \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "domain": "stripe.com",
  "radar_type": "company_new_hires",
  "webhook_url": "https://webhook.site/your-webhook-id",
  "departments": [
    "Engineering",
    "Product Management"
  ],
  "seniorities": [
    "Senior",
    "Manager"
  ],
  "profile_url": "https://www.linkedin.com/company/stripe",
  "custom_fields": {
    "campaign_id": "q4-2024-hiring",
    "priority": "high"
  }
}
'

import requests

url = "https://api.tamradar.com/v1/radars/companies"

payload = {
    "domain": "stripe.com",
    "radar_type": "company_new_hires",
    "webhook_url": "https://webhook.site/your-webhook-id",
    "departments": ["Engineering", "Product Management"],
    "seniorities": ["Senior", "Manager"],
    "profile_url": "https://www.linkedin.com/company/stripe",
    "custom_fields": {
        "campaign_id": "q4-2024-hiring",
        "priority": "high"
    }
}
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({
    domain: 'stripe.com',
    radar_type: 'company_new_hires',
    webhook_url: 'https://webhook.site/your-webhook-id',
    departments: ['Engineering', 'Product Management'],
    seniorities: ['Senior', 'Manager'],
    profile_url: 'https://www.linkedin.com/company/stripe',
    custom_fields: {campaign_id: 'q4-2024-hiring', priority: 'high'}
  })
};

fetch('https://api.tamradar.com/v1/radars/companies', 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/radars/companies",
  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([
    'domain' => 'stripe.com',
    'radar_type' => 'company_new_hires',
    'webhook_url' => 'https://webhook.site/your-webhook-id',
    'departments' => [
        'Engineering',
        'Product Management'
    ],
    'seniorities' => [
        'Senior',
        'Manager'
    ],
    'profile_url' => 'https://www.linkedin.com/company/stripe',
    'custom_fields' => [
        'campaign_id' => 'q4-2024-hiring',
        'priority' => 'high'
    ]
  ]),
  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/radars/companies"

	payload := strings.NewReader("{\n  \"domain\": \"stripe.com\",\n  \"radar_type\": \"company_new_hires\",\n  \"webhook_url\": \"https://webhook.site/your-webhook-id\",\n  \"departments\": [\n    \"Engineering\",\n    \"Product Management\"\n  ],\n  \"seniorities\": [\n    \"Senior\",\n    \"Manager\"\n  ],\n  \"profile_url\": \"https://www.linkedin.com/company/stripe\",\n  \"custom_fields\": {\n    \"campaign_id\": \"q4-2024-hiring\",\n    \"priority\": \"high\"\n  }\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/radars/companies")
  .header("x-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"domain\": \"stripe.com\",\n  \"radar_type\": \"company_new_hires\",\n  \"webhook_url\": \"https://webhook.site/your-webhook-id\",\n  \"departments\": [\n    \"Engineering\",\n    \"Product Management\"\n  ],\n  \"seniorities\": [\n    \"Senior\",\n    \"Manager\"\n  ],\n  \"profile_url\": \"https://www.linkedin.com/company/stripe\",\n  \"custom_fields\": {\n    \"campaign_id\": \"q4-2024-hiring\",\n    \"priority\": \"high\"\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.tamradar.com/v1/radars/companies")

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  \"domain\": \"stripe.com\",\n  \"radar_type\": \"company_new_hires\",\n  \"webhook_url\": \"https://webhook.site/your-webhook-id\",\n  \"departments\": [\n    \"Engineering\",\n    \"Product Management\"\n  ],\n  \"seniorities\": [\n    \"Senior\",\n    \"Manager\"\n  ],\n  \"profile_url\": \"https://www.linkedin.com/company/stripe\",\n  \"custom_fields\": {\n    \"campaign_id\": \"q4-2024-hiring\",\n    \"priority\": \"high\"\n  }\n}"

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

{
  "status": "success",
  "code": 201,
  "timestamp": "2024-03-20T10:15:30.000Z",
  "message": "Radar created successfully",
  "data": {
    "radar_id": "759199a6-5817-4a7d-b812-66abe65f3ce2",
    "radar_type": "company_new_hires",
    "domain": "stripe.com",
    "webhook_url": "https://webhook.site/your-webhook-id",
    "radar_status": "active",
    "created_at": "2024-03-20T10:15:30.000Z",
    "deactivated_at": null,
    "next_charge_at": "2024-04-20T10:15:30.000Z",
    "custom_fields": {
      "campaign_id": "q4-2024-hiring",
      "priority": "high"
    },
    "departments": [
      "Engineering",
      "Product Management"
    ],
    "seniorities": [
      "Senior",
      "Manager"
    ],
    "profile_url": "https://www.linkedin.com/company/stripe"
  }
}

Authorizations

x-api-key

string

header

required

Body

application/json

domain

string

required

The domain to track (e.g., stripe.com). Protocol, www, paths, and query parameters are automatically normalized.

Example:

"stripe.com"

radar_type

enum<string>

required

The type of company activity to track

Available options:

company_new_hires,

company_job_openings,

company_promotions,

company_reviews,

company_mentions,

company_social_posts,

company_social_posts_cxo,

company_social_engagements

webhook_url

string<uri>

Webhook URL to receive radar updates and notifications. Optional — if omitted, the radar is poll-only and updates are available via GET /v1/updates.

Example:

"https://webhook.site/your-webhook-id"

updates_since

string<date-time>

Optional RFC 3339 timestamp with a UTC offset defining the earliest eligible source event. TAMradar normalizes and stores the value in UTC. It must represent now or a past instant and may be at most five calendar years old. A five-second server tolerance exists only for clock skew; it is not future scheduling. When omitted, the radar creation timestamp is used as the effective cutoff.

include_historical

boolean

deprecated

Deprecated compatibility field. It is accepted and stored but has no effect. Use updates_since to request historical eligibility.

departments

string[]

Optional array of department names to filter results. See API documentation for valid department values.

Example:

[
  "Engineering",
  "Product Management",
  "Sales"
]

seniorities

string[]

Optional array of seniority levels to filter results. See API documentation for valid seniority values.

Example:

["Senior", "Manager", "Director"]

job_titles

string

Boolean expression filtering company radar results by job title. When provided, job_titles takes precedence over departments and seniorities; those fields do not affect matching. Operators AND, OR, and NOT must be uppercase. A single word may be unquoted; multi-word phrases must use double quotes. Matching is case-insensitive for title terms. A quoted phrase means contiguous phrase containment within the candidate title, not exact whole-title equality: "Marketing Manager" matches "Senior Marketing Manager" but not "Marketing Operations Manager". EXACT("Marketing Manager") requires the complete normalized title to equal "Marketing Manager"; it does not match "Senior Marketing Manager" and does not expand aliases or abbreviations. EXACT must be uppercase and requires exactly one double-quoted title. Operator precedence is NOT, then AND, then OR; parentheses control grouping. Each term must contain at least two searchable characters and may contain at most 100 characters. The complete expression may contain at most 9,000 characters and 32 nested Boolean groups. A malformed expression returns HTTP 400 with an actionable job_titles error.

Example:

"EXACT(\"Sales Operations Manager\") OR (\"sales operations\" AND (manager OR VP))"

custom_fields

object

Optional metadata to attach to this radar. Values must be strings only. Use for internal tracking like account_id, customer_id, or campaign_id. Returned with every webhook.

Example:

{
  "campaign_id": "q4-2024-hiring",
  "priority": "high",
  "customer_id": "cust_123"
}

profile_url

string<uri>

LinkedIn company or school page URL. Must be exact format: https://www.linkedin.com/company/acme or https://www.linkedin.com/school/stanford-university

Example:

"https://www.linkedin.com/company/stripe"

Response

Radar created successfully

status

enum<string>

Available options:

success

code

enum<integer>

Available options:

201

message

string

data

object

Show child attributes

timestamp

string<date-time>

Introduction / Overview

Getting Started

Core Guides

Agentic Setup

API Reference

Bulk

Webhooks

Authorizations

Body

Response