Skip to main content
POST
Buscar empresas semelhantes (lookalike)

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
domain_search_id
string<uuid>
obrigatório

Um identificador único para a operação de busca de empresas.

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

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"].

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"].

domain
string

Um domínio de empresa usado para operações de busca de empresas. Se recebermos uma URL como www.pubrio.com ou https://docs.pubrio.com/, o sistema a converterá para pubrio.com para processamento.

Exemplo:

"pubrio.com"

linkedin_url
string

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

Exemplo:

"https://www.linkedin.com/company/pubrio"

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:
founded_dates
integer[]

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

Exemplo:
revenues
integer[]

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

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

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

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. Traz os filters e parameters informados, e um bloco profile com credit, topup_credit e total_credit_cost — a única contabilização de créditos por chamada que a API retorna.

data
object | null

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

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