Skip to main content
POST
Buscar notícias de empresas

Autorizações

pubrio-api-key
string
header
obrigatório

Um token de API exclusivo que representa as ações que você realiza por meio da API e as permissões e operações correspondentes. Você pode criá-lo na seção Configurações.

Corpo

application/json
locations
string[]

O padrão ISO 3166-1 alpha-2 (cca2) é usado para filtrar localizações. Consulte os endpoints location na aba Filters para mais informações.

Exemplo:
company_locations
string[]

A localização da sede da empresa. Consulte os endpoints de location na aba Filters para mais informações.

Exemplo:
companies
string<uuid>[]

Uma lista de identificadores únicos (domain_search_id) usada para operações de busca de empresas e pessoas.

news_search_id
string<uuid>

Retorna apenas este registro. Útil para buscar novamente um registro que você armazenou anteriormente, sem precisar paginar.

Exemplo:

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

domains
string[]

Lista de domínios de empresas usada para operações de busca de empresas e pessoas. Se recebermos uma URL como www.pubrio.com ou https://docs.pubrio.com/, o sistema a converterá para pubrio.com para processamento.

Exemplo:
linkedin_urls
string[]

A URL completa do perfil da empresa no LinkedIn. A URL começa com http e contém linkedin.com/company/

Exemplo:
search_term
string

Uma string de palavras pela qual queremos filtrar os resultados.

Exemplo:

"pubrio"

search_terms
string[]

Array de strings de palavras-chave para filtrar artigos de notícias. Cada termo é comparado com o conteúdo do artigo. Use search_term para uma única string ou search_terms para várias palavras-chave.

Exemplo:
categories
string[]

Lista de category slugs para buscar categorias de notícias específicas. Para encontrar um slug, chame o endpoint news categories na aba Filters.

Exemplo:

Uma lista de news_gallery_id usada para buscar galerias de notícias específicas. Para encontrar o ID, chame o endpoint news galleries na aba Filters.

published_dates
string[]

Intervalo de datas de publicação. O valor máximo é o dia atual. Os limites do dia seguem o fuso horário do seu workspace.

Exemplo:
published_at
string<date-time>

Publicado neste instante ou depois (UTC). Data ou timestamp ISO. published_dates é a forma de janela fechada e usa o fuso horário do seu workspace.

Exemplo:

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

per_page
integer
padrão:25

Registros por página. O padrão é 25, que também é o teto na maioria dos planos — o limite é o max_search_per_page da sua assinatura, retornado por Profile. Excedê-lo retorna HTTP 416 com o código 41676 (ou 41613 na busca de empresas e pessoas), não um conjunto de resultados limitado.

Intervalo necessário: x <= 25
Exemplo:

25

page
integer
padrão:1

Número da página, começando em 1. O teto é o max_search_page da sua assinatura (max_company_search_page para busca de empresas), retornado por Profile. Excedê-lo retorna HTTP 416.

Exemplo:

1

is_ascending_order
boolean
padrão:false

Direção da ordenação. Por padrão, os resultados são retornados do mais recente para o mais antigo; defina true para do mais antigo para o mais recente. Não há sort_by neste endpoint — a chave de ordenação é fixa e está indicada na descrição do endpoint.

Exemplo:

false

news_galleries
string[]

Lista de gallery slugs para filtrar notícias por galeria. Para encontrar um slug, chame o endpoint news galleries na aba Filters.

Exemplo:
news_languages
string[]

Lista de valores locale_code para filtrar notícias por idioma. Para encontrar os códigos disponíveis, chame o endpoint news languages na aba Filters.

Exemplo:
is_expansion_signal_available
boolean

Quando true, anexa os sinais de expansão resolvidos (expansion_signals) a cada notícia e habilita os filtros expansion_signal_types / expansion_signal_polarities. Deixe sem definir para a busca mais rápida — a junção de expansão só é adicionada quando este sinalizador está ativado.

expansion_signal_types
enum<string>[]

Retorna apenas notícias que produziram um sinal de expansão de um destes tipos (slugs em maiúsculas). Requer is_expansion_signal_available: true. Slugs desconhecidos são ignorados.

Opções disponíveis:
AD,
AUDIENCE,
DNS,
ENTITY,
EVENT,
EVENT_PLUS,
EXEC,
HIRE,
INFRA,
IP,
NEWS,
OFFICE,
PARTNER,
PRODUCT,
REG,
SCALE,
TECH
Exemplo:
expansion_signal_polarities
enum<string>[]

Retorna apenas notícias cujo sinal de expansão tenha uma destas polaridades. Requer is_expansion_signal_available: true. Combinado com expansion_signal_types como E (AND).

Opções disponíveis:
expansion,
contraction_leading,
contraction_confirming,
contraction_lagging
Exemplo:

Resposta

Resposta bem-sucedida contendo os detalhes da busca de notícias de empresas.

metadata
object

Contexto da requisição.

data
object
Última modificação em 4 de setembro de 2026