Skip to main content
POST
Buscar 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
company_name
string

Filtra os resultados da busca para incluir um nome de empresa específico.

Se o valor inserido neste parâmetro não corresponder ao nome de uma empresa, ela não aparecerá nos resultados da busca, mesmo que corresponda a outros parâmetros. Correspondências parciais são aceitas.

Exemplo:

"pubrio"

companies
string<uuid>[]

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

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:
company_filters
object

Objeto wrapper para filtros em nível de empresa. Agrupamento recomendado que separa visualmente quais chaves filtram a pessoa (nível superior) das que filtram a empresa. Aceita as mesmas chaves dos filtros de empresa de nível superior (por exemplo, technologies, verticals, vertical_categories, vertical_sub_categories, categories, keywords, founded_dates, employees, revenues, company_locations, company_exclude_locations, company_places, company_exclude_places, companies, domains, company_linkedin_urls, is_enable_similarity_search, similarity_score, além de filter_conditions). O mecanismo achata esse objeto para o nível superior antes de processar — as chaves de nível superior prevalecem em caso de conflito. Mesma estrutura usada pelo company_filters do Monitor. Consulte o guia do desenvolvedor Visão Geral dos Filtros para ver exemplos.

Exemplo:
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:
exclude_locations
string[]

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

Exemplo:
places
string[]

Nomes de lugares (cidade, região) usados para filtrar resultados. Aceita nomes de lugares localizados ou em inglês.

Exemplo:
exclude_places
string[]

Nomes de lugares (cidade, região) a serem excluídos dos resultados. Aceita nomes de lugares localizados ou em inglês.

Exemplo:
job_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:
job_exclude_locations
string[]

Localizações geográficas a serem excluídas dos resultados de vagas de emprego.

Exemplo:
job_posted_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:
job_titles
string[]

Cargos associados aos indivíduos que você deseja localizar.

Os resultados também incluirão cargos que contenham terminologia semelhante, mesmo que não correspondam exatamente. Por exemplo, buscar por software engineer pode retornar resultados de indivíduos com o cargo senior software engineer.

Exemplo:
verticals
integer[]

Uma lista de vertical_id usada para buscar empresas em um vertical ou setor específico. Para encontrar o ID, chame o endpoint vertical na aba Filters.

Este filtro suporta is_enable_similarity_search; uma vez habilitado, você pode inserir qualquer texto livre, por exemplo ["AI"].

vertical_categories
integer[]

Uma lista de vertical_category_id usada para buscar empresas em uma categoria vertical específica. Para encontrar o ID, chame o endpoint vertical category na aba Filters.

Este filtro suporta is_enable_similarity_search; uma vez habilitado, você pode inserir qualquer texto livre, por exemplo ["Information Technology"].

vertical_sub_categories
integer[]

Uma lista de vertical_sub_category_id usada para buscar empresas em uma subcategoria vertical específica. Para encontrar o ID, chame o endpoint vertical sub category na aba Filters.

Este filtro suporta is_enable_similarity_search; uma vez habilitado, você pode inserir qualquer texto livre, por exemplo ["Software"].

categories
integer[]

Uma lista de category_id usada para buscar categorias específicas de tecnologia utilizadas pelas empresas. Para encontrar o ID, chame o endpoint category na aba Filters.

Este filtro suporta is_enable_similarity_search; uma vez habilitado, você pode inserir qualquer texto livre, por exemplo ["CDN"].

technologies
integer[]

Uma lista de tag_id usada para buscar tecnologias específicas utilizadas pelas empresas. Para encontrar o ID, chame o endpoint technology na aba Filters.

Este filtro suporta is_enable_similarity_search; uma vez habilitado, você pode inserir qualquer texto livre, por exemplo ["Shopify"].

employees
string[][]

O intervalo numérico de funcionários que trabalham na empresa. Isso permite encontrar empresas com base no número de funcionários. Você pode adicionar múltiplos intervalos para expandir os resultados da busca.

Consulte os endpoints de company size na aba Filters para mais informações.

Exemplo:
revenues
integer[]

Intervalo mínimo e máximo da receita da empresa.

Exemplo:
founded_dates
integer[]

Intervalo de anos de fundação da empresa. O valor máximo de fundação é o ano atual.

Exemplo:
keywords
string[]

Uma lista de palavras-chave para filtrar empresas por relevância, especialidades ou descrições.

Exemplo:
social_media
enum<string>[]

Empresas com perfil em qualquer um destes: linkedin, facebook, instagram, tiktok, twitter, x, github, wantedly, rocketpunch. Promova para E (AND) com filter_conditions.

Opções disponíveis:
linkedin,
facebook,
instagram,
tiktok,
twitter,
x,
github,
wantedly,
rocketpunch
Exemplo:
news_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:
news_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:
advertisement_search_terms
string[]

Palavras-chave usadas para buscar no conteúdo ou nos títulos dos anúncios.

Exemplo:
advertisement_target_locations
string[]

Localizações geográficas alvo para anúncios.

Exemplo:
advertisement_exclude_target_locations
string[]

Localizações geográficas a serem excluídas da segmentação de anúncios.

