Skip to main content
POST
Search for company news

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

Countries the story itself is about, read from the article text (ISO 3166-1 alpha-2). Empty when the article names no place. For where a mentioned company is headquartered, use company_locations.

Example:
company_locations
string[]

Headquarters country of the companies the article mentions (ISO 3166-1 alpha-2) — not where the story happened; for that, use locations.

Example:
companies
string<uuid>[]

A list of unique identifiers (domain_search_id) used for company and people search operations.

news_search_id
string<uuid>

Return only this one record. Handy for re-fetching a row you stored earlier without paging.

Example:

"4110b929-17cd-42aa-a159-906ead0c9b56"

domains
string[]

List of company domains used for company and people search operations. If we receive a URL such as www.pubrio.com or https://docs.pubrio.com/, the system will convert it to pubrio.com for processing.

Example:
linkedin_urls
string[]

The fully formed URL of the LinkedIn company profile. URL begin with http and contain linkedin.com/company/

Example:
search_term
string

A string of words over which we want to filter the results.

Example:

"pubrio"

search_terms
string[]

Array of keyword strings to filter news articles. Each term is matched against article content. Use search_term for a single string or search_terms for multiple keywords.

Example:
exclude_search_terms
string[]

Leave out articles that mention any of these words, matched the same way as search_terms. exclude_keywords is accepted as another name.

Example:
sources
string[]

Only articles from these publishers. Use the publisher's domain, e.g. bbc.co.uk — the same value as the source field on every article. A full URL or a www. address also works.

Example:
exclude_sources
string[]

Leave out articles from these publishers. Same format as sources. Articles with no recorded publisher are kept.

Example:
categories
string[]

List of category slugs for searching for specific news categories. To find a slug, call the news categories endpoint under the Filters tab.

Example:

A list of news_gallery_id used to search for specific news galleries. To find the ID, call the news galleries endpoint under the Filters tab.

published_dates
string[]

Date range of the published date. The maximum value is the current day. Day boundaries follow your workspace timezone.

Example:
published_at
string<date-time>

Published at or after this instant (UTC). Date or ISO timestamp. published_dates is the closed-window form and uses your workspace timezone.

Example:

"2026-09-01T00:00:00Z"

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

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

is_ascending_order
boolean
default:false

Sort direction. Results are returned newest-first by default; set true for oldest-first. There is no sort_by on this endpoint — the sort key is fixed and stated in the endpoint description.

Example:

false

news_galleries
string[]

List of gallery slugs for filtering news by gallery. To find a slug, call the news galleries endpoint under the Filters tab.

Example:
news_languages
string[]

List of locale_code values for filtering news by language. To find available codes, call the news languages endpoint under the Filters tab.

Example:
is_expansion_signal_available
boolean

When true, attaches the resolved expansion signals (expansion_signals) to each news item and enables the expansion_signal_types / expansion_signal_polarities filters. Leave unset for the fastest search — the expansion join is only added when this flag is on.

expansion_signal_types
enum<string>[]

Return only news that produced an expansion signal of one of these types (uppercase slugs). Requires is_expansion_signal_available: true. A list with only unknown slugs matches nothing.

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

Return only news whose expansion signal carries one of these polarities. Requires is_expansion_signal_available: true. Combined with expansion_signal_types as AND.

Available options:
expansion,
contraction_leading,
contraction_confirming,
contraction_lagging
Example:

Response

Successful response containing company news search details.

metadata
object

Request context.

data
object
Last modified on June 1, 2025