Expansion Signal Search

curl --request POST \
  --url https://api.pubrio.com/expansions/signals/search \
  --header 'Content-Type: application/json' \
  --header 'pubrio-api-key: <api-key>' \
  --data '
{
  "domain_search_id_list": [
    "550e8400-e29b-41d4-a716-446655440002"
  ],
  "is_active": true,
  "country_code_list": [
    "US",
    "GB"
  ],
  "signal_type_slug_list": [
    "HIRE",
    "EXEC"
  ],
  "signal_subtype_slug_list": [
    "country_manager"
  ],
  "signal_strength_slug_list": [
    "high",
    "very_high"
  ],
  "source_type_list": [
    "linkedin",
    "news"
  ],
  "event_date_from": "2026-06-01",
  "event_date_to": "2026-06-30",
  "page": 1,
  "per_page": 25
}
'

import requests

url = "https://api.pubrio.com/expansions/signals/search"

payload = {
    "domain_search_id_list": ["550e8400-e29b-41d4-a716-446655440002"],
    "is_active": True,
    "country_code_list": ["US", "GB"],
    "signal_type_slug_list": ["HIRE", "EXEC"],
    "signal_subtype_slug_list": ["country_manager"],
    "signal_strength_slug_list": ["high", "very_high"],
    "source_type_list": ["linkedin", "news"],
    "event_date_from": "2026-06-01",
    "event_date_to": "2026-06-30",
    "page": 1,
    "per_page": 25
}
headers = {
    "pubrio-api-key": "<api-key>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {'pubrio-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    domain_search_id_list: ['550e8400-e29b-41d4-a716-446655440002'],
    is_active: true,
    country_code_list: ['US', 'GB'],
    signal_type_slug_list: ['HIRE', 'EXEC'],
    signal_subtype_slug_list: ['country_manager'],
    signal_strength_slug_list: ['high', 'very_high'],
    source_type_list: ['linkedin', 'news'],
    event_date_from: '2026-06-01',
    event_date_to: '2026-06-30',
    page: 1,
    per_page: 25
  })
};

fetch('https://api.pubrio.com/expansions/signals/search', 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.pubrio.com/expansions/signals/search",
  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_search_id_list' => [
        '550e8400-e29b-41d4-a716-446655440002'
    ],
    'is_active' => true,
    'country_code_list' => [
        'US',
        'GB'
    ],
    'signal_type_slug_list' => [
        'HIRE',
        'EXEC'
    ],
    'signal_subtype_slug_list' => [
        'country_manager'
    ],
    'signal_strength_slug_list' => [
        'high',
        'very_high'
    ],
    'source_type_list' => [
        'linkedin',
        'news'
    ],
    'event_date_from' => '2026-06-01',
    'event_date_to' => '2026-06-30',
    'page' => 1,
    'per_page' => 25
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "pubrio-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.pubrio.com/expansions/signals/search"

	payload := strings.NewReader("{\n  \"domain_search_id_list\": [\n    \"550e8400-e29b-41d4-a716-446655440002\"\n  ],\n  \"is_active\": true,\n  \"country_code_list\": [\n    \"US\",\n    \"GB\"\n  ],\n  \"signal_type_slug_list\": [\n    \"HIRE\",\n    \"EXEC\"\n  ],\n  \"signal_subtype_slug_list\": [\n    \"country_manager\"\n  ],\n  \"signal_strength_slug_list\": [\n    \"high\",\n    \"very_high\"\n  ],\n  \"source_type_list\": [\n    \"linkedin\",\n    \"news\"\n  ],\n  \"event_date_from\": \"2026-06-01\",\n  \"event_date_to\": \"2026-06-30\",\n  \"page\": 1,\n  \"per_page\": 25\n}")

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

	req.Header.Add("pubrio-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.pubrio.com/expansions/signals/search")
  .header("pubrio-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"domain_search_id_list\": [\n    \"550e8400-e29b-41d4-a716-446655440002\"\n  ],\n  \"is_active\": true,\n  \"country_code_list\": [\n    \"US\",\n    \"GB\"\n  ],\n  \"signal_type_slug_list\": [\n    \"HIRE\",\n    \"EXEC\"\n  ],\n  \"signal_subtype_slug_list\": [\n    \"country_manager\"\n  ],\n  \"signal_strength_slug_list\": [\n    \"high\",\n    \"very_high\"\n  ],\n  \"source_type_list\": [\n    \"linkedin\",\n    \"news\"\n  ],\n  \"event_date_from\": \"2026-06-01\",\n  \"event_date_to\": \"2026-06-30\",\n  \"page\": 1,\n  \"per_page\": 25\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.pubrio.com/expansions/signals/search")

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

