跳转到主要内容
GET
读取网页研究结果
通过 search 或 scrape 返回的 result_url,读取相同 Run 的规范化输出、业务 result_status 和总费用。HTTP 200 仍可能包含 result_status=pending。此认证读取不创建 Run、不调用数据提供商、不恢复切换,也不重置预算。GET /v1/runs/:id 仍返回单个 Run 的原生输出。结果上下文带签名,绑定工作空间,并对每个 Run 按当前 API Key Policy 检查权限。

查询参数

token
string
必填

result_url 中返回的不透明结果上下文。保持原样,并使用有权读取所列全部 Run 的 API Key 认证。

Required string length: 1 - 16384

响应

WebResearchResult

id
string
必填
run_url
string
必填

在控制台打开 Run,需要工作空间成员权限。

provider
string
必填
Pattern: ^[a-z0-9][a-z0-9-]*$
endpoint
string
必填
Pattern: ^\/.+$
endpoint_version
integer
必填
status
enum<string>
必填

QUEUED 或 RUNNING 表示仍在执行。COMPLETED 表示已有数据提供商响应,包括非 2xx 响应。FAILED 请读取 failure。STOPPED 表示分派前停止。charge_usd 与状态分别检查。

可用选项:
QUEUED,
RUNNING,
COMPLETED,
FAILED,
STOPPED
failure
object | null
必填

Run 失败原因,仅在 status 为 FAILED 时非 null。

input
object
必填
output
object
必填

各操作的规范化字段。数据提供商原生输出不在此重复,保留在 Run 中,可通过 GET /v1/runs/:id 读取。未报告的值为 null。

  • search: results[]: url, title, snippet ,Google 摘要;Exa 为提取片段, position, published_at, date_text, date ,已弃用
  • news: items[]: title, url, source, published_at, date_text, snippet
  • places: items[]: name, address ,数据提供商原生文本,可能仅含街道, category, rating ,1–5, reviews, phone, website, latitude, longitude, google_cid
  • scholar: items[]: title, url, snippet, publication, year, cited_by, pdf_url
  • shopping: items[]: title, url ,Google Shopping 页面, merchant_url, google_product_id, price_text, seller, rating ,1–5, reviews, image_url
  • images: items[]: title, image_url, thumbnail_url, source_url, source, width, height
  • videos: items[]: title, url, channel, source, date_text, duration_text, snippet, thumbnail_url
  • answer: answer, citations[]: url, title, published_at
  • scrape: url, final_url, title, text, markdown, html, raw_html, text_character_limit, cached, fetched_at, quality ,已弃用
  • similar: items[]: url, title, exa_similarity_score, published_at, author

published_at 为 ISO 8601 UTC,仅根据数据提供商机器时间戳填写。date_text 为 Google 原样日期文本,可能相对于 Run 的 completed_at,不解析。rating 为 Google 1–5 平均星级;reviews 为数量。source 为出版方或网站名称。exa_similarity_score 为 Exa 自身分数,只宜在同一响应内比较。

provider_response
object | null
必填

仅在 status 为 COMPLETED 时非 null。

  • 2xx 响应:output 为任意结构的数据提供商原生 JSON;正文为空时为 null。
  • 非 2xx 响应:error 包含数据提供商错误正文,output 为 null。

两种正文均会移除敏感字段。

charge_usd
string | null
必填

此 Solution 响应所含 runs 的总费用,全部 Run 结算前为 null。每个 Run 保留各自费用;失败也可能收费。

Pattern: ^(0|[1-9]\d*)\.(\d{2}|\d{2}\d{0,3}[1-9])$
charge_basis
object | null
必填

单个 Run 的计费依据;多个 Run 汇总时为 null。各项费用请查看 runs[].charge_basis。

stoppable
boolean
必填

当前是否可接受停止请求。不保证能在分派前停止 Run。

stop_requested_at
string<date-time> | null
必填

请求停止的时间。如果已开始分派,Run 仍可能继续。

created_at
string<date-time>
必填

ISO 8601 UTC 时间戳。

started_at
string<date-time> | null
必填

ISO 8601 UTC 时间戳。

completed_at
string<date-time> | null
必填

ISO 8601 UTC 时间戳。

task_id
string | null
必填
metadata
object
必填

已保存的追踪字段,可用于筛选 Run,不发送给数据提供商,不影响路由、价格或幂等。

  • 最多 20 个键:小写字母、数字和下划线,以字母开头,最长 40 个字符。
  • 值:长度为 1–500 的字符串。
  • user_id:终端用户的不透明 ID,不得使用邮箱或姓名。
action
enum<string>
必填
可用选项:
search,
news,
places,
scholar,
shopping,
images,
videos,
answer,
scrape,
similar
result_status
enum<string>
必填

业务交付状态,与 status 中的最终 Run 生命周期独立。success 不代表内容语义质量已验证。

可用选项:
success,
partial,
no_result,
error,
pending
missing_formats
enum<string>[]
必填
可用选项:
text,
markdown,
html,
raw_html
error
object | null
必填
runs
object[]
必填
result_url
string
必填

通过认证读取规范化结果和总费用的只读 URL 路径,配合 API 服务地址使用。不创建 Run,也不恢复切换。GET /v1/runs/:id 仍返回原生单个 Run。