> ## 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/lookup 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/lookup: post: tags: - Expansion summary: 公司扩张详情 description: 单家公司的深度扩张画像——当前阶段、信号、市场存在及阶段转换历史——可针对单一市场，或汇总所有市场。 operationId: expansions_company_lookup requestBody: required: true content: application/json: schema: type: object properties: country_code: $ref: '#/components/schemas/expansion_country_code' is_all_markets: $ref: '#/components/schemas/expansion_is_all_markets' signal_type: type: string enum: - AD - NEWS - INFRA - PARTNER - EXEC - OFFICE - HIRE - SCALE - PRODUCT example: EXEC description: 将返回的信号筛选至单一类型。 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` 时,`summary` 返回针对当前范围(所选市场,或当 `is_all_markets` 为 true 时的所有海外市场)内该公司扩张活动的单条 AI 摘要,依据你的 `query` 解读,并基于公司的真实信号给出 `[n]` 引用。 window_days: type: integer example: 90 default: 90 description: >- 可选。限定 AI `summary` 所依据信号流的滚动时间窗口(天)。当本参数与 `transitioned_dates` 均未提供时默认为 **90**。不影响分页的 `signals` 列表(完整历史)。 transitioned_dates: type: array items: type: string format: date example: - '2026-04-01' - '2026-06-29' description: 信号/转换窗口的 ISO `[from, to]` 日期范围。如果同时提供了 `window_days`,则此参数优先。 domain: $ref: '#/components/schemas/domain' linkedin_url: $ref: '#/components/schemas/company_linkedin_url' domain_search_id: $ref: '#/components/schemas/domain_search_id' is_include_established: $ref: '#/components/schemas/expansion_is_include_established' 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: 公司在某市场的详情。 content: application/json: schema: type: object properties: metadata: type: object data: {} example: metadata: filters: domain_search_id: 550e8400-e29b-41d4-a716-446655440002 country_code: US country_code_auto_picked: false pagination: page: 1 per_page: 25 total_entries: 12 total_pages: 1 total_display_pages: 1 is_timeout: false data: domain_search_id: 550e8400-e29b-41d4-a716-446655440002 country_code: US country_name: United States stage_rank: 3 stage_name: Expanding stage: slug: expanding expansion_score: 0.721 scope: entering_new_market direction: advancing freshness: fresh signal_count: 5 first_signal_at: '2026-05-30T09:00:00.000Z' latest_signal_at: '2026-06-20T14:00:00.000Z' last_transition_at: '2026-06-15T09:30:00.000Z' signals: - signal_type_slug: EXEC signal_subtype_slug: country_manager signal_strength_slug: high polarity: expansion event_date: '2026-06-20T14:00:00.000Z' source_type: linkedin display_label: Hired Regional VP for North America evidence_url: https://linkedin.com/company/example-corp source_published_at: '2026-06-20T14:00:00.000Z' lead_time_days: 0 presence: - presence_type: office presence_strength: high address: 123 Market St, San Francisco, CA known_since: '2026-03-15T00:00:00.000Z' timeline: - stage_slug: expanding transitioned_at: '2026-06-15T09:30:00.000Z' transition_kind: advance other_markets: - country_code: CA stage_slug: committing signal_count: 8 first_signal_at: '2026-04-10T00:00:00.000Z' latest_signal_at: '2026-06-22T16:45:00.000Z' last_transition_at: '2026-06-18T00:00:00.000Z' components: schemas: expansion_country_code: type: string example: US description: >- 目标市场，采用 ISO 3166-1 alpha-2（cca2）国家代码。省略时将自动选择该公司最活跃的单个市场；如需所有市场的跨市场视图，请设置 `is_all_markets`。 expansion_is_all_markets: type: boolean example: false description: >- 在一次调用中返回公司在所有市场的整体扩张情况，而非单一市场。设为 `true` 时，将忽略 `country_code`，在能够识别本土市场时将其从信号汇总中排除，`data` 变为公司级别的汇总（主导阶段、信号总数、时间跨度、最高扩张分数），并且 `markets_summary` 列出每个市场。默认为 false。 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: 用于公司检索操作的唯一标识符。 expansion_is_include_established: type: boolean example: false description: 包含 `established` 阶段（无活跃扩张信号的长期运营者）。默认为 false。 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 ````