> ## Documentation Index > Fetch the complete documentation index at: https://docs.pubrio.com/llms.txt > Use this file to discover all available pages before exploring further. # Buscar Empresas Semelhantes > Encontra empresas semelhantes a uma empresa de referência. Informe exatamente um identificador singular (`domain_search_id`, `domain`, `linkedin_url` ou outro `*_url`); os registros trazem um `similarity_score` e são ordenados por ele, do maior para o menor. ## OpenAPI ````yaml pt-openapi POST /companies/search/similar openapi: 3.0.0 info: description: >- A API Pubrio entrega inteligência de expansão de mercado — sinais em tempo real que indicam quando uma empresa entra em um novo mercado — além dos dados de empresas e pessoas por trás desses sinais. Pesquise, consulte e enriqueça contas e contatos, e assine sinais de movimentação tipados e datados em mais de 200 mercados. version: 1.0.0 title: Pubrio OpenAPI termsOfService: https://pubrio.com/pt-BR/terms-of-service contact: email: king.lai@pubrio.com name: King Lai url: https://pubrio.com/pt-BR/get-in-touch license: name: Apache 2.0 url: http://www.apache.org/licenses/LICENSE-2.0.html servers: - url: https://api.pubrio.com security: - pubrio_api_key: [] tags: - name: Profile description: Informações do perfil da equipe e estatísticas de uso - name: Enrichment description: Enriqueça registros de pessoas e empresas com dados B2B detalhados - name: Lookalike description: Encontre empresas semelhantes a uma empresa específica - name: Search description: Pesquise pessoas, empresas, vagas, notícias e anúncios com filtros - name: Lookup description: >- Consulte informações detalhadas de pessoas, empresas, vagas, notícias, anúncios e tecnologias específicas - name: LinkedIn description: >- Consulte dados de pessoas e empresas por meio de URLs de perfil do LinkedIn - name: Redeem description: >- Resgate créditos para desbloquear detalhes de contato de pessoas (individual e em lote) - name: Channels description: >- Gerencie templates de canais de outreach (criar, atualizar, excluir, listar) - name: Monitor description: >- Crie e gerencie monitores de dados com webhooks, estatísticas e processamento - name: Filters description: >- Obtenha os valores de filtro disponíveis para os parâmetros de busca (tecnologias, localizações, verticais etc.) - name: API Keys description: >- Liste e inspecione logs de requisições da API e análises de uso das chaves de API - name: Insights description: Insights agregados de sinais para empresas (vagas, notícias, anúncios). - name: Export description: Exportações de dados em massa (consomem créditos). - name: Expansion description: >- Inteligência de expansão de mercado de empresas: sinais, estágios, mercados e exportações. externalDocs: description: >- A API Pubrio é usada para pesquisar, pré-visualizar e enriquecer contatos e contas. O banco de dados Pubrio oferece dados extensos de contatos B2B e inteligência de vendas. url: https://docs.pubrio.com paths: /companies/search/similar: post: tags: - Lookalike summary: Buscar empresas semelhantes description: >- Encontra empresas semelhantes a uma empresa de referência. Informe exatamente um identificador singular (`domain_search_id`, `domain`, `linkedin_url` ou outro `*_url`); os registros trazem um `similarity_score` e são ordenados por ele, do maior para o menor. operationId: companies_search_similar parameters: [] requestBody: required: true content: application/json: schema: type: object properties: domain_search_id: type: string description: Identificador de empresa da Pubrio. domain: type: string description: O domínio principal da empresa, por exemplo `stripe.com`. example: stripe.com linkedin_url: type: string description: URL da empresa no LinkedIn. tiktok_url: type: string description: URL do perfil da empresa no TikTok. wantedly_url: type: string description: URL do perfil da empresa no Wantedly. tw104_url: type: string description: URL do perfil da empresa no 104 (Taiwan). rocketpunch_url: type: string description: URL do perfil da empresa no RocketPunch. remember_url: type: string description: URL do perfil da empresa no Remember. youtrust_url: type: string description: URL do perfil da empresa no YOUTRUST. company_name: $ref: '#/components/schemas/company_name' companies: $ref: '#/components/schemas/companies' domains: $ref: '#/components/schemas/domains' linkedin_urls: $ref: '#/components/schemas/company_linkedin_urls' locations: $ref: '#/components/schemas/locations' exclude_locations: $ref: '#/components/schemas/exclude_locations' places: $ref: '#/components/schemas/places' exclude_places: $ref: '#/components/schemas/exclude_places' job_locations: $ref: '#/components/schemas/locations' job_exclude_locations: $ref: '#/components/schemas/job_exclude_locations' job_posted_dates: $ref: '#/components/schemas/posted_dates' job_titles: $ref: '#/components/schemas/people_titles' verticals: $ref: '#/components/schemas/verticals' vertical_categories: $ref: '#/components/schemas/vertical_categories' vertical_sub_categories: $ref: '#/components/schemas/vertical_sub_categories' categories: $ref: '#/components/schemas/categories' technologies: $ref: '#/components/schemas/technologies' employees: $ref: '#/components/schemas/employees' revenues: $ref: '#/components/schemas/revenues' founded_dates: $ref: '#/components/schemas/founded_dates' keywords: $ref: '#/components/schemas/keywords' news_categories: $ref: '#/components/schemas/news_categories' news_published_dates: $ref: '#/components/schemas/published_dates' advertisement_search_terms: $ref: '#/components/schemas/advertisement_search_terms' advertisement_target_locations: $ref: '#/components/schemas/advertisement_target_locations' advertisement_exclude_target_locations: $ref: '#/components/schemas/advertisement_exclude_target_locations' advertisement_start_dates: $ref: '#/components/schemas/advertisement_start_dates' advertisement_end_dates: $ref: '#/components/schemas/advertisement_end_dates' filter_conditions: $ref: '#/components/schemas/company_filter_conditions' is_enable_similarity_search: $ref: '#/components/schemas/is_enable_similarity_search' similarity_score: $ref: '#/components/schemas/similarity_score' exclude_fields: $ref: '#/components/schemas/exclude_fields' is_parameter_metadata_available: $ref: '#/components/schemas/is_parameter_metadata_available' is_profile_metadata_available: $ref: '#/components/schemas/is_profile_metadata_available' per_page: $ref: '#/components/schemas/per_page' page: $ref: '#/components/schemas/page' company_filters: $ref: '#/components/schemas/company_filters' anyOf: - title: domain_search_id required: - domain_search_id - title: domain required: - domain - title: linkedin_url required: - linkedin_url - title: tiktok_url required: - tiktok_url - title: wantedly_url required: - wantedly_url - title: tw104_url required: - tw104_url - title: rocketpunch_url required: - rocketpunch_url - title: remember_url required: - remember_url - title: youtrust_url required: - youtrust_url responses: '200': description: Resposta bem-sucedida contendo os detalhes da busca de empresas. content: application/json: schema: type: object properties: metadata: type: object description: >- 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: type: array description: >- As empresas semelhantes, ordenadas por similaridade. Observe que este endpoint retorna um array simples — diferente dos demais endpoints de busca, não há um wrapper `pagination` dentro de `data`. items: type: object example: data: pagination: page: 1 per_page: 25 total_entries: 45234700 total_pages: 1809388 companies: - logo_url: >- https://buckets.pubrio.com/company-logo/MjI0NDc1OTMxaWxqOXNzbmoxdHdpdHRlci5jb20=.jpg company_name: Twitter emails: - ... phones: - ... contacts: - ... founded_year: 2006 specialties: - Software Development industry: Software Development domain: twitter.com domain_search_id: 61a73da7-2efc-41a5-a252-a8a8df29925a domain_id: 224475931 linkedin_company_id: 44005587 linkedin_name: twitter is_company_url_active: true domain_ids: - 224475931 - 1758889566 - 368242865 company_keywords: - realtime information - social commerce - online shopping - classifieds - craigslist killers - e-commerce - killers - consumer internet - internet - information technology - edp services - technology - software development - microblogging - social networking - public conversation - user engagement - content sharing - advertising solutions - monetization - community building - digital wallet - ai integration - user safety company_size: 1500 youtube_url: null crunchbase_url: null linkedin_url: http://www.linkedin.com/company/twitter instagram_url: null facebook_url: http://facebook.com/twitterinc twitter_url: https://twitter.com/x github_url: null x_url: null location: United States company_ranking: null company_url: http://twitter.com saved_lists: null company_size_printed: 1,500 similarity_score: 0.87 - ... '400': $ref: '#/components/responses/general_error' '429': $ref: '#/components/responses/rate_limit_error' '500': $ref: '#/components/responses/server_error' components: schemas: company_name: type: string example: pubrio description: >- 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. companies: type: array items: type: string format: uuid description: >- Uma lista de identificadores únicos (domain_search_id) usada para operações de busca de empresas e pessoas. domains: type: array items: type: string example: - pubrio.com description: >- 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. company_linkedin_urls: type: array items: type: string example: - https://www.linkedin.com/company/pubrio description: >- A URL completa do perfil da empresa no LinkedIn. A URL começa com `http` e contém `linkedin.com/company/` locations: type: array items: type: string example: - US - SG - CN description: >- 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. exclude_locations: type: array items: type: string example: - CN - US - RU - CA description: >- 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. places: type: array items: type: string example: - Tokyo description: >- Nomes de lugares (cidade, região) usados para filtrar resultados. Aceita nomes de lugares localizados ou em inglês. exclude_places: type: array items: type: string example: - Tokyo description: >- Nomes de lugares (cidade, região) a serem excluídos dos resultados. Aceita nomes de lugares localizados ou em inglês. job_exclude_locations: allOf: - $ref: '#/components/schemas/exclude_locations' description: >- Localizações geográficas a serem excluídas dos resultados de vagas de emprego. posted_dates: type: array items: type: string example: - '2025-01-01' - '2025-01-10' description: >- 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. people_titles: type: array items: type: string example: - sales manager - marketing manager description: |- 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`. verticals: type: array items: type: integer description: >- 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: type: array items: type: integer description: >- 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: type: array items: type: integer description: >- 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: type: array items: type: integer description: >- 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: type: array items: type: integer description: >- 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: type: array items: type: array items: type: string example: - - 1 - 10 - - 11 - 20 - - 10001 description: >- 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. revenues: type: array items: type: integer example: - 0 - 100000 description: Intervalo mínimo e máximo da receita da empresa. founded_dates: type: array items: type: integer example: - 2018 - 2024 description: >- Intervalo de anos de fundação da empresa. O valor máximo de fundação é o ano atual. keywords: type: array items: type: string example: - ecommerce - ai - fintech description: >- Uma lista de palavras-chave para filtrar empresas por relevância, especialidades ou descrições. news_categories: type: array items: type: string example: - launches description: >- Lista de `category slugs` para buscar categorias de notícias específicas. Para encontrar um slug, chame o endpoint `news categories` na aba Filters. published_dates: type: array items: type: string example: - '2025-01-01' - '2025-01-10' description: >- 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. advertisement_search_terms: type: array items: type: string example: - asus description: >- Palavras-chave usadas para buscar no conteúdo ou nos títulos dos anúncios. advertisement_target_locations: allOf: - $ref: '#/components/schemas/target_locations' description: Localizações geográficas alvo para anúncios. advertisement_exclude_target_locations: allOf: - $ref: '#/components/schemas/exclude_target_locations' description: Localizações geográficas a serem excluídas da segmentação de anúncios. advertisement_start_dates: type: array items: type: string format: date example: - '2025-12-25' - '2025-12-25' description: Intervalo de data de início para filtragem de anúncios. advertisement_end_dates: type: array items: type: string format: date example: - '2025-12-25' - '2025-12-25' description: Intervalo de data de término para filtragem de anúncios. company_filter_conditions: type: array items: type: object properties: key: type: string enum: - keywords - verticals - vertical_categories - vertical_sub_categories - technologies - categories - advertisement_target_locations - advertisement_exclude_target_locations - advertisement_search_terms - places - exclude_places - job_exclude_locations example: keywords description: >- A chave de filtro que especifica a qual propriedade o operador deve ser aplicado. operator: type: string enum: - or - and example: or description: >- O operador lógico a ser aplicado. Use 'or' para corresponder a qualquer um dos valores especificados, ou 'and' para exigir todos os valores especificados. description: >- 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. is_enable_similarity_search: type: boolean description: >- Quando habilitado, os filtros listados acima que suportam buscas por similaridade podem ser preenchidos com texto livre para IDs específicos. similarity_score: type: number format: float example: 0.7 description: >- 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. exclude_fields: type: array items: type: string example: - emails - phones - contacts description: Lista de campos a serem excluídos do payload de resposta. is_parameter_metadata_available: type: boolean description: Indica se os metadados de parâmetro estão disponíveis para a requisição. is_profile_metadata_available: type: boolean description: Indica se os metadados de perfil estão disponíveis para a requisição. per_page: type: integer example: 25 default: 25 maximum: 25 description: >- 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](/pt/api-reference/endpoint/profile/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. page: type: integer example: 1 default: 1 description: >- 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](/pt/api-reference/endpoint/profile/profile). Excedê-lo retorna **HTTP 416**. company_filters: type: object description: >- 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. example: company_locations: - US technologies: - 37 - 152 founded_dates: - 2015 - 2023 filter_conditions: - key: technologies operator: and target_locations: type: array items: type: string example: - TW - AE - 'NO' description: >- Filtra anúncios para incluir aqueles direcionados a localizações específicas por código de país. Use isso para encontrar anúncios que estão sendo exibidos em países específicos. Combina-se com `filter_conditions` usando o operador OR - o anúncio deve ter como alvo pelo menos uma das localizações especificadas. exclude_target_locations: type: array items: type: string example: - IS - GB - FR - IE - ES description: >- Filtra anúncios para excluir aqueles direcionados a localizações específicas por código de país. Use isso para excluir anúncios que estão sendo exibidos em países específicos. Quando especificado em `filter_conditions` com o operador 'or', o anúncio não deve ter como alvo nenhuma das localizações excluídas. responses: general_error: description: >- Requisição inválida. A requisição estava malformada ou continha parâmetros inválidos. Verifique o código de erro e a mensagem para mais detalhes. content: application/json: schema: required: - code - message - details type: object properties: code: example: 40001 type: integer message: example: >- Os erros e códigos variam de acordo com o cenário; consulte a documentação para mais informações. type: string details: type: object rate_limit_error: description: >- Limite de requisições excedido. Foram feitas requisições em excesso em um determinado período de tempo. Tente novamente após a janela do limite de requisições ser reiniciada. content: application/json: schema: required: - error type: object properties: error: example: >- Limite de requisições excedido. Aguarde e tente novamente mais tarde. type: string server_error: description: >- Erro interno do servidor. Ocorreu um erro inesperado no servidor. Entre em contato com o suporte caso o erro persista. content: application/json: schema: required: - error type: object properties: error: example: Ocorreu um erro inesperado no servidor. type: string securitySchemes: pubrio_api_key: type: apiKey name: pubrio-api-key description: >- 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](https://dashboard.pubrio.com/#/settings/). in: header ````