> ## 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 /companies/jobs/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: /companies/jobs/search: post: tags: - Search summary: 搜索职位发布 description: 搜索符合指定条件（如地点、职位名称和发布日期）的公司职位发布。 operationId: companies_search_jobs parameters: [] requestBody: required: true content: application/json: schema: type: object properties: locations: $ref: '#/components/schemas/locations' exclude_locations: type: array items: type: string example: - TW description: >- 从职位结果中排除的 ISO 3166-1 alpha-2 (cca2) 地区代码。有效代码请查看过滤器选项卡下的 `location` 端点。 company_locations: $ref: '#/components/schemas/company_locations' companies: $ref: '#/components/schemas/companies' domains: $ref: '#/components/schemas/domains' linkedin_urls: $ref: '#/components/schemas/company_linkedin_urls' search_term: $ref: '#/components/schemas/search_term' search_terms: type: array items: type: string example: - Software Developer description: >- 用于过滤职位发布的关键词字符串数组。每个词与职位内容进行匹配。使用 `search_term` 传入单个字符串，或使用 `search_terms` 传入多个关键词。 titles: $ref: '#/components/schemas/people_titles' posted_dates: $ref: '#/components/schemas/posted_dates' is_realtime_enrichment: $ref: '#/components/schemas/is_realtime_enrichment' per_page: $ref: '#/components/schemas/per_page' page: $ref: '#/components/schemas/page' profile_id: $ref: '#/components/schemas/profile_id' responses: '200': description: 包含相关详细信息的成功响应。 content: application/json: schema: type: object properties: data: $ref: '#/components/schemas/data' example: data: pagination: page: 1 per_page: 25 total_entries: 2228628 total_pages: 89146 is_timeout: false jobs: - job_id: 371d0c44-4c56-4c9c-98e2-ef6dd986b848 job_search_id: 371d0c44-4c56-4c9c-98e2-ef6dd986b848 last_modified: '2025-05-31T20:41:27.894Z' companies: logo_url: >- https://buckets.pubrio.com/company-logo/OTQxMjYxMTFnb29nbGUuY29tLnBrbGlua2VkaW5fcF9sb2dvMTU=.jpg domain_search_id: 539e2c34-de6b-4613-8f5b-e3aa18b4ef47 company_name: Google linkedin_name: google country_code: US domain: google.com location: Seoul, Seoul, South Korea job_url: >- https://kr.linkedin.com/jobs/view/software-engineer-greach-program-for-people-with-disabilities-%EC%9E%A5%EC%95%A0%EC%9D%B8-%EC%B1%84%EC%9A%A9-at-google-4224659596?position=7&pageNum=0&refId=DwDpGXGftUql%2FkETvFCwXw%3D%3D&trackingId=gAvrIP0yUQuf8fjK67HSbQ%3D%3D posting_date: '2025-05-31' country_code: KR location_id: 491 title: >- Software Engineer, gReach Program for People with Disabilities (장애인 채용) country: South Korea - ... '400': $ref: '#/components/responses/general_error' '429': $ref: '#/components/responses/rate_limit_error' '500': $ref: '#/components/responses/server_error' components: schemas: locations: type: array items: type: string example: - US - SG - CN description: ISO 3166-1 alpha-2（cca2）用于筛选地区。更多信息请参见筛选器标签下的 `location` 端点。 company_locations: type: array items: type: string example: - US - SG - CN description: 公司总部所在地。更多信息请参见筛选器标签下的 `location` 端点。 companies: type: array items: type: string format: uuid description: 用于公司和人员检索操作的一组唯一标识符（domain_search_id）列表。 domains: type: array items: type: string example: - pubrio.com description: >- 用于公司和人员检索操作的公司域名列表。如果收到的地址为 `www.pubrio.com` 或 `https://docs.pubrio.com/`，系统会自动转换为 `pubrio.com` 进行处理。 company_linkedin_urls: type: array items: type: string example: - https://www.linkedin.com/company/pubrio description: LinkedIn 公司主页的完整 URL。URL 需以 `http` 开头且包含 `linkedin.com/company/`。 search_term: type: string example: pubrio description: 用于筛选结果的关键词字符串。 people_titles: type: array items: type: string example: - sales manager - marketing manager description: >- 与目标人员相关的职位名称。 结果还将包含包含类似术语的职位，即使不完全匹配。例如，搜索 `software engineer` 也可能返回职位为 `senior software engineer` 的人员。 posted_dates: type: array items: type: string example: - '2025-01-01' - '2025-01-10' description: 发布日期的时间范围。最大值为当天。 is_realtime_enrichment: type: boolean default: false example: true description: >- 为单一公司范围的查询（通过 `domain_search_id`、`domains` 或 `linkedin_urls` 过滤）启用实时数据增强。当初次搜索返回 0 条结果时，系统会抓取来源数据、写入记录后重新执行搜索再返回。受每条路由的超时限制约束。 per_page: type: integer example: 25 description: 每页应返回的搜索结果数量。限制每页结果数量可提升接口性能。 page: type: integer example: 1 description: 要检索的数据页码。 profile_id: type: integer description: >- 可选。发起请求的团队标识符。由于 API 密钥已包含您的工作区信息，此参数不再是必填项。如果提供，该 ID 有助于将查找与特定团队（工作区）关联，实现数据检索和额度追踪。 更多信息请参见团队标签下的 `user details` 端点。 data: type: object nullable: true description: 响应信息取决于具体接口。 responses: general_error: description: 请求错误。请求格式不正确或包含无效参数。请检查错误代码和消息以获取详细信息。 content: application/json: schema: required: - code - message - details type: object properties: code: example: 40001 type: integer message: example: 错误及代码会根据不同场景有所不同，详情请参阅文档。 type: string details: type: object rate_limit_error: description: 超出速率限制。在给定时间段内发送了过多请求。请在速率限制窗口重置后重试。 content: application/json: schema: required: - error type: object properties: error: example: 请求频率超出限制。请稍后再试。 type: string server_error: description: 内部服务器错误。服务器发生意外错误。如果错误持续存在，请联系支持团队。 content: application/json: schema: required: - error type: object properties: error: example: 服务器在处理请求时遇到了未预料的异常。 type: string securitySchemes: pubrio_api_key: type: apiKey name: pubrio-api-key description: >- 一个唯一的 API 令牌，用于标识您通过 API 执行的操作以及相应的权限和操作。您可以在 [设置](https://dashboard.pubrio.com/#/settings/) 部分创建该令牌。 in: header ````