request = Net::HTTP::Post.new(url)
request["pubrio-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"domain_search_id_list\": [\n    \"550e8400-e29b-41d4-a716-446655440002\"\n  ],\n  \"is_active\": true,\n  \"country_code_list\": [\n    \"US\",\n    \"GB\"\n  ],\n  \"signal_type_slug_list\": [\n    \"HIRE\",\n    \"EXEC\"\n  ],\n  \"signal_subtype_slug_list\": [\n    \"country_manager\"\n  ],\n  \"signal_strength_slug_list\": [\n    \"high\",\n    \"very_high\"\n  ],\n  \"source_type_list\": [\n    \"linkedin\",\n    \"news\"\n  ],\n  \"event_date_from\": \"2026-06-01\",\n  \"event_date_to\": \"2026-06-30\",\n  \"page\": 1,\n  \"per_page\": 25\n}"

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

{
  "metadata": {
    "filters": {
      "country_code_list": [
        "US"
      ],
      "signal_type_slug_list": [
        "HIRE"
      ]
    }
  },
  "data": {
    "pagination": {
      "page": 1,
      "per_page": 25,
      "total_entries": 134,
      "total_pages": 6,
      "total_display_pages": 6,
      "is_timeout": false
    },
    "signals": [
      {
        "expansion_signal_id": 90211,
        "domain_search_id": "550e8400-e29b-41d4-a716-446655440002",
        "country_code": "US",
        "signal_type_slug": "HIRE",
        "signal_subtype_slug": "country_manager",
        "signal_strength_slug": "high",
        "polarity": "expansion",
        "event_date": "2026-06-20T14:00:00.000Z",
        "event_date_precision": "day",
        "source_type": "linkedin",
        "source_record_id": "4224659596",
        "display_label": "Hired Country Manager",
        "evidence_url": "https://linkedin.com/company/example-corp",
        "source_published_at": "2026-06-19T08:00:00.000Z",
        "lead_time_days": 1,
        "extraction_confidence": 0.91,
        "is_active": true,
        "created_at": "2026-06-20T15:02:11.004Z",
        "last_modified": "2026-06-20T15:02:11.004Z"
      }
    ]
  }
}

Expansion

Expansion Signal Search

Search the raw expansion signal rows directly, rather than the companies they roll up into. Every signal carries its type, subtype, strength, polarity, dated event, source and evidence URL, so you can audit exactly what drove a company’s stage — or build your own scoring on top.

Scope this call to specific companies. Pass domain_search_id_list. The signal table is very large, and a request filtered only by market or date range does not complete inside the gateway timeout — the connection is dropped after about 60 seconds. Company-scoped calls typically return in well under a second.

For company-level results use Expansion Search; for one company’s feed use Company Signal Events.

POST

expansions

signals

Expansion Signal Search

curl --request POST \
  --url https://api.pubrio.com/expansions/signals/search \
  --header 'Content-Type: application/json' \
  --header 'pubrio-api-key: <api-key>' \
  --data '
{
  "domain_search_id_list": [
    "550e8400-e29b-41d4-a716-446655440002"
  ],
  "is_active": true,
  "country_code_list": [
    "US",
    "GB"
  ],
  "signal_type_slug_list": [
    "HIRE",
    "EXEC"
  ],
  "signal_subtype_slug_list": [
    "country_manager"
  ],
  "signal_strength_slug_list": [
    "high",
    "very_high"
  ],
  "source_type_list": [
    "linkedin",
    "news"
  ],
  "event_date_from": "2026-06-01",
  "event_date_to": "2026-06-30",
  "page": 1,
  "per_page": 25
}
'

import requests

url = "https://api.pubrio.com/expansions/signals/search"

payload = {
    "domain_search_id_list": ["550e8400-e29b-41d4-a716-446655440002"],
    "is_active": True,
    "country_code_list": ["US", "GB"],
    "signal_type_slug_list": ["HIRE", "EXEC"],
    "signal_subtype_slug_list": ["country_manager"],
    "signal_strength_slug_list": ["high", "very_high"],
    "source_type_list": ["linkedin", "news"],
    "event_date_from": "2026-06-01",
    "event_date_to": "2026-06-30",
    "page": 1,
    "per_page": 25
}
headers = {
    "pubrio-api-key": "<api-key>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {'pubrio-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    domain_search_id_list: ['550e8400-e29b-41d4-a716-446655440002'],
    is_active: true,
    country_code_list: ['US', 'GB'],
    signal_type_slug_list: ['HIRE', 'EXEC'],
    signal_subtype_slug_list: ['country_manager'],
    signal_strength_slug_list: ['high', 'very_high'],
    source_type_list: ['linkedin', 'news'],
    event_date_from: '2026-06-01',
    event_date_to: '2026-06-30',
    page: 1,
    per_page: 25
  })
};

