跳转到主要内容

概览

Web2MD REST API 让你以编程方式把任意网页或原始 HTML 转成干净的 Markdown。可以用来搭建管线、自动化内容采集,或把 Web2MD 集成到你自己的工具里。
REST API 需要 PRO 套餐。在 Web2MD 控制台生成你的 API key。

机器可读规范

可以用 OpenAPI 规范自动生成客户端 SDK,或导入 Postman、Swagger UI、AI Agent 框架等工具。

认证

所有请求都必须在 Authorization 头中带上 API key:
API key 以 w2m_ 为前缀,与你的账户绑定。

接口

POST https://web2md.org/api/v1/convert

请求体

只能提供 urlhtml 其中之一。两者都传或都不传,请求会返回 400 错误。

选项

响应

成功的响应返回:

速率限制

每个 API key 限制为每分钟 60 次请求。超出限制时 API 返回 429 状态码,请等待窗口重置后再重试。

错误响应

所有错误响应遵循这个结构:

示例

用 curl 转换 URL

用 curl 转换原始 HTML

JavaScript(fetch)

把 API key 存在环境变量里,不要硬编码。比如在 Node.js 中用 process.env.WEB2MD_API_KEY