{
"data": [
{
"value": "4010.00",
"raw_text": "4,010.00"
}
],
"validation": {
"status": "ok",
"reason": "no_reference",
"value": 4010,
"model_value": 4010,
"raw_text": "4,010.00",
"reference": null,
"change_pct": null,
"suspect_pct": 10,
"reject_pct": 30,
"on_page": true,
"votes": [],
"mode": "shadow",
"reference_source": null
}
}
curl --location --request GET 'https://zylalabs.com/api/14427/screenshot+to+data+api/36435/extract+from+page?url=https://www.investing.com/commodities/gold&raw_text=true&value_field=value&parse_description=Current gold futures price as a plain number, in a field called value&last_value=4012.5&expiration_seconds=600&max_chars=6000&raw_text=true&value_field=value&last_value=4012.5&max_chars=6000' --header 'Authorization: Bearer YOUR_API_KEY'
{
"data": [
{
"value": 4066.5
}
],
"validation": {
"status": "ok",
"reason": "no_reference",
"value": 4066.5,
"model_value": 4066.5,
"raw_text": null,
"suspect_pct": 10,
"reject_pct": 30,
"on_page": null,
"votes": [],
"mode": "shadow"
}
}
curl --location --request GET 'https://zylalabs.com/api/14427/screenshot+to+data+api/36436/extract+from+screenshot?url=https://www.investing.com/commodities/gold&llm_instructions=Current gold price in USD as a number, in a field called value&expiration_seconds=600&value_field=value&last_value=4012.5' --header 'Authorization: Bearer YOUR_API_KEY'
注册后,每个开发者都会被分配一个个人 API 访问密钥,这是一个唯一的字母和数字组合,用于访问我们的 API 端点。要使用 Screenshot To Data API 进行身份验证,只需在 Authorization 标头中包含您的 bearer token。
| 标头 | 描述 |
|---|---|
授权
|
必需
应为 Bearer access_key. 订阅后,请查看上方的"您的 API 访问密钥"。
|
一个包含两个部分的JSON对象:data,即您在指令中要求的字段,以及validation,检查主要数值(状态正常、可疑、拒绝或未检查,原因,页面上书写的原始文本和使用的阈值)
用简单的语言,通过parse_description(文本端点)或llm_instructions(截屏端点)获取。命名您想要返回的字段,例如“产品名称,美元价格作为数字和可用性,在名为name、price和in_stock的字段中”
默认使用“从页面提取”:它更快,并且对页面文本有效。当数据仅在页面渲染后显示时(例如图表、小部件、画布表或JavaScript密集型应用),切换到“从截图提取”
是否数字实际上写在页面上(on_page)、是否看起来像是小数位移动(x10、x100),以及它从上一个相同URL和指令接受的值移动了多远。您总是会收到答案;状态告诉您该多信任它
是的 将last_value与您为该URL和指令存储的最后一个数字一起发送 验证会与它进行比较而不是服务历史 当您的答案有多个数字时使用value_field
不 页面和答案在expiration_seconds(默认600秒)之前被重复使用于相同的URL和指令 发送0以强制获取新的内容
提取页面内容从服务器呈现的文本 对于仅在页面运行脚本后出现的内容,请使用提取自截图,该方法在读取之前在浏览器中渲染页面
响应包含错误为真和描述问题的消息(被阻止的页面 超时 上游错误)该调用不会计为成功
两个端点返回结构化的 JSON 数据 从页面提取的端点根据页面的 HTML 文本提供字段,而从截图提取的端点返回从渲染内容中获得的数据,例如图表或小部件 每个响应都包括一个验证块以评估数字值的准确性
响应数据中的关键字段包括“value”,它包含提取的数字数据,以及“raw_text”,它显示页面上的原始文本。验证块包括“status”、“reason”和“on_page”等字段,以指示所提取数据的可靠性
响应数据分为两个主要部分:数据和验证 数据部分包含提取的字段,而验证部分提供对提取的数值的准确性和可靠性的见解,包括状态和任何差异的原因
页面提取适用于基于文本的数据,如价格和规格,而截图提取则专为需要呈现的视觉数据而设计,例如图表和动态内容。这两个端点都可以根据用户指令提取各种类型的信息
用户可以通过为“从页面提取”指定“parse_description”或为“从截图提取”指定“llm_instructions”来定制请求 他们可以定义想要提取的字段,并提供“last_value”用于验证比较,从而提高结果的准确性
数据来源于公开可访问的网页 API直接从指定的URL获取内容 确保提取的信息反映页面上最新的数据
数据准确性通过一个验证层来维持,该层将提取的数字值与页面文本、历史值和潜在的小数变化进行比较。这个过程有助于确保返回的数据是可靠和值得信赖的
典型的用例包括商品价格监测 竞争对手分析 提取产品规格 以及为人工智能系统提供经过验证的实时数据 该API特别适用于需要根据网页设计变化而调整数据提取的场景