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

# 扩张信号搜索

> 直接搜索原始的扩张信号行，而非其汇总而成的公司记录。每条信号都包含类型、子类型、强度、极性、带日期的事件、来源及证据链接，因此你可以准确审计是什么推动了某家公司的阶段变化，或在其之上构建自己的评分体系。

**请将本次调用限定到具体公司。** 传入 `domain_search_id_list`。信号表非常庞大，仅按市场或日期范围筛选的请求无法在网关超时前完成 —— 连接会在约 60 秒后被断开。限定公司范围的调用通常在一秒内返回。

若需公司级结果，请使用 [Expansion Search](/cn/api-reference/endpoint/expansions/market_lookup)；若需单个公司的信号流，请使用 [Company Signal Events](/cn/api-reference/endpoint/expansions/company_pulse_events)。



## OpenAPI

````yaml cn-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/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/signals/search:
    post:
      tags:
        - Expansion
      summary: 扩张信号搜索
      description: >-
        直接搜索原始的扩张信号行，而非其汇总而成的公司记录。每条信号都包含类型、子类型、强度、极性、带日期的事件、来源及证据链接，因此你可以准确审计是什么推动了某家公司的阶段变化，或在其之上构建自己的评分体系。


        **请将本次调用限定到具体公司。** 传入
        `domain_search_id_list`。信号表非常庞大，仅按市场或日期范围筛选的请求无法在网关超时前完成 —— 连接会在约 60
        秒后被断开。限定公司范围的调用通常在一秒内返回。


        若需公司级结果，请使用 [Expansion
        Search](/cn/api-reference/endpoint/expansions/market_lookup)；若需单个公司的信号流，请使用
        [Company Signal
        Events](/cn/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](/cn/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](/cn/api-reference/endpoint/profile/profile)
                    获取。超出会返回 **HTTP 416**。
                per_page:
                  type: integer
                  description: >-
                    每页记录数。默认 25，在大多数套餐下这也是上限 —— 该限制即订阅中的
                    `max_search_per_page`，可通过
                    [Profile](/cn/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

````