Exemplo:
advertisement_start_dates
string<date>[]

Intervalo de data de início para filtragem de anúncios.

Exemplo:
advertisement_end_dates
string<date>[]

Intervalo de data de término para filtragem de anúncios.

Exemplo:
advertisement_active_dates
string<date>[]

Encontra anúncios que estavam em veiculação em algum momento dentro deste intervalo de datas (baseado em sobreposição: inclui anúncios que começaram antes do intervalo e ainda estão em veiculação, não apenas anúncios que começaram dentro dele).

Exemplo:
advertisement_status
enum<string>[]

currently_running: empresas com anúncios registrados. active_last_30_min: empresas cujos anúncios foram alterados nos últimos 30 minutos.

Opções disponíveis:
currently_running,
active_last_30_min
Exemplo:
advertisement_headlines
string[]

Palavras-chave para buscar no texto do título dos anúncios.

Exemplo:
advertisement_platforms
enum<string>[]

Filtra pela biblioteca de anúncios da qual o anúncio foi obtido. Minúsculas, sem distinção entre maiúsculas e minúsculas. meta é aceito como um alias para facebook.

Opções disponíveis:
linkedin,
facebook,
google,
tiktok,
apple
Exemplo:
advertisement_publisher_platforms
enum<string>[]

Filtra anúncios do Facebook/Meta pela superfície de plataforma em que foram veiculados. Minúsculas e sem diferenciação entre maiúsculas e minúsculas. Aplica-se apenas à fonte facebook (as demais fontes têm plataforma única).

Opções disponíveis:
facebook,
instagram,
messenger,
threads,
audience_network
Exemplo:
advertisement_exclude_publisher_platforms
enum<string>[]

Exclui anúncios do Facebook/Meta veiculados nessas superfícies de plataforma.

Opções disponíveis:
facebook,
instagram,
messenger,
threads,
audience_network
Exemplo:
advertisement_formats
enum<string>[]

Encontra empresas com pelo menos um anúncio em qualquer um destes formatos criativos.

Opções disponíveis:
image,
video,
text,
carousel,
dynamic_product,
document,
message,
event,
article,
spotlight,
follow,
job,
engagement
Exemplo:
advertisement_active_ads
(integer | null)[]

Contagem mínima e máxima de anúncios atualmente ativos da empresa, em todos os países. Use null para um limite aberto, por exemplo [1, null] para "pelo menos um anúncio ativo".

Required array length: 2 elements
Exemplo:
advertisement_running_ads
(integer | null)[]

Contagem mínima e máxima de anúncios da empresa que ainda estão em veiculação (sem data de término, ou com data de término no futuro). Atualmente preenchido apenas para anúncios do LinkedIn.

Required array length: 2 elements
Exemplo:
advertisement_total_ads
(integer | null)[]

Contagem mínima e máxima do total de anúncios já registrados pela empresa, em todos os países.

Required array length: 2 elements
Exemplo:
advertisement_platform_count
(integer | null)[]

Número mínimo e máximo de plataformas de anúncios distintas (linkedin, facebook, google, tiktok, apple) nas quais a empresa está ativamente anunciando.

Required array length: 2 elements
Exemplo:
advertisement_format_count
(integer | null)[]

Número mínimo e máximo de formatos criativos de anúncio distintos que a empresa está veiculando ativamente.

Required array length: 2 elements
Exemplo:
advertisement_impressions_estimate
(integer | null)[]

Estimativa mínima e máxima de impressões de anúncios, somadas em todos os países. Apenas anúncios com um intervalo de impressões reportado são contabilizados.

Required array length: 2 elements
Exemplo:
advertisement_country_activity
object

Atividade de anúncios para um país específico. country é obrigatório, e pelo menos um outro campo deve ser definido (um país sozinho não corresponde a nada). Para um total considerando todos os países, use os filtros de nível superior advertisement_active_ads / advertisement_total_ads / advertisement_impressions_estimate.

Exemplo:
filter_conditions
object[]

Opções avançadas de filtragem para buscas de empresas. Especifique condições combinando chaves e operadores lógicos para refinar os resultados da busca.

Quando habilitado, os filtros listados acima que suportam buscas por similaridade podem ser preenchidos com texto livre para IDs específicos.

similarity_score
number<float>

Usado em conjunto com is_enable_similarity_search. Esse número é usado para analisar se um slug específico (por exemplo, setor vertical, tecnologia) é semelhante à entrada do usuário, e quanto maior o número, mais rigoroso é o critério.

Exemplo:

0.7

exclude_fields
string[]

Lista de campos a serem excluídos do payload de resposta.

Exemplo:
is_parameter_metadata_available
boolean

Indica se os metadados de parâmetro estão disponíveis para a requisição.

is_profile_metadata_available
boolean

Indica se os metadados de perfil estão disponíveis para a requisição.

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

Resposta

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

metadata
object

Contexto da solicitação: recent_search_log_identifier, os parameters e filters informados são retornados, um bloco opcional de créditos profile, e ignored_fields (chaves do corpo da requisição que o endpoint descartou).

data
object | null

As informações da resposta dependem do endpoint específico.