> ## 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.

# 批量获取公司扩张摘要

> 为一组公司提供可直接渲染的扩张摘要，便于直接进行横向对比，无需在客户端二次聚合。



## OpenAPI

````yaml cn-openapi POST /expansions/companies/summaries
openapi: 3.0.0
info:
  description: >-
    Pubrio API 提供市场扩张情报——实时捕捉企业进入新市场的信号，以及其底层的公司与人员数据。可搜索、查找并丰富账户与联系人信息，并订阅覆盖
    200+ 市场、带类型与日期的动向信号。
  version: 1.0.0
  title: Pubrio OpenAPI
  termsOfService: https://pubrio.com/zh-CN/terms-of-service
  contact:
    email: king.lai@pubrio.com
    name: King Lai
    url: https://pubrio.com/zh-CN/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: 工作区配置信息和使用统计
  - name: Enrichment
    description: 通过详细的 B2B 数据丰富人员和公司记录
  - name: Lookalike
    description: 查找与指定公司相似的公司
  - name: Search
    description: 使用筛选条件搜索人员、公司、职位、新闻和广告
  - name: Lookup
    description: 查找特定人员、公司、职位、新闻、广告和技术的详细信息
  - name: LinkedIn
    description: 通过 LinkedIn 个人资料 URL 查找人员和公司数据
  - name: Redeem
    description: 兑换积分以解锁人员联系方式（单个和批量）
  - name: Channels
    description: 管理外展渠道模板（创建、更新、删除、列表）
  - name: Monitor
    description: 创建和管理数据监控，包括 Webhook、统计和处理
  - name: Filters
    description: 获取搜索参数的可用筛选值（技术、地点、垂直领域等）
  - name: API Keys
    description: 查看 API 密钥的请求日志和使用情况分析
  - name: Insights
    description: 公司的信号聚合洞察(招聘、新闻、广告)。
  - name: Export
    description: 批量数据导出(消耗积分)。
  - name: Expansion
    description: 公司市场扩张情报:信号、阶段、市场与导出。
externalDocs:
  description: Pubrio API 用于搜索、预览和增强联系人及账户信息。Pubrio 数据库提供丰富的 B2B 联系人和销售情报数据。
  url: https://docs.pubrio.com
paths:
  /expansions/companies/summaries:
    post:
      tags:
        - Expansion
      summary: 批量获取公司扩张摘要
      description: 为一组公司提供可直接渲染的扩张摘要，便于直接进行横向对比，无需在客户端二次聚合。
      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: 信号/转换窗口的 ISO `[from, to]` 日期范围。如果同时提供了 `window_days`，则此参数优先。
                window_days:
                  $ref: '#/components/schemas/window_days'
                is_include_established:
                  $ref: '#/components/schemas/expansion_is_include_established'
                profile_id:
                  $ref: '#/components/schemas/profile_id'
              description: >-
                使用单个 `companies` 数组来限定公司范围，可混合传入 `domain_search_id`、公司域名或
                LinkedIn URL，匹配结果为并集（而非交集）。为向后兼容，仍支持旧的
                `domain_search_ids`、`domains`、`linkedin_urls` 字段。每次请求最多解析 25
                家公司。
      responses:
        '200':
          description: >-
            公司扩张摘要数组，每个元素对应一家公司。包含两个分数：顶层 `expansion_score`
            为跨所有市场的整体当前态势（稳定值）；`summary.window_expansion_score` 为按所选时间窗口计算的同一指标。
          content:
            application/json:
              schema:
                type: object
                properties:
                  metadata:
                    type: object
                  data:
                    type: object
                    properties:
                      companies:
                        type: array
                        items:
                          type: object
              example:
                metadata: {}
                data:
                  companies:
                    - domain_search_id: 550e8400-e29b-41d4-a716-446655440002
                      home_country_code: SG
                      expansion_score: 82
                      firmographics:
                        domain_search_id: 550e8400-e29b-41d4-a716-446655440002
                        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_90d: 1
                        momentum_pct: 22
                        signal_count_90d: 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
components:
  schemas:
    expansion_companies:
      type: array
      items:
        type: string
      example:
        - stripe.com
        - https://www.linkedin.com/company/airbnb
        - 550e8400-e29b-41d4-a716-446655440000
      description: 通过 `domain_search_id`、公司域名或公司社交媒体主页链接的任意组合来指定公司。域名和链接会解析为排名最高的公司。
    domains:
      type: array
      items:
        type: string
      example:
        - pubrio.com
      description: >-
        用于公司和人员检索操作的公司域名列表。如果收到的地址为 `www.pubrio.com` 或
        `https://docs.pubrio.com/`，系统会自动转换为 `pubrio.com` 进行处理。
    company_linkedin_urls:
      type: array
      items:
        type: string
      example:
        - https://www.linkedin.com/company/pubrio
      description: LinkedIn 公司主页的完整 URL。URL 需以 `http` 开头且包含 `linkedin.com/company/`。
    window_days:
      type: integer
      example: 90
      description: 可选。滚动时间窗口的天数。在未提供明确的 `transitioned_dates` 范围时使用;若两者均未提供,则使用默认时间窗口。
    expansion_is_include_established:
      type: boolean
      example: false
      description: 包含 `established` 阶段（无活跃扩张信号的长期运营者）。默认为 false。
    profile_id:
      type: integer
      description: >-
        可选。发起请求的团队标识符。由于 API 密钥已包含您的工作区信息，此参数不再是必填项。如果提供，该 ID
        有助于将查找与特定团队（工作区）关联，实现数据检索和额度追踪。


        更多信息请参见团队标签下的 `user details` 端点。
  securitySchemes:
    pubrio_api_key:
      type: apiKey
      name: pubrio-api-key
      description: >-
        一个唯一的 API 令牌，用于标识您通过 API 执行的操作以及相应的权限和操作。您可以在
        [设置](https://dashboard.pubrio.com/#/settings/) 部分创建该令牌。
      in: header

````