fetch('https://api.pubrio.com/expansions/signals/search', 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.pubrio.com/expansions/signals/search",
  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_search_id_list' => [
        '550e8400-e29b-41d4-a716-446655440002'
    ],
    'is_active' => true,
    'country_code_list' => [
        'US',
        'GB'
    ],
    'signal_type_slug_list' => [
        'HIRE',
        'EXEC'
    ],
    'signal_subtype_slug_list' => [
        'country_manager'
    ],
    'signal_strength_slug_list' => [
        'high',
        'very_high'
    ],
    'source_type_list' => [
        'linkedin',
        'news'
    ],
    'event_date_from' => '2026-06-01',
    'event_date_to' => '2026-06-30',
    'page' => 1,
    'per_page' => 25
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "pubrio-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.pubrio.com/expansions/signals/search"

	payload := strings.NewReader("{\n  \"domain_search_id_list\": [\n    \"550e8400-e29b-41d4-a716-446655440002\"\n  ],\n  \"is_active\": true,\n  \"country_code_list\": [\n    \"US\",\n    \"GB\"\n  ],\n  \"signal_type_slug_list\": [\n    \"HIRE\",\n    \"EXEC\"\n  ],\n  \"signal_subtype_slug_list\": [\n    \"country_manager\"\n  ],\n  \"signal_strength_slug_list\": [\n    \"high\",\n    \"very_high\"\n  ],\n  \"source_type_list\": [\n    \"linkedin\",\n    \"news\"\n  ],\n  \"event_date_from\": \"2026-06-01\",\n  \"event_date_to\": \"2026-06-30\",\n  \"page\": 1,\n  \"per_page\": 25\n}")

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

	req.Header.Add("pubrio-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.pubrio.com/expansions/signals/search")
  .header("pubrio-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"domain_search_id_list\": [\n    \"550e8400-e29b-41d4-a716-446655440002\"\n  ],\n  \"is_active\": true,\n  \"country_code_list\": [\n    \"US\",\n    \"GB\"\n  ],\n  \"signal_type_slug_list\": [\n    \"HIRE\",\n    \"EXEC\"\n  ],\n  \"signal_subtype_slug_list\": [\n    \"country_manager\"\n  ],\n  \"signal_strength_slug_list\": [\n    \"high\",\n    \"very_high\"\n  ],\n  \"source_type_list\": [\n    \"linkedin\",\n    \"news\"\n  ],\n  \"event_date_from\": \"2026-06-01\",\n  \"event_date_to\": \"2026-06-30\",\n  \"page\": 1,\n  \"per_page\": 25\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.pubrio.com/expansions/signals/search")

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

