> ## 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. # Resumos em Lote de Expansão de Empresas > Resumos de expansão prontos para renderização de um lote de empresas, preparados para comparação lado a lado sem agregação no cliente. ## OpenAPI ````yaml pt-openapi POST /expansions/companies/summaries 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/summaries: post: tags: - Expansion summary: Resumos de expansão de empresas em lote description: >- Resumos de expansão prontos para renderização de um lote de empresas, preparados para comparação lado a lado sem agregação no cliente. operationId: expansions_company_summaries 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' 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 description: >- Delimite as empresas com um único array `companies` de identificadores mistos — `domain_search_id`, domínio da empresa ou URL do LinkedIn — combinados como união (não interseção). As chaves legadas `domain_search_ids`, `domains` e `linkedin_urls` continuam aceitas para compatibilidade retroativa. Até 25 empresas resolvidas por requisição. responses: '200': description: >- Array de resumos de expansão por empresa. Dois scores: o `expansion_score` de nível superior é a postura geral atual em todos os mercados (estável); `summary.window_expansion_score` é a mesma medida restrita à janela selecionada. Ambos estão em uma escala de 0 a 100 aqui (diferente do `stage.expansion_score` de 0 a 1 nos resultados de busca). Quando seu plano não inclui contagens de funcionários, `firmographics` retorna `company_size`, `employees_count` e `company_size_printed` como `null` e define `is_employees_locked: true`. content: application/json: schema: type: object properties: metadata: type: object data: type: object properties: companies: type: array items: type: object description: >- Um resumo pronto para renderização por empresa solicitada. example: metadata: {} data: companies: - domain_search_id: 8f3c1b04-2e7a-4d19-9c55-6ab21f0e7d3c home_country_code: SG expansion_score: 82 firmographics: domain_search_id: 8f3c1b04-2e7a-4d19-9c55-6ab21f0e7d3c company_name: Example Corp domain: example.com logo_url: https://logo.pubrio.com/example.com.png country_code: SG company_size: null employees_count: 350 company_size_printed: 351+ is_employees_locked: false 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 signal_weekly_totals: - week_start: '2026-06-22' signal_type_slug: HIRE count: 5 summary: active_markets: 1 total_markets: 1 new_markets: 1 momentum_pct: 22 signal_count: 12 window_expansion_score: 69 scaling: 0 pipeline: 1 top_market: country_code: US country: null stage: committing newest_market: country_code: US country: null stage: committing activity_weekly: - 3 - 5 - 4 '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 ````