> ## Documentation Index > Fetch the complete documentation index at: https://glasser.ai/docs/llms.txt > Use this file to discover all available pages before exploring further. # 公司信息 > 按域名研究公司资料、技术栈、流量、竞争对手、融资、新闻、职位和广告，或搜索目标公司。 按行业、员工规模、总部或类型搜索目标公司，按名称查找候选公司，或通过域名研究公司资料、技术栈、流量、相似企业、融资、新闻、在招职位和 Google 广告。search 需要提示词或结构化筛选，lookup 需要公司名称 query，其他操作需要 domain。 所有操作返回规范化 output，以及最后一个 Run 的 id、provider 和生命周期 status。search 和 lookup 返回 total\_matches 及公司列表 output.items\[]；匹配总数不可用时为 null，不使用当前页长度替代。enrich 和 traffic 提供固定顶层字段；tech\_stack、competitors、news、jobs 提供每行字段固定的 output.items\[]；funding 提供 total\_funding\_usd 和 items\[]；ads 提供 total\_ads 和 items\[]。原生输出不在 output 中重复，保留在 Run 中，可通过 GET /v1/runs/:id 读取。所选数据提供商未报告的值为 null；金额统一为美元。 分别检查 result\_status 和 status：前者为 success、no\_result、error 或 pending。charge\_usd 为本响应 runs 的总费用，所有 Run 结算前为 null；runs\[] 包含各自费用。provider=auto 选择第一家符合条件的数据提供商，仅在 PROVIDER\_ERROR、TIMED\_OUT 或受理时 503 后尝试下一家；指定数据提供商时不切换。对于 QUEUED/RUNNING，即 HTTP 202，目前仅 Apify traffic 路径，在 API 服务地址上使用认证轮询 result\_url。有意重试时复用相同 Idempotency-Key 和执行参数。 ## 各操作输出 各操作的规范化字段。原生输出保留在 Run 中，可通过 GET /v1/runs/:id 读取。未报告的值为 null；有效空结果保留操作结构，各字段为 null 或 items 为 \[]，result\_status 为 no\_result。金额为美元。员工数和营收为响应方自身估算，\*\_range\_min / \*\_range\_max 为其区间边界。自有模型分数带数据提供商名称，如 exa\_similarity\_score，其他家为 null。industry、categories、round、category 保留响应方词汇。 * search: total\_matches, items\[]: domain 及公司资料字段；未报告的字段为 null * lookup: total\_matches, items\[]: domain 及公司资料字段；名称有歧义时返回候选 * enrich: name, website, description, industry, employees, employee\_range\_min, employee\_range\_max, founded\_year, city, region, country, country\_code, linkedin\_url, phone, total\_funding\_usd, revenue\_usd, revenue\_range\_min\_usd, revenue\_range\_max\_usd, ownership, ticker, latest\_funding\_date * tech\_stack: items\[]: name, categories\[], detection\_source, predictleads\_confidence, first\_detected\_date, last\_detected\_date * traffic: monthly\_visits, organic\_traffic, paid\_traffic, organic\_keywords, paid\_keywords, organic\_traffic\_value\_usd, similarweb\_global\_rank, bounce\_rate, pages\_per\_visit, avg\_visit\_duration\_seconds * competitors: items\[]: domain, name, page\_title, position, predictleads\_similarity\_score, exa\_similarity\_score, reason * funding: total\_funding\_usd, items\[]: round\_date, round, amount\_usd, investors\[], source\_url * news: items\[]: title, url, source, published\_at, event\_date, date\_text, category, snippet * jobs: items\[]: title, url, location, seniority, categories\[], contract\_types\[], salary\_min\_usd, salary\_max\_usd, salary\_period, posted\_at, first\_seen\_at, last\_seen\_at * ads: total\_ads, items\[]: creative\_id, advertiser\_id, advertiser\_name, format, ad\_url, image\_url, first\_shown\_at, last\_shown\_at ```json { "action": "enrich", "provider": "apollo", "status": "COMPLETED", "result_status": "success", "output": { "name": "Stripe", "website": "http://www.stripe.com", "industry": "information technology & services", "employees": 9400, "employee_range_min": null, "employee_range_max": null, "founded_year": 2010, "city": "South San Francisco", "region": "California", "country": "United States", "country_code": "US", "linkedin_url": "http://www.linkedin.com/company/stripe", "phone": "+1 415-298-5539", "total_funding_usd": 9443867423, "revenue_usd": 6935000000, "revenue_range_min_usd": null, "revenue_range_max_usd": null, "ownership": null, "ticker": null, "latest_funding_date": "2026-03-01", "description": "Stripe, Inc. is a global financial technology company…" }, "charge_usd": "0.026", "runs": [{ "provider": "apollo", "status": "COMPLETED", "charge_usd": "0.026" }], "result_url": "/v1/solutions/gtm/company_intelligence/result?token=…" } ``` ## OpenAPI ````yaml /openapi.zh.json post /v1/solutions/gtm/company_intelligence openapi: 3.1.0 info: title: Glasser version: 0.0.1 description: 一个 API Key，无需合同，按次付费，即可调用批量采购的付费 API。每个响应包含 x-request-id；所有错误正文采用统一结构。 servers: - url: https://api.glasser.ai security: [] tags: - name: Solutions - name: Endpoints - name: Runs - name: Balance paths: /v1/solutions/gtm/company_intelligence: post: tags: - Solutions summary: 公司信息 description: >- 按行业、员工规模、总部或类型搜索目标公司，按名称查找候选公司，或通过域名研究公司资料、技术栈、流量、相似企业、融资、新闻、在招职位和 Google 广告。search 需要提示词或结构化筛选，lookup 需要公司名称 query，其他操作需要 domain。 所有操作返回规范化 output，以及最后一个 Run 的 id、provider 和生命周期 status。search 和 lookup 返回 total_matches 及公司列表 output.items[]；匹配总数不可用时为 null，不使用当前页长度替代。enrich 和 traffic 提供固定顶层字段；tech_stack、competitors、news、jobs 提供每行字段固定的 output.items[]；funding 提供 total_funding_usd 和 items[]；ads 提供 total_ads 和 items[]。原生输出不在 output 中重复，保留在 Run 中，可通过 GET /v1/runs/:id 读取。所选数据提供商未报告的值为 null；金额统一为美元。 分别检查 result_status 和 status：前者为 success、no_result、error 或 pending。charge_usd 为本响应 runs 的总费用，所有 Run 结算前为 null；runs[] 包含各自费用。provider=auto 选择第一家符合条件的数据提供商，仅在 PROVIDER_ERROR、TIMED_OUT 或受理时 503 后尝试下一家；指定数据提供商时不切换。对于 QUEUED/RUNNING，即 HTTP 202，目前仅 Apify traffic 路径，在 API 服务地址上使用认证轮询 result_url。有意重试时复用相同 Idempotency-Key 和执行参数。 operationId: gtm-company-intelligence parameters: - name: idempotency-key in: header schema: type: string minLength: 1 description: >- 为每次预期执行生成唯一值，推荐使用 UUID。使用同一个键和执行参数重试，可读取原 Run，避免再次扣费。使用同一个键但修改执行参数会返回 409；修改 task_id 或 metadata 不会更新原 Run。 required: true requestBody: content: application/json: schema: type: object properties: action: anyOf: - type: string enum: - search - lookup - enrich - tech_stack - traffic - competitors - funding - news - jobs - ads description: >- 默认为 enrich。search 需要 query 或结构化筛选；lookup 需要 query，即公司名称；其他操作均需要 domain。 - search：按行业、员工区间、国家或公司类型发现公司，使用 offset 分页。结构化筛选使用 Hunter 词汇；query 只表达这些筛选能表示的条件。其他 ICP 条件需另行检查。 - lookup：按名称查找候选公司，使用 page 分页；名称有歧义时不要猜测。 - enrich：公司资料和企业属性。 - tech_stack、traffic、funding、news：对应公司数据。 - jobs：公司自有招聘页面上的在招职位；limit 限制行数，默认及最大均为 25，因此返回行数不是公司职位总数。 - ads：域名背后广告主在 Google Ads Transparency Center 中的广告素材；country 限定地区，省略则包含所有地区。 - competitors：相似企业。查询 Google 结果中的竞争域名时，使用 SEO 研究的 organic_competitors。 - type: 'null' provider: anyOf: - type: string enum: - auto - apollo - pdl - hunter - prospeo - predictleads - leadmagic - builtwith - dataforseo - ahrefs - apify - exa - serper - scrapecreators description: >- 默认为 auto，按 Glasser 偏好顺序选择第一家符合条件的数据提供商。指定的数据提供商必须支持请求且获得当前 API Key 的允许，不会切换到其他家。可用值见下方。 - type: 'null' domain: anyOf: - type: string minLength: 3 maxLength: 253 description: 网站域名，例如 stripe.com。也接受完整 URL，并提取主机名。 - type: 'null' industries: anyOf: - type: array items: type: string minLength: 1 minItems: 1 maxItems: 20 - type: 'null' headcounts: anyOf: - type: array items: type: string enum: - 1-10 - 11-50 - 51-200 - 201-500 - 501-1000 - 1001-5000 - 5001-10000 - 10001+ minItems: 1 maxItems: 8 - type: 'null' company_types: anyOf: - type: array items: type: string enum: - educational - educational institution - government agency - non profit - partnership - privately held - public company - self employed - self owned - sole proprietorship minItems: 1 maxItems: 10 - type: 'null' offset: anyOf: - type: integer minimum: 0 maximum: 10000 - type: 'null' page: anyOf: - type: integer minimum: 1 maximum: 500 - type: 'null' country: anyOf: - type: string minLength: 2 maxLength: 60 description: >- 国家，使用两位 ISO 代码或名称，例如 us、gb、de、Germany。默认为 us。支持代码：us、gb、ca、au、nz、ie、in、sg、de、at、ch、fr、be、es、mx、ar、it、nl、pt、br、jp、kr、cn、hk、tw、ru、pl、se、no、dk、fi、tr、id、th、vn、ph、my、za、ae、il、sa、eg、ng、ua、cz、gr、hu、ro、co、cl、pe、lu。可用范围还取决于操作和数据提供商。不支持的国家会在创建 Run 前被拒绝。不要为了绕过错误而更换国家，这会改变请求的数据。 - type: 'null' query: anyOf: - type: string minLength: 1 maxLength: 200 description: >- search：发现公司的提示词。lookup：公司名称。通过 Serper 查询 news 时：使用公司名称，不使用域名。 - type: 'null' limit: anyOf: - type: integer minimum: 1 maximum: 100 description: 返回条数。请从较少条数开始：路由到的接口可能据此计费。各能力还会进一步限制上限。 - type: 'null' task_id: anyOf: - type: string description: >- 将相关 Run，包括自动切换产生的 Run，归入同一个 Task。复用稳定字符串，并通过 Task 筛选 Run 列表。 - type: 'null' metadata: anyOf: - anyOf: - type: object additionalProperties: type: string minLength: 1 maxLength: 500 maxProperties: 20 propertyNames: type: string pattern: ^[a-z][a-z0-9_]{0,39}$ - {} description: |- 可选追踪字段，随 Run 返回，也可用于筛选。不会发送给数据提供商，也不影响路由、价格或幂等。 - 最多 20 个键：小写字母、数字和下划线，以字母开头，最长 40 个字符。 - 值：长度为 1–500 的字符串。 - user_id：终端用户的不透明 ID，不得使用邮箱或姓名。 无效条目整体丢弃，不截断。请求继续执行，Run 返回实际保存的字段。 - type: 'null' additionalProperties: false required: true responses: '200': description: 成功 content: application/json: schema: anyOf: - $ref: '#/components/schemas/CompanyIntelligenceResult' '202': description: 成功 content: application/json: schema: anyOf: - $ref: '#/components/schemas/CompanyIntelligenceResult' '400': description: ValidationFailed | IdempotencyKeyRequired content: application/json: schema: anyOf: - $ref: '#/components/schemas/ValidationFailedEncoded' - $ref: '#/components/schemas/IdempotencyKeyRequiredEncoded' - $ref: '#/components/schemas/ValidationFailedEncoded' '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/UnauthorizedEncoded' '402': description: InsufficientBalance content: application/json: schema: $ref: '#/components/schemas/InsufficientBalanceEncoded' '403': description: EndpointNotPermitted | Forbidden content: application/json: schema: anyOf: - $ref: '#/components/schemas/EndpointNotPermittedEncoded' - $ref: '#/components/schemas/ForbiddenEncoded' '409': description: IdempotencyConflict content: application/json: schema: $ref: '#/components/schemas/IdempotencyConflictEncoded' '429': description: RateLimited content: application/json: schema: $ref: '#/components/schemas/RateLimitedEncoded' '503': description: ServiceUnavailable content: application/json: schema: $ref: '#/components/schemas/ServiceUnavailableEncoded' security: - bearer: [] components: schemas: CompanyIntelligenceResult: type: object properties: id: type: string run_url: type: string description: 在控制台打开 Run，需要工作空间成员权限。 provider: type: string pattern: ^[a-z0-9][a-z0-9-]*$ endpoint: type: string pattern: ^\/.+$ endpoint_version: type: integer exclusiveMinimum: 0 status: type: string enum: - QUEUED - RUNNING - COMPLETED - FAILED - STOPPED description: >- QUEUED 或 RUNNING 表示仍在执行。COMPLETED 表示已有数据提供商响应，包括非 2xx 响应。FAILED 请读取 failure。STOPPED 表示分派前停止。charge_usd 与状态分别检查。 failure: anyOf: - type: object properties: kind: type: string enum: - TIMED_OUT - INTERNAL message: type: string required: - kind - message additionalProperties: false - type: 'null' description: Run 失败原因，仅在 status 为 FAILED 时非 null。 input: type: object output: anyOf: - anyOf: - type: object properties: total_matches: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' description: 数据提供商报告的整个数据集匹配数，不使用当前页长度替代。 items: type: array items: type: object properties: name: anyOf: - type: string - type: 'null' description: 数据提供商报告的公司名称。 website: anyOf: - type: string - type: 'null' description: 公司网站，http(s) URL。 description: anyOf: - type: string - type: 'null' description: 数据提供商提供的公司简介。 industry: anyOf: - type: string - type: 'null' description: >- 响应方自身词汇中的行业标签，例如 LinkedIn 或 GICS 风格。不可跨数据提供商直接比较，请检查 provider。 employees: anyOf: - type: integer - type: 'null' description: 员工数，为数据提供商自身估算，不是经审计的人数。 employee_range_min: anyOf: - type: integer - type: 'null' description: 数据提供商员工规模区间的下限，例如 10K–50K 对应 10000。 employee_range_max: anyOf: - type: integer - type: 'null' description: 数据提供商员工规模区间的上限；10000+ 等开放区间为 null。 founded_year: anyOf: - type: integer - type: 'null' description: 公司成立年份。 city: anyOf: - type: string - type: 'null' description: 总部所在城市。 region: anyOf: - type: string - type: 'null' description: 总部所在州或地区。 country: anyOf: - type: string - type: 'null' description: 总部所在国家的英文展示名称，不是代码。 country_code: anyOf: - type: string - type: 'null' description: 总部所在国家的 ISO 3166-1 alpha-2 代码。 linkedin_url: anyOf: - type: string - type: 'null' description: LinkedIn 公司页面 URL。 phone: anyOf: - type: string - type: 'null' description: 数据提供商报告的总部电话号码。 total_funding_usd: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' description: 数据提供商报告的累计融资额，美元。 revenue_usd: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' description: >- 年度营收单值，美元，为数据提供商估算或报告值。仅提供区间时为 null，见 revenue_range_min_usd / revenue_range_max_usd。 revenue_range_min_usd: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' description: 数据提供商年度营收区间的下限，美元。 revenue_range_max_usd: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' description: 数据提供商年度营收区间的上限，美元；$10B+ 等开放区间为 null。 ownership: anyOf: - type: string enum: - public - private - nonprofit - government - education - other - type: 'null' description: 由数据提供商标签映射的所有制类型。未说明时为 null，不推断为 private。 ticker: anyOf: - type: string - type: 'null' description: 上市公司的股票代码或公开交易标识。 latest_funding_date: anyOf: - type: string - type: 'null' description: 最近一轮融资日期，YYYY-MM-DD。 domain: anyOf: - type: string - type: 'null' required: - name - website - description - industry - employees - employee_range_min - employee_range_max - founded_year - city - region - country - country_code - linkedin_url - phone - total_funding_usd - revenue_usd - revenue_range_min_usd - revenue_range_max_usd - ownership - ticker - latest_funding_date - domain additionalProperties: false required: - total_matches - items additionalProperties: false - type: object properties: name: anyOf: - type: string - type: 'null' description: 数据提供商报告的公司名称。 website: anyOf: - type: string - type: 'null' description: 公司网站，http(s) URL。 description: anyOf: - type: string - type: 'null' description: 数据提供商提供的公司简介。 industry: anyOf: - type: string - type: 'null' description: >- 响应方自身词汇中的行业标签，例如 LinkedIn 或 GICS 风格。不可跨数据提供商直接比较，请检查 provider。 employees: anyOf: - type: integer - type: 'null' description: 员工数，为数据提供商自身估算，不是经审计的人数。 employee_range_min: anyOf: - type: integer - type: 'null' description: 数据提供商员工规模区间的下限，例如 10K–50K 对应 10000。 employee_range_max: anyOf: - type: integer - type: 'null' description: 数据提供商员工规模区间的上限；10000+ 等开放区间为 null。 founded_year: anyOf: - type: integer - type: 'null' description: 公司成立年份。 city: anyOf: - type: string - type: 'null' description: 总部所在城市。 region: anyOf: - type: string - type: 'null' description: 总部所在州或地区。 country: anyOf: - type: string - type: 'null' description: 总部所在国家的英文展示名称，不是代码。 country_code: anyOf: - type: string - type: 'null' description: 总部所在国家的 ISO 3166-1 alpha-2 代码。 linkedin_url: anyOf: - type: string - type: 'null' description: LinkedIn 公司页面 URL。 phone: anyOf: - type: string - type: 'null' description: 数据提供商报告的总部电话号码。 total_funding_usd: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' description: 数据提供商报告的累计融资额，美元。 revenue_usd: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' description: >- 年度营收单值，美元，为数据提供商估算或报告值。仅提供区间时为 null，见 revenue_range_min_usd / revenue_range_max_usd。 revenue_range_min_usd: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' description: 数据提供商年度营收区间的下限，美元。 revenue_range_max_usd: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' description: 数据提供商年度营收区间的上限，美元；$10B+ 等开放区间为 null。 ownership: anyOf: - type: string enum: - public - private - nonprofit - government - education - other - type: 'null' description: 由数据提供商标签映射的所有制类型。未说明时为 null，不推断为 private。 ticker: anyOf: - type: string - type: 'null' description: 上市公司的股票代码或公开交易标识。 latest_funding_date: anyOf: - type: string - type: 'null' description: 最近一轮融资日期，YYYY-MM-DD。 required: - name - website - description - industry - employees - employee_range_min - employee_range_max - founded_year - city - region - country - country_code - linkedin_url - phone - total_funding_usd - revenue_usd - revenue_range_min_usd - revenue_range_max_usd - ownership - ticker - latest_funding_date additionalProperties: false - type: object properties: monthly_visits: anyOf: - type: integer - type: 'null' description: 全球各渠道月访问量，Similarweb 面板估算，不按 country 限定。 organic_traffic: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' description: 请求国家中的估算月自然搜索访问量，默认为 us，基于搜索模型估算。 paid_traffic: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' description: 请求国家中的估算月付费搜索访问量，默认为 us。 organic_keywords: anyOf: - type: integer - type: 'null' description: 域名在请求国家中有自然排名的关键词数。 paid_keywords: anyOf: - type: integer - type: 'null' description: 域名在请求国家中竞价的关键词数。 organic_traffic_value_usd: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' description: 估算月自然流量价值，美元，来自 Ahrefs；其他数据提供商为 null。 similarweb_global_rank: anyOf: - type: integer - type: 'null' description: Similarweb 全球排名，1 表示访问量最高；其他数据提供商为 null。 bounce_rate: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' description: 跳出率，以 0–1 比例表示，来自 Similarweb。 pages_per_visit: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' description: 每次访问页数，来自 Similarweb。 avg_visit_duration_seconds: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' description: 平均访问时长，秒，来自 Similarweb。 required: - monthly_visits - organic_traffic - paid_traffic - organic_keywords - paid_keywords - organic_traffic_value_usd - similarweb_global_rank - bounce_rate - pages_per_visit - avg_visit_duration_seconds additionalProperties: false - type: object properties: total_funding_usd: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' description: 数据提供商报告的累计融资额，美元。 items: type: array items: type: object properties: round_date: anyOf: - type: string - type: 'null' description: 融资日期，YYYY-MM-DD。LeadMagic 精确到月，日期为 01。 round: anyOf: - type: string - type: 'null' description: 响应方词汇中的融资轮次标签，例如 seed、Series I。 amount_usd: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' description: 该轮融资金额，美元；其他币种为 null。 investors: type: array items: type: string description: 投资者名称。 source_url: anyOf: - type: string - type: 'null' description: 融资消息来源文章，来自 PredictLeads。 required: - round_date - round - amount_usd - investors - source_url additionalProperties: false required: - total_funding_usd - items additionalProperties: false - type: object properties: total_ads: anyOf: - type: integer - type: 'null' description: Google Ads Transparency Center 估算的广告主广告总数，不是本次返回条数。 items: type: array items: type: object properties: creative_id: anyOf: - type: string - type: 'null' description: Google Ads Transparency 广告素材 ID。 advertiser_id: anyOf: - type: string - type: 'null' description: Google Ads Transparency 广告主 ID。 advertiser_name: anyOf: - type: string - type: 'null' description: 已验证广告主的法定名称。 format: anyOf: - type: string - type: 'null' description: Google 词汇中的广告格式：text、image 或 video。 ad_url: anyOf: - type: string - type: 'null' description: Ads Transparency Center 中的素材页面。 image_url: anyOf: - type: string - type: 'null' description: 广告素材渲染后的预览图片。 first_shown_at: anyOf: - type: string - type: 'null' description: 广告首次展示时间，ISO 8601 UTC。 last_shown_at: anyOf: - type: string - type: 'null' description: 广告最近展示时间，ISO 8601 UTC。 required: - creative_id - advertiser_id - advertiser_name - format - ad_url - image_url - first_shown_at - last_shown_at additionalProperties: false required: - total_ads - items additionalProperties: false - type: object properties: items: type: array items: type: object properties: name: type: string description: 技术名称。 categories: type: array items: type: string description: >- 响应方词汇中的分类标签，例如 BuiltWith tag、DataForSEO group/category。未提供时为空。 detection_source: anyOf: - type: string enum: - website - job_postings - type: 'null' description: >- 技术发现方式：抓取公开网站，或通过招聘信息推断，例如 PredictLeads 对防火墙内技术的检测。 predictleads_confidence: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' description: PredictLeads 检测置信度，0–1，其他数据提供商为 null。 first_detected_date: anyOf: - type: string - type: 'null' description: 首次检测日期，YYYY-MM-DD。 last_detected_date: anyOf: - type: string - type: 'null' description: 最近检测日期，YYYY-MM-DD。 required: - name - categories - detection_source - predictleads_confidence - first_detected_date - last_detected_date additionalProperties: false required: - items additionalProperties: false - type: object properties: items: type: array items: type: object properties: domain: anyOf: - type: string - type: 'null' description: 相似公司的域名，不含 www. 和端口。 name: anyOf: - type: string - type: 'null' description: 相似公司的名称；数据提供商返回网页时为 null，例如 Exa。 page_title: anyOf: - type: string - type: 'null' description: 匹配网页标题，仅 Exa；不是公司名称。 position: anyOf: - type: integer - type: 'null' description: 数据提供商响应中从 1 开始的排名。 predictleads_similarity_score: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' description: PredictLeads 公司相似度分数，0–1；其他数据提供商为 null。 exa_similarity_score: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' description: Exa 对公司网站与匹配页面的神经相似度；其他数据提供商为 null。 reason: anyOf: - type: string - type: 'null' description: 数据提供商认为公司相似的原因，来自 PredictLeads。 required: - domain - name - page_title - position - predictleads_similarity_score - exa_similarity_score - reason additionalProperties: false required: - items additionalProperties: false - type: object properties: items: type: array items: type: object properties: title: anyOf: - type: string - type: 'null' description: 标题。 url: anyOf: - type: string - type: 'null' description: 文章 URL。 source: anyOf: - type: string - type: 'null' description: 出版方名称，来自 Serper；未提供时为 null。 published_at: anyOf: - type: string - type: 'null' description: 文章发布时间，ISO 8601 UTC。 event_date: anyOf: - type: string - type: 'null' description: 所报道事件的发生日期，YYYY-MM-DD，来自 PredictLeads。 date_text: anyOf: - type: string - type: 'null' description: >- 数据提供商原样返回的展示日期，例如 Google News 的 '3 hours ago'，可能相对于 completed_at，不解析。 category: anyOf: - type: string - type: 'null' description: 数据提供商词汇中的事件分类，来自 PredictLeads。 snippet: anyOf: - type: string - type: 'null' description: 简短摘要。 required: - title - url - source - published_at - event_date - date_text - category - snippet additionalProperties: false required: - items additionalProperties: false - type: object properties: items: type: array items: type: object properties: title: anyOf: - type: string - type: 'null' description: 招聘信息中的职称。 url: anyOf: - type: string - type: 'null' description: 公司招聘页面上的职位 URL。 location: anyOf: - type: string - type: 'null' description: 数据提供商报告的地点文本。 seniority: anyOf: - type: string - type: 'null' description: 响应方词汇中的职级，来自 PredictLeads。 categories: type: array items: type: string description: 响应方词汇中的职能标签，未提供时为空。 contract_types: type: array items: type: string description: 数据提供商词汇中的合同类型，例如全职，未提供时为空。 salary_min_usd: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' description: 公开薪资下限，美元；未公开时为 null。 salary_max_usd: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' description: 公开薪资上限，美元；未公开时为 null。 salary_period: anyOf: - type: string - type: 'null' description: 数据提供商词汇中的计薪周期，例如 year、hour。 posted_at: anyOf: - type: string - type: 'null' description: 公司标注的发布时间，ISO 8601 UTC，通常为 null。 first_seen_at: anyOf: - type: string - type: 'null' description: 数据提供商首次发现职位的时间，ISO 8601 UTC。 last_seen_at: anyOf: - type: string - type: 'null' description: 数据提供商最近发现职位的时间，ISO 8601 UTC。 required: - title - url - location - seniority - categories - contract_types - salary_min_usd - salary_max_usd - salary_period - posted_at - first_seen_at - last_seen_at additionalProperties: false required: - items additionalProperties: false - type: 'null' description: >- 各操作的规范化字段。原生输出保留在 Run 中，可通过 GET /v1/runs/:id 读取。未报告的值为 null；有效空结果保留操作结构，各字段为 null 或 items 为 []，result_status 为 no_result。金额为美元。员工数和营收为响应方自身估算，*_range_min / *_range_max 为其区间边界。自有模型分数带数据提供商名称，如 exa_similarity_score，其他家为 null。industry、categories、round、category 保留响应方词汇。 - search: total_matches, items[]: domain 及公司资料字段；未报告的字段为 null - lookup: total_matches, items[]: domain 及公司资料字段；名称有歧义时返回候选 - enrich: name, website, description, industry, employees, employee_range_min, employee_range_max, founded_year, city, region, country, country_code, linkedin_url, phone, total_funding_usd, revenue_usd, revenue_range_min_usd, revenue_range_max_usd, ownership, ticker, latest_funding_date - tech_stack: items[]: name, categories[], detection_source, predictleads_confidence, first_detected_date, last_detected_date - traffic: monthly_visits, organic_traffic, paid_traffic, organic_keywords, paid_keywords, organic_traffic_value_usd, similarweb_global_rank, bounce_rate, pages_per_visit, avg_visit_duration_seconds - competitors: items[]: domain, name, page_title, position, predictleads_similarity_score, exa_similarity_score, reason - funding: total_funding_usd, items[]: round_date, round, amount_usd, investors[], source_url - news: items[]: title, url, source, published_at, event_date, date_text, category, snippet - jobs: items[]: title, url, location, seniority, categories[], contract_types[], salary_min_usd, salary_max_usd, salary_period, posted_at, first_seen_at, last_seen_at - ads: total_ads, items[]: creative_id, advertiser_id, advertiser_name, format, ad_url, image_url, first_shown_at, last_shown_at provider_response: anyOf: - type: object properties: http_status: type: integer minimum: 100 maximum: 599 description: 数据提供商返回的 HTTP 状态，即使 Run 为 COMPLETED 也应检查。 error: anyOf: - {} - type: 'null' required: - http_status additionalProperties: false - type: 'null' description: |- 仅在 status 为 COMPLETED 时非 null。 - 2xx 响应：output 为任意结构的数据提供商原生 JSON；正文为空时为 null。 - 非 2xx 响应：error 包含数据提供商错误正文，output 为 null。 两种正文均会移除敏感字段。 charge_usd: anyOf: - type: string pattern: ^(0|[1-9]\d*)\.(\d{2}|\d{2}\d{0,3}[1-9])$ description: 精确的美元十进制字符串，小数位数为 2–6，采用唯一规范格式。求和时使用十进制运算或乘以 10^6 转为整数，不使用浮点数。 - type: 'null' description: 此 Solution 响应所含 runs 的总费用，全部 Run 结算前为 null。每个 Run 保留各自费用；失败也可能收费。 charge_basis: anyOf: - type: object properties: clause: type: string enum: - rule - NO_RESULT - PROVIDER_ERROR - TIMED_OUT - INTERNAL quantity: anyOf: - type: integer minimum: 0 - type: 'null' required: - clause - quantity additionalProperties: false - type: 'null' description: 单个 Run 的计费依据；多个 Run 汇总时为 null。各项费用请查看 runs[].charge_basis。 stoppable: type: boolean description: 当前是否可接受停止请求。不保证能在分派前停止 Run。 stop_requested_at: anyOf: - type: string description: ISO 8601 UTC 时间戳。 format: date-time - type: 'null' description: 请求停止的时间。如果已开始分派，Run 仍可能继续。 created_at: type: string description: ISO 8601 UTC 时间戳。 format: date-time started_at: anyOf: - type: string description: ISO 8601 UTC 时间戳。 format: date-time - type: 'null' completed_at: anyOf: - type: string description: ISO 8601 UTC 时间戳。 format: date-time - type: 'null' task_id: anyOf: - type: string - type: 'null' metadata: type: object additionalProperties: type: string minLength: 1 maxLength: 500 maxProperties: 20 propertyNames: type: string pattern: ^[a-z][a-z0-9_]{0,39}$ description: |- 已保存的追踪字段，可用于筛选 Run，不发送给数据提供商，不影响路由、价格或幂等。 - 最多 20 个键：小写字母、数字和下划线，以字母开头，最长 40 个字符。 - 值：长度为 1–500 的字符串。 - user_id：终端用户的不透明 ID，不得使用邮箱或姓名。 action: type: string enum: - search - lookup - enrich - tech_stack - traffic - competitors - funding - news - jobs - ads result_status: type: string enum: - success - no_result - error - pending description: >- 业务交付状态，与 status 中的最终 Run 生命周期独立。no_result 为有效空结果；error 表示数据提供商输出无法交付。 error: anyOf: - type: object properties: code: type: string message: type: string required: - code - message additionalProperties: false - type: 'null' runs: type: array items: type: object properties: id: type: string run_url: type: string description: 在控制台打开 Run，需要工作空间成员权限。 provider: type: string pattern: ^[a-z0-9][a-z0-9-]*$ endpoint: type: string pattern: ^\/.+$ endpoint_version: type: integer exclusiveMinimum: 0 status: type: string enum: - QUEUED - RUNNING - COMPLETED - FAILED - STOPPED description: >- QUEUED 或 RUNNING 表示仍在执行。COMPLETED 表示已有数据提供商响应，包括非 2xx 响应。FAILED 请读取 failure。STOPPED 表示分派前停止。charge_usd 与状态分别检查。 failure: anyOf: - type: object properties: kind: type: string enum: - TIMED_OUT - INTERNAL message: type: string required: - kind - message additionalProperties: false - type: 'null' description: Run 失败原因，仅在 status 为 FAILED 时非 null。 input: type: object properties: omitted: type: boolean enum: - true required: - omitted additionalProperties: false output: type: object properties: omitted: type: boolean enum: - true required: - omitted additionalProperties: false provider_response: anyOf: - type: object properties: http_status: type: integer minimum: 100 maximum: 599 description: 数据提供商返回的 HTTP 状态，即使 Run 为 COMPLETED 也应检查。 required: - http_status additionalProperties: false - type: 'null' charge_usd: anyOf: - type: string pattern: ^(0|[1-9]\d*)\.(\d{2}|\d{2}\d{0,3}[1-9])$ description: >- 精确的美元十进制字符串，小数位数为 2–6，采用唯一规范格式。求和时使用十进制运算或乘以 10^6 转为整数，不使用浮点数。 - type: 'null' description: >- 最终费用，精确的美元十进制字符串。QUEUED 或 RUNNING 时为 null。FAILED 状态的 Run 仍可能按接口定价产生非零费用。 charge_basis: anyOf: - type: object properties: clause: type: string enum: - rule - NO_RESULT - PROVIDER_ERROR - TIMED_OUT - INTERNAL quantity: anyOf: - type: integer minimum: 0 - type: 'null' required: - clause - quantity additionalProperties: false - type: 'null' description: 计算费用所用的价格条款。结算前或未尝试调用数据提供商时为 null。 stoppable: type: boolean description: 当前是否可接受停止请求。不保证能在分派前停止 Run。 stop_requested_at: anyOf: - type: string description: ISO 8601 UTC 时间戳。 format: date-time - type: 'null' description: 请求停止的时间。如果已开始分派，Run 仍可能继续。 created_at: type: string description: ISO 8601 UTC 时间戳。 format: date-time started_at: anyOf: - type: string description: ISO 8601 UTC 时间戳。 format: date-time - type: 'null' completed_at: anyOf: - type: string description: ISO 8601 UTC 时间戳。 format: date-time - type: 'null' task_id: anyOf: - type: string - type: 'null' metadata: type: object additionalProperties: type: string minLength: 1 maxLength: 500 maxProperties: 20 propertyNames: type: string pattern: ^[a-z][a-z0-9_]{0,39}$ description: |- 已保存的追踪字段，可用于筛选 Run，不发送给数据提供商，不影响路由、价格或幂等。 - 最多 20 个键：小写字母、数字和下划线，以字母开头，最长 40 个字符。 - 值：长度为 1–500 的字符串。 - user_id：终端用户的不透明 ID，不得使用邮箱或姓名。 required: - id - run_url - provider - endpoint - endpoint_version - status - failure - input - output - provider_response - charge_usd - charge_basis - stoppable - stop_requested_at - created_at - started_at - completed_at - task_id - metadata additionalProperties: false result_url: type: string description: >- 通过认证读取规范化结果和总费用的只读 URL 路径，配合 API 服务地址使用。不创建 Run，也不恢复切换。GET /v1/runs/:id 仍返回原生单个 Run。 required: - id - run_url - provider - endpoint - endpoint_version - status - failure - input - output - provider_response - charge_usd - charge_basis - stoppable - stop_requested_at - created_at - started_at - completed_at - task_id - metadata - action - result_status - error - runs - result_url additionalProperties: false ValidationFailedEncoded: type: object properties: error: type: object properties: code: type: string enum: - validation_failed message: type: string reason: anyOf: - type: string - type: 'null' control: anyOf: - type: string - type: 'null' retry_after_ms: anyOf: - anyOf: - type: integer - type: 'null' - type: 'null' details: anyOf: - type: object - type: 'null' required: - code - message additionalProperties: false request_id: type: string required: - error - request_id additionalProperties: false IdempotencyKeyRequiredEncoded: type: object properties: error: type: object properties: code: type: string enum: - idempotency_key_required message: type: string reason: anyOf: - type: string - type: 'null' control: anyOf: - type: string - type: 'null' retry_after_ms: anyOf: - anyOf: - type: integer - type: 'null' - type: 'null' details: anyOf: - type: object - type: 'null' required: - code - message additionalProperties: false request_id: type: string required: - error - request_id additionalProperties: false UnauthorizedEncoded: type: object properties: error: type: object properties: code: type: string enum: - unauthorized message: type: string reason: anyOf: - type: string - type: 'null' control: anyOf: - type: string - type: 'null' retry_after_ms: anyOf: - anyOf: - type: integer - type: 'null' - type: 'null' details: anyOf: - type: object - type: 'null' required: - code - message additionalProperties: false request_id: type: string required: - error - request_id additionalProperties: false InsufficientBalanceEncoded: type: object properties: error: type: object properties: code: type: string enum: - insufficient_balance message: type: string reason: anyOf: - type: string - type: 'null' control: anyOf: - type: string - type: 'null' retry_after_ms: anyOf: - anyOf: - type: integer - type: 'null' - type: 'null' details: anyOf: - type: object - type: 'null' required: - code - message additionalProperties: false request_id: type: string required: - error - request_id additionalProperties: false EndpointNotPermittedEncoded: type: object properties: error: type: object properties: code: type: string enum: - endpoint_not_permitted message: type: string reason: anyOf: - type: string - type: 'null' control: anyOf: - type: string - type: 'null' retry_after_ms: anyOf: - anyOf: - type: integer - type: 'null' - type: 'null' details: anyOf: - type: object - type: 'null' required: - code - message additionalProperties: false request_id: type: string required: - error - request_id additionalProperties: false ForbiddenEncoded: type: object properties: error: type: object properties: code: type: string enum: - forbidden message: type: string reason: anyOf: - type: string - type: 'null' control: anyOf: - type: string - type: 'null' retry_after_ms: anyOf: - anyOf: - type: integer - type: 'null' - type: 'null' details: anyOf: - type: object - type: 'null' required: - code - message additionalProperties: false request_id: type: string required: - error - request_id additionalProperties: false IdempotencyConflictEncoded: type: object properties: error: type: object properties: code: type: string enum: - idempotency_conflict message: type: string reason: anyOf: - type: string - type: 'null' control: anyOf: - type: string - type: 'null' retry_after_ms: anyOf: - anyOf: - type: integer - type: 'null' - type: 'null' details: anyOf: - type: object - type: 'null' required: - code - message additionalProperties: false request_id: type: string required: - error - request_id additionalProperties: false RateLimitedEncoded: type: object properties: error: type: object properties: code: type: string enum: - rate_limited message: type: string reason: anyOf: - type: string - type: 'null' control: anyOf: - type: string - type: 'null' retry_after_ms: anyOf: - anyOf: - type: integer - type: 'null' - type: 'null' details: anyOf: - type: object - type: 'null' required: - code - message additionalProperties: false request_id: type: string required: - error - request_id additionalProperties: false ServiceUnavailableEncoded: type: object properties: error: type: object properties: code: type: string enum: - service_unavailable message: type: string reason: anyOf: - type: string - type: 'null' control: anyOf: - type: string - type: 'null' retry_after_ms: anyOf: - anyOf: - type: integer - type: 'null' - type: 'null' details: anyOf: - type: object - type: 'null' required: - code - message additionalProperties: false request_id: type: string required: - error - request_id additionalProperties: false securitySchemes: bearer: type: http scheme: Bearer ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.