request = Net::HTTP::Post.new(url)
request["pubrio-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"domain_search_id_list\": [\n    \"550e8400-e29b-41d4-a716-446655440002\"\n  ],\n  \"is_active\": true,\n  \"country_code_list\": [\n    \"US\",\n    \"GB\"\n  ],\n  \"signal_type_slug_list\": [\n    \"HIRE\",\n    \"EXEC\"\n  ],\n  \"signal_subtype_slug_list\": [\n    \"country_manager\"\n  ],\n  \"signal_strength_slug_list\": [\n    \"high\",\n    \"very_high\"\n  ],\n  \"source_type_list\": [\n    \"linkedin\",\n    \"news\"\n  ],\n  \"event_date_from\": \"2026-06-01\",\n  \"event_date_to\": \"2026-06-30\",\n  \"page\": 1,\n  \"per_page\": 25\n}"

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

{
  "metadata": {
    "filters": {
      "country_code_list": [
        "US"
      ],
      "signal_type_slug_list": [
        "HIRE"
      ]
    }
  },
  "data": {
    "pagination": {
      "page": 1,
      "per_page": 25,
      "total_entries": 134,
      "total_pages": 6,
      "total_display_pages": 6,
      "is_timeout": false
    },
    "signals": [
      {
        "expansion_signal_id": 90211,
        "domain_search_id": "550e8400-e29b-41d4-a716-446655440002",
        "country_code": "US",
        "signal_type_slug": "HIRE",
        "signal_subtype_slug": "country_manager",
        "signal_strength_slug": "high",
        "polarity": "expansion",
        "event_date": "2026-06-20T14:00:00.000Z",
        "event_date_precision": "day",
        "source_type": "linkedin",
        "source_record_id": "4224659596",
        "display_label": "Hired Country Manager",
        "evidence_url": "https://linkedin.com/company/example-corp",
        "source_published_at": "2026-06-19T08:00:00.000Z",
        "lead_time_days": 1,
        "extraction_confidence": 0.91,
        "is_active": true,
        "created_at": "2026-06-20T15:02:11.004Z",
        "last_modified": "2026-06-20T15:02:11.004Z"
      }
    ]
  }
}

Authorizations

pubrio-api-key

string

header

required

A unique API token that represents the actions you perform through the API and the corresponding permissions and operations. You can create it through the Settings section.

Body

application/json

domain_search_id_list

string[]

Restrict to these companies, by domain_search_id. Required in practice — see the endpoint description: a call not scoped to specific companies is dropped at the gateway timeout.

Example:

["550e8400-e29b-41d4-a716-446655440002"]

is_active

boolean

Return only live signals (true) or only retracted ones (false). Omit for both.

Example:

true

country_code_list

string[]

Restrict to these target markets, as ISO 3166-1 alpha-2 codes.

Example:

["US", "GB"]

signal_type_slug_list

string[]

Restrict to these signal types. Resolve valid slugs from Expansion Reference.

Example:

["HIRE", "EXEC"]

signal_subtype_slug_list

string[]

Restrict to these signal subtypes.

Example:

["country_manager"]

signal_strength_slug_list

string[]

Restrict to these signal strengths.

Example:

["high", "very_high"]

source_type_list

string[]

Restrict to these source types (for example linkedin, news, jobs).

Example:

["linkedin", "news"]

polarity

enum<string>

Signal direction. expansion marks entry and growth; the three contraction_* values mark retreat at different points in the evidence cycle (contraction_leading is the earliest indicator, contraction_confirming the most settled). There is no bare contraction value — sending one silently disables the filter.

Available options:

expansion,

contraction_leading,

contraction_lagging,

contraction_confirming

event_date_from

string<date>

Earliest event date to include, YYYY-MM-DD, interpreted in your workspace timezone.

Example:

"2026-06-01"

event_date_to

string<date>

Latest event date to include, YYYY-MM-DD, inclusive of the whole day.

Example:

"2026-06-30"

page

integer

default:1

Page number, starting at 1. The ceiling is your subscription's max_search_page (max_company_search_page for company search), returned by Profile. Exceeding it returns HTTP 416.

Example:

1

per_page

integer

default:25

Records per page. Defaults to 25, which is also the ceiling on most plans — the limit is your subscription's max_search_per_page, returned by Profile. Exceeding it returns HTTP 416 with code 41676 (or 41613 on company and people search), not a clamped result set.

Example:

25

Response

200 - application/json

Expansion Signal Search

metadata

object

Echo of the filters applied to this request.

data

object

Result container.

Show child attributes

API Documentation

Endpoint

Expansion Signal Search

Authorizations

Body

Response