MarkUDown
Map API — MarkUDown 网站 URL 发现 API 文档
POST
/api/mapMap
通过站点地图解析和链接爬取发现网站上的所有 URL,无需获取页面内容。快速轻量 — 非常适合规划爬取或审计站点结构。
| 参数 | 类型 | 必填 | 默认值 | 描述 |
|---|---|---|---|---|
| url | array<string> | 必填 | — | 要映射的网站根 URL,以单元素数组传入。 |
| allowed_words | array<string> | 可选 | [] | 只返回至少包含其中一个词的 URL。 |
| blocked_words | array<string> | 可选 | [] | 排除包含其中任意一个词的 URL。 |
| max_urls | integer | 可选 | 1000 | 最多返回的 URL 数量。 |
请求
{
"url": ["https://store.example.com"],
"allowed_words": ["product"],
"max_urls": 500
}响应
// POST returns { "success": true, "id": "abc123", "url": "/api/map/abc123" }
// Poll GET /api/map/{id}
{
"success": true,
"id": "abc123",
"status": "completed",
"data": {
"success": true,
"total": 3,
"links": [
"https://store.example.com/product/shoes",
"https://store.example.com/product/bag",
"https://store.example.com/product/hat"
]
}
}