> ## 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. # Comparar Expansões de Empresas > Compara a presença de expansão de várias empresas lado a lado, com pares comparáveis opcionais para uma empresa-alvo. ## OpenAPI ````yaml pt-openapi POST /expansions/companies/compare 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: /expansions/companies/compare: post: tags: - Expansion summary: Comparar expansões de empresas description: >- Compara a presença de expansão de várias empresas lado a lado, com pares comparáveis opcionais para uma empresa-alvo. operationId: expansions_company_compare requestBody: required: true content: application/json: schema: type: object properties: companies: $ref: '#/components/schemas/expansion_companies' domains: $ref: '#/components/schemas/domains' linkedin_urls: $ref: '#/components/schemas/company_linkedin_urls' transitioned_dates: type: array items: type: string format: date example: - '2026-04-01' - '2026-06-29' description: >- Intervalo de datas ISO `[from, to]` para a janela de sinal/transição. Tem precedência sobre `window_days` quando ambos são informados. window_days: $ref: '#/components/schemas/window_days' seed_target: type: string example: 8f3c1b04-2e7a-4d19-9c55-6ab21f0e7d3c description: >- A empresa em `companies` a ser tratada como o alvo de referência (benchmark). As demais são classificadas por volume de sinal e confiança, e os principais pares são retornados em `metadata.seeded_peers`. Ele seleciona a partir da lista enviada; não encontra novas empresas. is_include_established: $ref: '#/components/schemas/expansion_is_include_established' is_include_metadata: type: boolean description: >- Retorna o payload completo de detalhes. O tráfego via chave de API é enxuto por padrão: o bloco `model`, os valores de confiança (`stage.confidence` em Company Expansion Detail, `confidence_score` em `other_markets[]` e em `markers[]` de Rankings) e os campos `established_min` / `share_of_detected` / `has_known_office` são todos omitidos, a menos que este valor seja `true`. example: true responses: '200': description: Comparação por empresa, indexada por domain_search_id. content: application/json: schema: type: object properties: metadata: type: object properties: seeded_peers: type: array items: type: string description: >- Os pares selecionados para `seed_target`, com a melhor correspondência primeiro. Vazio quando `seed_target` é omitido. peer_cap: type: integer nullable: true description: >- Número máximo de pares que seu plano pode comparar, ou `null` quando ilimitado. peers_available: type: integer description: >- Quantos pares tiveram sinais na janela, antes da aplicação de `peer_cap`. data: type: object properties: companies: type: array items: type: object description: >- Uma entrada para cada empresa comparada, na ordem solicitada. example: metadata: seeded_peers: - 8f3c1b04-2e7a-4d19-9c55-6ab21f0e7d3c data: companies: - domain_search_id: 8f3c1b04-2e7a-4d19-9c55-6ab21f0e7d3c home_country_code: SG firmographics: company_name: Example Corp country_code: SG company_size: 350 founded_year: 2015 industry: Software Development publicly_traded_symbol: null estimated_revenue: 25000000 markets_summary: - country_code: US stage_slug: committing signal_count: 12 distinct_type_count: 4 first_signal_at: '2026-04-02T08:00:00.000Z' latest_signal_at: '2026-06-28T10:15:22.000Z' last_transition_at: '2026-06-25T14:30:00.000Z' expansion_score: 0.685 signals: - signal_type_slug: EXEC signal_subtype_slug: country_manager event_date: '2026-06-20T14:00:00.000Z' display_label: Hired Regional VP for North America '400': $ref: '#/components/responses/general_error' '429': $ref: '#/components/responses/rate_limit_error' '500': $ref: '#/components/responses/server_error' components: schemas: expansion_companies: type: array items: type: string example: - stripe.com - https://www.linkedin.com/company/airbnb - b7d92a56-31f8-4c0b-ae43-19c8e5f24b70 description: >- Restringe a empresas específicas usando qualquer combinação de `domain_search_id`, domínio da empresa ou URL de perfil de rede social da empresa. Domínios e URLs são resolvidos para a empresa de melhor classificação. 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/` window_days: type: integer example: 90 description: >- Opcional. Tamanho da janela móvel em dias. Usado quando um intervalo explícito de `transitioned_dates` não é fornecido; se ambos forem omitidos, uma janela padrão é usada. expansion_is_include_established: type: boolean example: false description: >- Inclui o estágio `established` (operadores de longa data sem sinais de expansão ativos). O padrão é false. 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 ````