> ## 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. # 扩张搜索 > 查找正在向一个或多个市场扩张的公司，可使用企业和信号筛选条件或自然语言查询，并可选择生成基于该公司真实信号的 AI 匹配说明。 ## OpenAPI ````yaml cn-openapi POST /expansions/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/search: post: tags: - Expansion summary: 扩张搜索 description: 查找正在向一个或多个市场扩张的公司，可使用企业和信号筛选条件或自然语言查询，并可选择生成基于该公司真实信号的 AI 匹配说明。 operationId: expansions_search 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' min_markets: type: integer example: 3 description: 公司在该时间窗口内必须进入的新市场最少数量。 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-04-01' - '2026-06-29' description: >- 时间线窗口的 ISO 日期范围。默认为最近 90 天。. A natural-language `query` may also set this from calendar phrases ("this year", "last year", "Q2 2026"). window_days: $ref: '#/components/schemas/window_days' query: type: string example: fintech companies expanding into the UK description: Pubrio 将其解析为扩张与公司筛选条件的自然语言查询。 is_explain_match: type: boolean example: true description: >- 为每家公司附上其匹配搜索条件原因的 AI 生成说明（基于公司的真实信号）。建议配合自然语言查询使用。 引用的信号数量及批处理规模均随 `per_page` 变化；高频来源（招聘信息、广告投放）会以窗口期内的数量形式汇总（例如"12 个职位发布"），而非逐条列出。 sort_by: $ref: '#/components/schemas/expansion_sort_by' page: $ref: '#/components/schemas/page' per_page: $ref: '#/components/schemas/per_page' profile_id: $ref: '#/components/schemas/profile_id' responses: '200': description: >- 在目标市场扩张的公司分页列表。`filters` 会回显已应用（或自然语言解析）的条件；当 `is_explain_match` 为 true 时，每家公司都会包含 `match_summary`。 content: application/json: schema: type: object properties: metadata: type: object description: >- 搜索元数据：实际应用的筛选器，以及在请求元数据时的市场汇总（aggregate、地理范围、top origins/destinations/industries、timeline）。 properties: filters: type: object description: 实际应用的筛选器（当使用 `query` 时，回显解释后的自然语言查询）。 relaxed_filters: type: array description: 当自然语言查询无匹配时被自动放宽的软筛选器；否则为 null。 items: type: string aggregate: type: object description: 市场级汇总。请求元数据时提供。 country_code: type: string country_codes: type: array items: type: string direction: type: string is_global: type: boolean is_multi: type: boolean transitioned_dates: type: array items: type: string top_origins: type: array items: type: object top_destinations: type: array items: type: object top_industries: type: array items: type: object timeline: type: array items: type: object data: type: object description: 结果容器（标准搜索信封）：公司列表加分页。 properties: pagination: type: object companies: type: array description: >- 公司列表。每一项都带有嵌套的 `stage`；当 `is_explain_match` 为 true 时包含 `match_summary`。 items: type: object example: metadata: filters: tos: - GB verticals: - Financial Services data: pagination: page: 1 per_page: 25 total_entries: 87 total_pages: 4 total_display_pages: 4 is_timeout: false companies: - expansion_id: '6845525' domain_search_id: 550e8400-e29b-41d4-a716-446655440002 country_code: GB target_country_code: GB domain: example.com company_name: Example Corp home_country_code: CN industry: Consumer Electronics founded_year: 2015 employees_count: 320 stage: slug: expanding expansion_score: 0.72 scope: entering_new_market direction: advancing freshness: fresh signal_count: 27 presence: level: detected local_people_count: 12 has_known_office: true matched_rule: people read: code: ok 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`、公司域名或公司社交媒体主页链接的任意组合来指定公司。域名和链接会解析为排名最高的公司。 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` 范围时使用;若两者均未提供,则使用默认时间窗口。 expansion_sort_by: type: string enum: - expansion_score - signal_count - company_ranking example: expansion_score description: >- 结果排序方式。留空则使用默认排序（按最近变更时间排序）。`expansion_score` —— 按扩张分数从高到低排序。`signal_count` —— 按该组合的信号数量从多到少排序。`company_ranking` —— 按 Pubrio 的整体公司排名排序（数值越小代表越知名），从小到大排列。 page: type: integer example: 1 description: 要检索的数据页码。 per_page: type: integer example: 25 description: 每页应返回的搜索结果数量。限制每页结果数量可提升接口性能。 profile_id: type: integer description: >- 可选。发起请求的团队标识符。由于 API 密钥已包含您的工作区信息，此参数不再是必填项。如果提供，该 ID 有助于将查找与特定团队（工作区）关联，实现数据检索和额度追踪。 更多信息请参见团队标签下的 `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 ````