Skip to main content
POST
Expansion Signal Search

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_ids
string[]

Companies to restrict to, by domain_search_id.

Example:
is_active
boolean
default:true

true (the default) returns live signals only; false returns retracted signals only.

Example:

true

country_codes
string[]

Target markets to restrict to, as ISO 3166-1 alpha-2 codes.

Example:
signal_types
enum<string>[]

Signal types to restrict to. Unknown values match nothing.

Available options:
AD,
AUDIENCE,
DNS,
ENTITY,
EVENT,
EVENT_PLUS,
EXEC,
HIRE,
INFRA,
IP,
NEWS,
OFFICE,
PARTNER,
PRODUCT,
REG,
SCALE,
TECH
Example:
signal_subtypes
enum<string>[]

Signal subtypes to restrict to. Unknown values match nothing.

Available options:
marketing_pullback,
domain_dropped,
entity_dissolution,
exhibiting_booth,
speaking_breakout,
speaking_keynote,
sponsorship,
key_departure,
country_manager,
engineering,
freelancer,
hiring_freeze,
job_posting_removal,
legal_compliance,
local_employee,
operations,
regional_vp,
remote_sales_bd,
supply_chain,
ip_abandoned,
office_closure,
partnership_terminated,
product_withdrawal,
regulatory_surrender,
layoffs,
content_decay
Example:
signal_strengths
enum<string>[]

Signal strengths to restrict to. Unknown values match nothing.

Available options:
low,
medium,
high,
very_high
Example:
source_types
string[]

Source types to restrict to: jobs, ads, linkedin, news, pubrio.

Example:
polarities
enum<string>[]

Signal directions to include. expansion marks entry and growth; the contraction_* values mark retreat.

Available options:
expansion,
contraction_leading,
contraction_confirming,
contraction_lagging
Example:
event_dates
string[]

Date range of the signal event date. The maximum value is the current day.

Example:
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.

Required range: x <= 25
Example:

25

Response

Expansion Signal Search

metadata
object

Echo of the filters applied to this request.

data
object

Result container.

Last modified on August 28, 2026