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

ISO 3166-1 alpha-2 (cca2) is used for filtering locations. Check out location endpoints under the Filters tab for more information.

Example:
company_locations
string[]

The location of the company headquarters. Check out location endpoints under the Filters tab for more information.

Example:
companies
string<uuid>[]

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

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

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

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. Unknown slugs are ignored.

Available options:
AD,
EVENT,
NEWS,
DNS,
TECH,
INFRA,
IP,
PARTNER,
EVENT_PLUS,
REG,
ENTITY,
EXEC,
OFFICE,
HIRE,
SCALE,
PRODUCT
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: the echoed filters and a profile block with credit, topup_credit and total_credit_cost.

data
object | null

Response info depends on specific endpoint.