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

# 확장 개요

> 시장 단위 확장 KPI — 시장별 단계 카운트와 주요 국경 간 흐름. 집계된 값이며 페이지네이션되지 않습니다.



## OpenAPI

````yaml ko-openapi POST /expansions/dashboard
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/dashboard:
    post:
      tags:
        - Expansion
      summary: 확장 개요
      description: 시장 단위 확장 KPI — 시장별 단계 카운트와 주요 국경 간 흐름. 집계된 값이며 페이지네이션되지 않습니다.
      operationId: expansions_dashboard
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                froms:
                  $ref: '#/components/schemas/expansion_froms'
                tos:
                  $ref: '#/components/schemas/expansion_tos'
                exclude_froms:
                  $ref: '#/components/schemas/expansion_exclude_froms'
                exclude_tos:
                  $ref: '#/components/schemas/expansion_exclude_tos'
                stages:
                  $ref: '#/components/schemas/expansion_stages'
                momentum:
                  $ref: '#/components/schemas/expansion_momentum'
                freshness:
                  $ref: '#/components/schemas/expansion_freshness'
                scopes:
                  $ref: '#/components/schemas/expansion_scopes'
                ahead_of_pace:
                  type: boolean
                  example: false
                  description: 해당 시장의 일반적인 속도보다 빠르게 움직이는 회사/시장 쌍으로 제한합니다.
                signal_types:
                  $ref: '#/components/schemas/expansion_signal_type_slugs'
                signal_strengths:
                  $ref: '#/components/schemas/signal_strengths'
                min_signal_count:
                  type: integer
                  example: 3
                  description: >-
                    해당 기간 동안 회사가 보유해야 하는 최소 확장 신호 수입니다 — "매우 활발함 / 활동 범위가 넓음"을
                    걸러냅니다.
                only_contraction:
                  $ref: '#/components/schemas/only_contraction'
                verticals:
                  $ref: '#/components/schemas/verticals'
                vertical_categories:
                  $ref: '#/components/schemas/vertical_categories'
                vertical_sub_categories:
                  $ref: '#/components/schemas/vertical_sub_categories'
                technologies:
                  $ref: '#/components/schemas/technologies'
                employees:
                  $ref: '#/components/schemas/employees'
                revenues:
                  $ref: '#/components/schemas/revenues'
                founded_dates:
                  $ref: '#/components/schemas/founded_dates'
                keywords:
                  $ref: '#/components/schemas/keywords'
                companies:
                  $ref: '#/components/schemas/expansion_companies'
                job_locations:
                  $ref: '#/components/schemas/locations'
                job_exclude_locations:
                  $ref: '#/components/schemas/job_exclude_locations'
                job_posted_dates:
                  $ref: '#/components/schemas/posted_dates'
                job_titles:
                  $ref: '#/components/schemas/people_titles'
                advertisement_target_locations:
                  $ref: '#/components/schemas/advertisement_target_locations'
                advertisement_exclude_target_locations:
                  $ref: '#/components/schemas/advertisement_exclude_target_locations'
                advertisement_search_terms:
                  $ref: '#/components/schemas/advertisement_search_terms'
                advertisement_start_dates:
                  $ref: '#/components/schemas/advertisement_start_dates'
                advertisement_end_dates:
                  $ref: '#/components/schemas/advertisement_end_dates'
                news_categories:
                  $ref: '#/components/schemas/news_categories'
                news_published_dates:
                  $ref: '#/components/schemas/published_dates'
                transitioned_dates:
                  type: array
                  items:
                    type: string
                    format: date
                  example:
                    - '2026-06-01'
                    - '2026-06-29'
                  description: 관심 목록 타임라인의 ISO 날짜 범위 [start, end]입니다. 기본값은 최근 30일입니다.
                window_days:
                  $ref: '#/components/schemas/window_days'
                select_size:
                  type: integer
                  example: 250
                  description: 반환할 시장의 최대 개수입니다(플랜별 상한 적용).
                flows_size:
                  type: integer
                  example: 50
                  description: 반환할 국경 간 흐름의 최대 개수입니다(플랜별 상한 적용).
                profile_id:
                  $ref: '#/components/schemas/profile_id'
      responses:
        '200':
          description: 시장 대시보드 집계 데이터입니다.
          content:
            application/json:
              schema:
                type: object
                properties:
                  metadata:
                    type: object
                  data:
                    type: object
                    description: '대시보드 컨테이너: 순위가 매겨진 시장과 상위 코리도 흐름입니다.'
                    properties:
                      countries:
                        type: array
                        description: 시장별 신호 수와 함께 순위가 매겨진 시장입니다.
                        items:
                          type: object
                      top_flows:
                        type: array
                        items:
                          type: object
              example:
                metadata:
                  filters:
                    froms:
                      - CN
                    tos:
                      - GB
                  select_size: 250
                  flows_size: 50
                  transitioned_dates:
                    - '2026-06-01'
                    - '2026-06-29'
                data:
                  countries:
                    - country_code: US
                      inbound_count: 18
                      outbound_count: 5
                      total_companies_with_signals: 23
                      exploring_count: 8
                      committing_count: 10
                      expanding_count: 4
                      scaling_count: 1
                      new_transitions_30d: 3
                      freshest_transition_at: '2026-06-27T14:32:10.000Z'
                  top_flows:
                    - home_country_code: SG
                      country_code: US
                      company_count: 5
                      new_transitions_30d: 1
