> ## 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 ko-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/ko/terms-of-service
  contact:
    email: king.lai@pubrio.com
    name: King Lai
    url: https://pubrio.com/ko/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: 웹훅, 통계 및 처리를 포함한 데이터 모니터 생성 및 관리
  - 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`, 회사 도메인 또는 회사 소셜 미디어 프로필 URL의 임의 조합으로 회사를 지정합니다. 도메인과
        URL은 순위가 가장 높은 회사로 확인됩니다.
    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입니다. `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 키에 이미 워크스페이스 정보가 포함되어 있으므로 이 매개변수는 더 이상
        필수가 아닙니다. 제공되면 조회 및 사용 크레딧 추적을 위해 특정 팀(작업 공간)과 연계됩니다.


        자세한 내용은 팀 탭의 `user details` 엔드포인트를 참고하세요.
  securitySchemes:
    pubrio_api_key:
      type: apiKey
      name: pubrio-api-key
      description: >-
        API에서 수행하는 작업 및 해당 권한을 식별하는 고유한 API 토큰입니다. 이 토큰은
        [설정](https://dashboard.pubrio.com/#/settings/) 섹션에서 생성할 수 있습니다.
      in: header

````