检索分析

使用 GET 方法调用 Analyze API，分析网页 URL 并提取结构化数据（例如文章、商品、图片等）。

由Diffbot Extract API（网页抽取）

0调用量

N/A延迟

Discover -> Inspect -> Call

调用设置

工具 IDdiffbot.analyze.retrieve.v1

请求参数JSON

本次调用前

1 积分 / 次

最终费用按供应商实际用量结算，并同步到使用记录。

字段参考

urlstring必填

待分析网页的 URL（需进行 URL 编码）

modestring可选

默认情况下，Analyze API 将完整提取所有匹配现有 Extract API 的页面。可将 mode 设置为特定 Extract API（例如 `mode="article"`），仅从此类页面类型中提取内容；其余页面仅返回默认的 Analyze 字段。

fallbackstring可选

当无法确定合适的 API 时（页面被分类为 "other" 类型），回退至该 API。

fieldsstring可选

指定可选字段，用于从完全提取的页面中返回（例如 `fields=querystring,links`）

discussionboolean可选

传入 `discussion=false` 可禁用对识别为文章或商品页面的评论或用户评价的自动提取；此参数不影响被识别为讨论页（discussion）的页面。

timeoutinteger可选

设置等待目标 URL 内容获取/抓取完成的毫秒数。第三方响应的默认超时时间为 30 秒（30000 毫秒）。

callbackstring可选

用于 JSONP 请求，跨域 AJAX 所必需。

proxystring可选

指定一个[自定义代理](https://docs.diffbot.com/reference/using-proxies#how-to-use-proxies)的 IP 地址，用于获取目标页面。（例如：`&proxy` 或 `&proxy=0.0.0.0`）

proxyAuthstring可选

用于指定与 `&proxy` 参数中设置的自定义代理配合使用的认证参数。（例如：`proxyAuth=username:password`）

useProxystring可选

设为 `default` 表示为此请求使用[Diffbot 数据中心代理](https://docs.diffbot.com/reference/using-proxies#how-to-use-proxies)；设为 `none` 则指示 Extract 不使用任何代理（即使该 URL 已全局启用代理）。