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

# 확장 신호 검색

> 집계된 회사 단위가 아니라 원본 확장 신호 행을 직접 검색합니다. 각 신호는 유형, 하위 유형, 강도, 극성, 날짜가 지정된 이벤트, 출처, 증거 URL을 포함하므로 어떤 요인이 회사의 단계를 움직였는지 정확히 감사하거나 그 위에 자체 스코어링을 구축할 수 있습니다.

**이 호출은 반드시 특정 회사로 범위를 좁히세요.** `domain_search_id_list`를 전달합니다. 신호 테이블이 매우 크기 때문에 시장이나 날짜 범위만으로 필터링한 요청은 게이트웨이 타임아웃 안에 완료되지 못하고 약 60초 후 연결이 끊깁니다. 회사 범위를 지정한 호출은 보통 1초 미만에 반환됩니다.

회사 단위 결과는 [Expansion Search](/ko/api-reference/endpoint/expansions/market_lookup)를, 단일 회사의 피드는 [Company Signal Events](/ko/api-reference/endpoint/expansions/company_pulse_events)를 사용하세요.



## OpenAPI

````yaml ko-openapi POST /expansions/signals/search
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/signals/search:
    post:
      tags:
        - Expansion
      summary: 확장 신호 검색
      description: >-
        집계된 회사 단위가 아니라 원본 확장 신호 행을 직접 검색합니다. 각 신호는 유형, 하위 유형, 강도, 극성, 날짜가 지정된
        이벤트, 출처, 증거 URL을 포함하므로 어떤 요인이 회사의 단계를 움직였는지 정확히 감사하거나 그 위에 자체 스코어링을 구축할
        수 있습니다.


        **이 호출은 반드시 특정 회사로 범위를 좁히세요.** `domain_search_id_list`를 전달합니다. 신호 테이블이
        매우 크기 때문에 시장이나 날짜 범위만으로 필터링한 요청은 게이트웨이 타임아웃 안에 완료되지 못하고 약 60초 후 연결이
        끊깁니다. 회사 범위를 지정한 호출은 보통 1초 미만에 반환됩니다.


        회사 단위 결과는 [Expansion
        Search](/ko/api-reference/endpoint/expansions/market_lookup)를, 단일 회사의
        피드는 [Company Signal
        Events](/ko/api-reference/endpoint/expansions/company_pulse_events)를
        사용하세요.
      operationId: expansions_signals_search
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              properties:
                domain_search_id_list:
                  type: array
                  description: >-
                    `domain_search_id`로 대상 회사를 한정합니다. **실질적으로 필수**입니다 — 엔드포인트
                    설명을 참조하세요. 특정 회사로 범위를 좁히지 않은 호출은 게이트웨이 타임아웃에서 끊깁니다.
                  items:
                    type: string
                  example:
                    - 550e8400-e29b-41d4-a716-446655440002
                is_active:
                  type: boolean
                  description: 활성 신호만(`true`) 또는 철회된 신호만(`false`) 반환합니다. 생략하면 모두 반환합니다.
                  example: true
                country_code_list:
                  type: array
                  description: ISO 3166-1 alpha-2 코드로 대상 시장을 한정합니다.
                  items:
                    type: string
                  example:
                    - US
                    - GB
                signal_type_slug_list:
                  type: array
                  description: >-
                    신호 유형을 한정합니다. 유효한 슬러그는 [Expansion
                    Reference](/ko/api-reference/endpoint/expansions/types)에서
                    확인하세요.
                  items:
                    type: string
                  example:
                    - HIRE
                    - EXEC
                signal_subtype_slug_list:
                  type: array
                  description: 신호 하위 유형을 한정합니다.
                  items:
                    type: string
                  example:
                    - country_manager
                signal_strength_slug_list:
                  type: array
                  description: 신호 강도를 한정합니다.
                  items:
                    type: string
                  example:
                    - high
                    - very_high
                source_type_list:
                  type: array
                  description: '출처 유형을 한정합니다(예: `linkedin`, `news`, `jobs`).'
                  items:
                    type: string
                  example:
                    - linkedin
                    - news
                polarity:
                  type: string
                  description: >-
                    신호 방향입니다. `expansion`은 진출과 성장을 나타내고, 세 가지 `contraction_*` 값은
                    증거 주기의 각 단계에서의 철수를 나타냅니다(`contraction_leading`이 가장 이른 지표,
                    `contraction_confirming`이 가장 확정적). 단독 `contraction` 값은 존재하지
                    않으며, 전달하면 필터가 조용히 비활성화됩니다.
                  enum:
                    - expansion
                    - contraction_leading
                    - contraction_lagging
                    - contraction_confirming
                event_date_from:
                  type: string
                  format: date
                  description: 포함할 가장 이른 이벤트 날짜(`YYYY-MM-DD`)이며 워크스페이스 시간대로 해석됩니다.
                  example: '2026-06-01'
                event_date_to:
                  type: string
                  format: date
                  description: 포함할 가장 늦은 이벤트 날짜(`YYYY-MM-DD`)이며 해당 일자 전체를 포함합니다.
                  example: '2026-06-30'
                page:
                  type: integer
                  example: 1
                  default: 1
                  description: >-
                    페이지 번호이며 1부터 시작합니다. 상한은 구독의 `max_search_page`(기업 검색은
                    `max_company_search_page`)이며
                    [Profile](/ko/api-reference/endpoint/profile/profile)에서 확인할
                    수 있습니다. 초과하면 **HTTP 416**이 반환됩니다.
                per_page:
                  type: integer
                  description: >-
                    페이지당 레코드 수입니다. 기본값은 25이며 대부분의 플랜에서 상한이기도 합니다. 이 한도는 구독의
                    `max_search_per_page`이며
                    [Profile](/ko/api-reference/endpoint/profile/profile)에서 확인할
                    수 있습니다. 초과하면 결과가 잘리는 것이 아니라 **HTTP 416**과 코드 `41676`(기업·인물
                    검색은 `41613`)이 반환됩니다.
                  default: 25
                  example: 25
      responses:
        '200':
          description: 확장 신호 검색
          content:
            application/json:
              schema:
                type: object
                properties:
                  metadata:
                    type: object
                    description: 이 요청에 적용된 필터의 반향입니다.
                  data:
                    type: object
                    description: 결과 컨테이너입니다.
                    properties:
                      pagination:
                        type: object
                        description: 페이지, 페이지당 수, 총 항목 수, 총 페이지 수입니다.
                      signals:
                        type: array
                        description: 일치하는 신호 행이며 최신순입니다.
                        items:
                          type: object
              example:
                metadata:
                  filters:
                    country_code_list:
                      - US
                    signal_type_slug_list:
                      - HIRE
                data:
                  pagination:
                    page: 1
                    per_page: 25
                    total_entries: 134
                    total_pages: 6
                    total_display_pages: 6
                    is_timeout: false
                  signals:
                    - expansion_signal_id: 90211
                      domain_search_id: 550e8400-e29b-41d4-a716-446655440002
                      country_code: US
                      signal_type_slug: HIRE
                      signal_subtype_slug: country_manager
                      signal_strength_slug: high
                      polarity: expansion
                      event_date: '2026-06-20T14:00:00.000Z'
                      event_date_precision: day
                      source_type: linkedin
                      source_record_id: '4224659596'
                      display_label: Hired Country Manager
                      evidence_url: https://linkedin.com/company/example-corp
                      source_published_at: '2026-06-19T08:00:00.000Z'
                      lead_time_days: 1
                      extraction_confidence: 0.91
                      is_active: true
                      created_at: '2026-06-20T15:02:11.004Z'
                      last_modified: '2026-06-20T15:02:11.004Z'
components:
  securitySchemes:
    pubrio_api_key:
      type: apiKey
      name: pubrio-api-key
      description: >-
        API에서 수행하는 작업 및 해당 권한을 식별하는 고유한 API 토큰입니다. 이 토큰은
        [설정](https://dashboard.pubrio.com/#/settings/) 섹션에서 생성할 수 있습니다.
      in: header

````