> ## 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/pulse_events 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/pulse_events: post: tags: - Expansion summary: 公司信号事件 description: 针对单家公司，深入钻取驱动其扩张的信号事件，结果经过丰富并分页。 operationId: expansions_company_pulse_events requestBody: required: true content: application/json: schema: type: object properties: signal_types: $ref: '#/components/schemas/expansion_signal_type_slugs' country_codes: type: array items: type: string example: - JP - SG description: >- 可选。将信号流限定到一个或多个海外市场(ISO 3166-1 alpha-2,例如 `["JP","SG"]`)。未提供时返回所有海外市场(始终排除本土市场)。 transitioned_dates: type: array items: type: string format: date example: - '2026-04-01' - '2026-06-29' description: 信号/转换窗口的 ISO `[from, to]` 日期范围。如果同时提供了 `window_days`,则此参数优先。 window_days: type: integer example: 90 default: 90 description: >- 可选。事件滚动时间窗口的天数。当本参数与 `transitioned_dates` 均未提供时,默认使用 **90** 天(标准展示窗口)。两者同时提供时以 `transitioned_dates` 为准。 query: type: string example: >- We sell Employer-of-Record and local payroll; best-fit buyers hire in a new market before setting up a legal entity. description: >- 用纯文本描述你所销售的产品，或你正在评估这家公司是否契合的目标买家画像。仅用于为 AI `summary` 提供依据（见 `is_explain_match`）；与公司搜索不同，此处不会将其解析为筛选条件。 is_explain_match: type: boolean example: true description: >- 当为 true 且提供了 `query` 时，`data.summary` 会返回一段针对该公司扩张活动、结合你的 `query` 生成的 AI 摘要，基于公司的真实信号并带有 `[n]` 引用标注。与公司搜索中逐公司的 `match_summary` 不同，此摘要基于该公司在时间窗口内的完整信号集（所有市场、全部信号）生成，因此不受 `page` / `per_page` 影响，结果保持稳定。 domain: $ref: '#/components/schemas/domain' linkedin_url: $ref: '#/components/schemas/company_linkedin_url' domain_search_id: $ref: '#/components/schemas/domain_search_id' page: $ref: '#/components/schemas/page' per_page: $ref: '#/components/schemas/per_page' profile_id: $ref: '#/components/schemas/profile_id' anyOf: - title: Domain Search ID required: - domain_search_id - title: 域名 required: - domain - title: LinkedIn URL required: - linkedin_url responses: '200': description: >- 分页的信号事件。 当 `is_explain_match` 为 true 且提供了 `query` 时，`data.summary` 包含一段针对公司完整信号集、结合查询生成的 AI 摘要（`{ text, citations }`）；否则为 `null`。 content: application/json: schema: type: object properties: metadata: type: object data: {} example: metadata: filters: domain_search_id: 550e8400-e29b-41d4-a716-446655440002 data: pagination: page: 1 per_page: 25 total_entries: 42 total_pages: 2 total_display_pages: 2 is_timeout: false events: - signal_type_slug: EXEC stage_slug: expanding country_code: US signal_subtype_slug: country_manager source_type: linkedin polarity: expansion display_label: Hired Country Manager evidence_url: https://linkedin.com/company/example-corp event_date: '2026-06-20T14:00:00.000Z' summary: text: >- Example Corp is hiring across Tokyo[1] and just added a Japan Country Manager[2], yet has no legal entity on file — it is staffing the market before incorporating, which is exactly your window. citations: - 'n': 1 type: HIRE label: Tokyo software & field-ops roles country: JP date: 2026-06 url: null - 'n': 2 type: EXEC label: Country Manager, Japan country: JP date: 2026-06 url: https://linkedin.com/in/example components: schemas: 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: 筛选到特定的信号类型。 domain: type: string example: pubrio.com description: >- 用于公司检索操作的公司域名。如果收到的地址为 `www.pubrio.com` 或 `https://docs.pubrio.com/`，系统会自动转换为 `pubrio.com` 进行处理。 company_linkedin_url: type: string example: https://www.linkedin.com/company/pubrio description: LinkedIn 公司主页的完整 URL。URL 需以 `http` 开头且包含 `linkedin.com/company/`。 domain_search_id: type: string format: uuid description: 用于公司检索操作的唯一标识符。 page: type: integer example: 1 description: 要检索的数据页码。 per_page: type: integer example: 25 description: 每页应返回的搜索结果数量。限制每页结果数量可提升接口性能。 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 ````