components:
  schemas:
    expansion_froms:
      type: array
      items:
        type: string
      example:
        - US
        - GB
      description: >-
        출발 시장(ISO 3166-1 alpha-2). 기업이 어디에서부터 확장하는지 — 본사 / 모국. 단독으로 사용하면 이 시장에서
        밖으로 확장하는 기업을 찾고, `tos`와 함께 사용하면 특정 출발→도착 코리도를 지정합니다.
    expansion_tos:
      type: array
      items:
        type: string
      example:
        - US
        - GB
      description: >-
        도착 시장(ISO 3166-1 alpha-2). 기업이 어디로 확장하는지. 단독으로 사용하면 이 시장에 진입하는 모든 기업을
        찾고, `froms`와 함께 사용하면 특정 출발→도착 코리도를 지정합니다.
    expansion_exclude_froms:
      type: array
      items:
        type: string
      example:
        - US
        - GB
      description: 제외할 출발 시장(ISO 3166-1 alpha-2).
    expansion_exclude_tos:
      type: array
      items:
        type: string
      example:
        - US
        - GB
      description: 제외할 도착 시장(ISO 3166-1 alpha-2).
    expansion_stages:
      type: array
      items:
        type: string
        enum:
          - exploring
          - committing
          - expanding
          - scaling
          - established
      example:
        - committing
        - expanding
      description: 하나 이상의 확장 단계로 필터링합니다. 단계 정의는 Expansion Signals 지식 베이스를 참고하세요.
    expansion_momentum:
      type: array
      items:
        type: string
        enum:
          - accelerating
          - advancing
          - steady
          - pulling_back
      example:
        - accelerating
        - advancing
      description: >-
        확장 모멘텀(단계 간 이동 궤적)으로 필터링합니다: `accelerating`(모드 변화를 동반한 가속 전진),
        `advancing`(전진), `steady`(안정), `pulling_back`(후퇴 또는 축소).
    expansion_freshness:
      type: array
      items:
        type: string
        enum:
          - fresh
          - cooling
          - stale
          - cold
      example:
        - fresh
        - cooling
      description: >-
        증거의 최신성으로 필터링합니다: fresh(약 30일), cooling(약 30–60일), stale(약 60–90일),
        cold(90일 초과).
    expansion_scopes:
      type: array
      items:
        type: string
        enum:
          - entering_new_market
          - expanding_within_presence
          - established_only
      example:
        - entering_new_market
      description: 시장 진입 범위로 필터링합니다.
    expansion_signal_type_slugs:
      type: array
      items:
        type: string
        enum:
          - AD
          - NEWS
          - INFRA
          - PARTNER
          - EVENT_PLUS
          - EXEC
          - OFFICE
          - HIRE
          - SCALE
          - PRODUCT
      example:
        - EXEC
        - HIRE
      description: 특정 신호 유형으로 필터링합니다.
    signal_strengths:
      type: array
      items:
        type: string
        enum:
          - low
          - medium
          - high
          - very_high
      example:
        - high
        - very_high
      description: 신호 강도 구간으로 필터링합니다.
    only_contraction:
      type: boolean
      example: false
      description: true인 경우 축소로 표시된 확장만 반환합니다(규모를 축소하는 회사).
    verticals:
      type: array
      items:
        type: integer
      description: >-
        `vertical_id` 목록으로, 특정 산업 또는 분야의 회사를 검색합니다. ID를 얻으려면 필터 탭의 `vertical`
        엔드포인트를 호출하세요.


        이 필터는 `is_enable_similarity_search`를 지원하며, `["AI"]`와 같은 자유 텍스트 검색이
        가능합니다.
    vertical_categories:
      type: array
      items:
        type: integer
      description: >-
        `vertical_category_id` 목록으로, 특정 산업 카테고리에 속한 회사를 검색합니다. ID를 얻으려면 필터 탭의
        `vertical category` 엔드포인트를 호출하세요.


        이 필터는 `is_enable_similarity_search`를 지원하며 `["Information Technology"]`와
        같은 텍스트 입력이 가능합니다.
    vertical_sub_categories:
      type: array
      items:
        type: integer
      description: >-
        `vertical_sub_category_id` 목록으로, 특정 산업 하위 카테고리에 속한 회사를 검색합니다. ID를 얻으려면
        필터 탭의 `vertical sub category` 엔드포인트를 호출하세요.


        이 필터는 `is_enable_similarity_search`를 지원하며 `["Software"]`와 같은 자유 텍스트 검색이
        가능합니다.
    technologies:
      type: array
      items:
        type: integer
      description: >-
        `tag_id` 목록으로, 특정 기술을 사용하는 회사를 검색하는 데 사용됩니다. ID를 얻으려면 필터 탭의 `technology`
        엔드포인트를 호출하세요.


        이 필터는 `is_enable_similarity_search`를 지원하며, 활성화 시 `["Shopify"]`와 같은 자유
        텍스트 입력이 가능합니다.
    employees:
      type: array
      items:
        type: array
        items:
          type: string
      example:
        - - 1
          - 10
        - - 11
          - 20
        - - 10001
      description: >-
        회사 직원 수 범위입니다. 총 직원 수를 기준으로 회사를 필터링할 수 있으며, 여러 범위를 추가해 검색 결과를 확장할 수
        있습니다.


        자세한 내용은 필터 탭의 `company size` 엔드포인트를 참조하세요.
    revenues:
      type: array
      items:
        type: integer
      example:
        - 0
        - 100000
      description: 회사의 최소 및 최대 수익 범위입니다.
    founded_dates:
      type: array
      items:
        type: integer
      example:
        - 2018
        - 2024
      description: 회사의 설립 연도 범위입니다. 최대값은 현재 연도입니다.
    keywords:
      type: array
      items:
        type: string
      example:
        - ecommerce
        - ai
        - fintech
      description: 회사 검색 결과를 관련성, 전문 분야 또는 설명으로 필터링하기 위한 키워드 목록입니다.
    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은 순위가 가장 높은 회사로 확인됩니다.
    locations:
      type: array
      items:
        type: string
      example:
        - US
        - SG
        - CN
      description: >-
        ISO 3166-1 alpha-2(cca2) 코드로 지역을 필터링하는 데 사용됩니다. 자세한 내용은 필터 탭의 `location`
        엔드포인트를 참조하세요.
    job_exclude_locations:
      $ref: '#/components/schemas/exclude_locations'
      description: 채용 공고 결과에서 제외할 지리적 위치.
    posted_dates:
      type: array
      items:
        type: string
      example:
        - '2025-01-01'
        - '2025-01-10'
      description: 게시 날짜 범위입니다. 최대값은 오늘 날짜입니다.
    people_titles:
      type: array
      items:
        type: string
      example:
        - sales manager
        - marketing manager
      description: >-
        검색 대상 인물의 직함입니다.


        `software engineer`를 검색하면 `senior software engineer`와 같이 유사한 용어를 포함한 결과도
        반환될 수 있습니다.
    advertisement_target_locations:
      $ref: '#/components/schemas/target_locations'
      description: 광고의 대상 지리적 위치.
    advertisement_exclude_target_locations:
      $ref: '#/components/schemas/exclude_target_locations'
      description: 광고 타겟팅에서 제외할 지리적 위치.
    advertisement_search_terms:
      type: array
      items:
        type: string
      example:
        - asus
      description: 광고 콘텐츠 또는 제목 내에서 검색하는 데 사용되는 키워드입니다.
    advertisement_start_dates:
      type: array
      items:
        type: string
        format: date
      example:
        - '2025-12-25'
        - '2025-12-25'
      description: 광고 필터링을 위한 시작 날짜 범위입니다.
    advertisement_end_dates:
      type: array
      items:
        type: string
        format: date
      example:
        - '2025-12-25'
        - '2025-12-25'
      description: 광고 필터링을 위한 종료 날짜 범위입니다.
    news_categories:
      type: array
      items:
        type: string
      example:
        - launches
      description: >-
        `category slugs` 목록으로, 특정 뉴스 카테고리를 검색합니다. slug를 얻으려면 필터 탭의 `news
        categories` 엔드포인트를 호출하세요.
    published_dates:
      type: array
      items:
        type: string
      example:
        - '2025-01-01'
        - '2025-01-10'
      description: 발행 날짜 범위입니다. 최대값은 오늘 날짜입니다.
    window_days:
      type: integer
      example: 90
      description: >-
        선택 사항. 롤링 윈도우의 일수입니다. 명시적인 `transitioned_dates` 범위가 제공되지 않을 때 사용되며, 둘 다
        생략하면 기본 윈도우가 사용됩니다.
    profile_id:
      type: integer
      description: >-
        선택 사항. 요청을 수행하는 팀 식별자입니다. API 키에 이미 워크스페이스 정보가 포함되어 있으므로 이 매개변수는 더 이상
        필수가 아닙니다. 제공되면 조회 및 사용 크레딧 추적을 위해 특정 팀(작업 공간)과 연계됩니다.


        자세한 내용은 팀 탭의 `user details` 엔드포인트를 참고하세요.
    exclude_locations:
      type: array
      items:
        type: string
      example:
        - CN
        - US
        - RU
        - CA
      description: >-
        반환하지 않을 지역을 ISO 3166-1 alpha-2(cca2) 코드로 지정합니다. 자세한 내용은 필터 탭의 `location`
        엔드포인트를 참조하세요.
    target_locations:
      type: array
      items:
        type: string
      example:
        - TW
        - AE
        - 'NO'
      description: >-
        국가 코드를 사용하여 특정 위치를 타겟팅하는 광고를 필터링합니다. 특정 국가에서 표시되는 광고를 찾는 데 사용합니다.
        `filter_conditions`와 함께 OR 연산자를 사용합니다 - 광고는 지정된 위치 중 최소 하나를 타겟팅해야 합니다.
    exclude_target_locations:
      type: array
      items:
        type: string
      example:
        - IS
        - GB
        - FR
        - IE
        - ES
      description: >-
        국가 코드를 사용하여 특정 위치를 타겟팅하는 광고를 제외합니다. 특정 국가에서 표시되는 광고를 필터링하여 제외합니다.
        `filter_conditions`에서 'or' 연산자와 함께 지정된 경우, 광고는 제외된 위치 중 어느 곳도 타겟팅하지 않아야
        합니다.
  securitySchemes:
    pubrio_api_key:
      type: apiKey
      name: pubrio-api-key
      description: >-
        API에서 수행하는 작업 및 해당 권한을 식별하는 고유한 API 토큰입니다. 이 토큰은
        [설정](https://dashboard.pubrio.com/#/settings/) 섹션에서 생성할 수 있습니다.
      in: header

````