> ## 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. # Detalhes de Expansão da Empresa > Perfil de expansão detalhado de uma única empresa — estágio atual, sinais, presença de mercado e histórico de transição de estágio — para um mercado ou agregado em todos os mercados. ## OpenAPI ````yaml pt-openapi POST /expansions/companies/lookup 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/lookup: post: tags: - Expansion summary: Detalhe de expansão da empresa description: >- Perfil de expansão detalhado de uma única empresa — estágio atual, sinais, presença de mercado e histórico de transição de estágio — para um mercado ou agregado em todos os mercados. operationId: expansions_company_lookup requestBody: required: true content: application/json: schema: type: object properties: country_code: $ref: '#/components/schemas/expansion_country_code' is_all_markets: $ref: '#/components/schemas/expansion_is_all_markets' signal_type: type: string enum: - AD - AUDIENCE - DNS - ENTITY - EVENT - EVENT_PLUS - EXEC - HIRE - INFRA - IP - NEWS - OFFICE - PARTNER - PRODUCT - REG - SCALE - TECH example: EXEC description: Filtra os sinais retornados para um único tipo. query: type: string example: >- We sell Employer-of-Record and local payroll; best-fit buyers hire in a new market before setting up a legal entity. description: >- Descrição em linguagem natural do que você vende, ou o perfil de comprador em relação ao qual você está avaliando esta empresa. Usado apenas para fundamentar o `summary` gerado por IA (veja `is_explain_match`); ao contrário da busca de empresas, aqui NÃO é interpretado como filtros. is_explain_match: type: boolean example: true description: >- Quando `true` e uma `query` é informada, `summary` retorna um único resumo gerado por IA da atividade de expansão desta empresa no escopo atual (o mercado selecionado, ou todos os mercados estrangeiros quando `is_all_markets` é `true`), lido em relação à sua `query` e fundamentado nos sinais reais da empresa com citações `[n]`. window_days: type: integer example: 90 default: 90 description: >- Opcional. Janela móvel (em dias) que limita o feed do `summary` gerado por IA. O padrão é **90** quando nem este campo nem `transitioned_dates` são informados. Não afeta a lista paginada `signals` (histórico completo). 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. domain: $ref: '#/components/schemas/domain' linkedin_url: $ref: '#/components/schemas/company_linkedin_url' domain_search_id: $ref: '#/components/schemas/domain_search_id' is_include_established: $ref: '#/components/schemas/expansion_is_include_established' page: $ref: '#/components/schemas/page' per_page: $ref: '#/components/schemas/per_page' 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 summary_only: type: boolean description: >- Retorna apenas o bloco de resumo de estágio (`data`, `company`, `markets_summary`, `signal_weekly_totals`, `recent_signals`, `expansion_score`, `summary`) e omite a lista de sinais e seus agregados. Muito mais leve para visualizações de destaque/cabeçalho. example: true markets_summary_full: type: boolean description: >- Inclui o conjunto completo de mercados classificados como `markets_summary`, junto com a lista limitada `other_markets`. example: true anyOf: - title: Domain Search ID required: - domain_search_id - title: Domain required: - domain - title: LinkedIn URL required: - linkedin_url responses: '200': description: Detalhe da empresa no mercado. content: application/json: schema: type: object properties: metadata: type: object data: type: object description: Contêiner de resultado. properties: domain_search_id: type: string description: Identificador de empresa da Pubrio. country_code: type: string description: Mercado-alvo, ISO 3166-1 alpha-2. country_name: type: string description: Nome do mercado-alvo. stage_rank: type: integer description: >- Classificação numérica do estágio; quanto maior, mais avançado. stage_name: type: string description: Nome de exibição do estágio. stage: type: object description: >- Detalhe do estágio — score, escopo, direção, atualidade e contagens de sinais. local_people_count: type: integer description: Funcionários localizados no mercado-alvo. local_people_coverage: type: boolean description: >- Se a cobertura de headcount é suficiente para confiar na contagem. presence: type: object description: >- Presença no mercado: o quão estabelecida a empresa já está, independentemente do seu estágio de expansão. properties: level: type: string enum: - established - emerging - none - no_data description: >- O quão estabelecida é a presença da empresa neste mercado: `established`, `emerging`, `none` ou `no_data`. Isso é a presença, não o estágio de expansão. local_people_count: type: integer description: Funcionários localizados no mercado-alvo. matched_rule: type: string nullable: true description: >- Qual sinal estabeleceu o nível — por exemplo, `office`, `headcount` ou `share`. `null` quando nenhuma regra correspondeu. read: type: object description: Status de leitura deste registro. signals: type: array description: >- As linhas de sinal paginadas por trás deste par empresa/mercado — a lista de evidências. O tamanho da página e os totais vêm de `metadata.pagination`. items: type: object summary: type: object description: >- Resumo de estágio em uma linha para o par. Apenas na primeira página. company: type: object description: >- Dados de identidade da empresa — nome, domínio, logo e URLs de redes sociais. Apenas na primeira página. signal_group_totals: type: array description: >- Contagens de sinais por tipo, agrupadas por dia no seu fuso horário. Apenas na primeira página. items: type: object signal_type_totals: type: array description: >- Totais de sinais de todos os tempos por tipo de sinal. Apenas na primeira página. items: type: object signal_type_recent_totals: type: array description: >- Totais de sinais por tipo nas últimas 12 semanas. Apenas na primeira página. items: type: object signal_weekly_totals: type: array description: >- Contagens semanais de sinais para o mapa de calor, na mesma janela de `signal_type_recent_totals`. Apenas na primeira página. items: type: object evidence_breakdown: type: object description: >- Consolidação de evidências por tipo de fonte, calculada a partir dos sinais retornados (redigidos). Apenas na primeira página. presence: type: object description: >- Presença física e digital observada da empresa neste mercado. Apenas na primeira página. suppressions: type: array description: >- Sinais suprimidos do cálculo de estágio, com o motivo de cada um. Apenas na primeira página. items: type: object timeline: type: array description: >- Histórico de transição de estágio para este par empresa/mercado. Apenas na primeira página. items: type: object other_markets: type: array description: >- Os outros mercados ativos da empresa. Limitado em planos restritos — veja `other_markets_locked_count`. Apenas na primeira página. items: type: object other_markets_locked_count: type: integer description: >- Quantos mercados adicionais seu plano não retornou em `other_markets`. `0` quando nada foi omitido. markets_summary: type: array description: >- Conjunto completo de mercados classificados para esta empresa. Retornado apenas quando `markets_summary_full` é `true`, na primeira página. items: type: object example: metadata: filters: domain_search_id: 8f3c1b04-2e7a-4d19-9c55-6ab21f0e7d3c country_code: US country_code_auto_picked: false pagination: page: 1 per_page: 25 total_entries: 12 total_pages: 1 total_display_pages: 1 is_timeout: false data: domain_search_id: 8f3c1b04-2e7a-4d19-9c55-6ab21f0e7d3c country_code: US country_name: United States stage_rank: 3 stage_name: Expanding stage: slug: expanding expansion_score: 0.721 scope: entering_new_market direction: advancing freshness: fresh contraction_flag: null mode_change_flag: false signal_count: 5 distinct_type_count: 3 has_known_presence: false first_signal_at: '2026-05-30T09:00:00.000Z' latest_signal_at: '2026-06-20T14:00:00.000Z' last_transition_at: '2026-06-15T09:30:00.000Z' signals: - signal_type_slug: EXEC signal_subtype_slug: country_manager signal_strength_slug: high polarity: expansion event_date: '2026-06-20T14:00:00.000Z' source_type: linkedin display_label: Hired Regional VP for North America evidence_url: https://linkedin.com/company/example-corp source_published_at: '2026-06-20T14:00:00.000Z' lead_time_days: 0 presence: - presence_type: office presence_strength: high address: 123 Market St, San Francisco, CA known_since: '2026-03-15T00:00:00.000Z' timeline: - stage_slug: expanding transitioned_at: '2026-06-15T09:30:00.000Z' transition_kind: advance other_markets: - country_code: CA stage_slug: committing signal_count: 8 first_signal_at: '2026-04-10T00:00:00.000Z' latest_signal_at: '2026-06-22T16:45:00.000Z' last_transition_at: '2026-06-18T00:00:00.000Z' '400': $ref: '#/components/responses/general_error' '429': $ref: '#/components/responses/rate_limit_error' '500': $ref: '#/components/responses/server_error' components: schemas: expansion_country_code: type: string example: US description: >- Mercado-alvo como um código de país ISO 3166-1 alpha-2 (cca2). Omita para selecionar automaticamente o mercado mais ativo da empresa; defina `is_all_markets` para uma visão entre mercados de todos os mercados. expansion_is_all_markets: type: boolean example: false description: >- Retorna toda a pegada de expansão da empresa em TODOS os mercados em uma única chamada, em vez de um único mercado. Quando `true`, `country_code` é ignorado, o mercado de origem é excluído dos agregados de sinais quando pode ser identificado, `data` passa a ser um resumo em nível de empresa (estágio predominante, total de sinais, intervalo de datas, maior pontuação de expansão) e `markets_summary` lista todos os mercados. O padrão é false. domain: type: string example: pubrio.com description: >- 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. company_linkedin_url: 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/` domain_search_id: type: string format: uuid description: Um identificador único para a operação de busca de empresas. 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. 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**. 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. 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 ````