网页抓取

输入一个网址,提取单页正文,方便后续处理和分析。

POSThttps://api.zleap.com/v1/tools/fetch同步接口

请求参数

urlstring必填

公开可访问的完整 HTTP(S) 地址,不能包含用户名或密码。

effortstring可选

low(默认):HTTP 协议抓取,返回 url/content;max:浏览器渲染,返回 title/content。两种方式都只抓取当前单页。

可选值:low、max。

默认值:low

返回字段

urlstring

仅 low:最终读取的网页地址,可能经过重定向。

titlestring

仅 max:浏览器渲染页面的标题。

contentstring

两种方式均返回 Markdown 正文。

original_file_urlstring

原文件的绝对平台下载地址。携带同一 API Key 下载,不重复计费。

usage.multipliernumber

本次消耗倍率,保留两位精度。

请求说明

同步接口。 请求完成后返回 HTTP 200 OK,直接读取响应的 content 中的网页正文。本接口无需获取任务 ID,也无需轮询任务状态。

必填请求头取值
AuthorizationBearer YOUR_API_KEY,使用控制台创建的 API Key。
Content-Typeapplication/json

抓取范围

low 为协议抓取,max 为浏览器渲染;两者都固定处理一个页面。max 不会自动递归站内链接,depth/max_pages 不属于此接口参数。

页面不可用时

未能抓取或提取正文时返回 HTTP 404;同步等待超时返回 HTTP 504,error.code 为 timeout。失败请求不按示例倍率扣费。

计费

¥0.001×倍率/次

low 和 max 使用同一基础价,按基础价 × 响应的 usage.multiplier 结算。倍率为 0 或请求失败时不收费;下载原文件不再扣费。