跳到导航

怎么列出一个网站的 URL?Map 能找全站所有页面吗?

调用 POST /v1/web/map 并传入站点公开页面作为起点,即可发现该站点的站内 URL 列表。Map 不保证找全网站的全部页面:单次请求最多返回 100 条去重 URL,且只沿链接追踪 1–3 层(max_depth 默认 1)。

用深度与路径正则控制范围

优先从目录型页面(如帮助中心索引页)启动,并用过滤参数聚焦目标栏目,避免为无关路径付展开费用:

  • limit:1–100(默认 50)。按每条返回 URL $0.001 计费;未发现任何链接时不扣费,并在 note 中提示可能原因(如外链页或由 JavaScript 动态生成的链接)。
  • max_depth:从起始 url 向外追踪 1–3 层链接(默认 1)。
  • select_paths 与 exclude_paths:各支持最多 10 条路径正则(单条不超过 200 字符;无法编译的正则返回 400 bad_request)。include_external 默认 false。
curl -sS https://api.beatapi.io/v1/web/map \
-H "Authorization: Bearer $BEATAPI_API_KEY" \
-H 'Content-Type: application/json' \
-d '{"url":"https://example.com/help","select_paths":["/help/.*"],"max_depth":2,"limit":50}'

核对覆盖度并读取目标正文

在内容清单中同步记录起始 url、max_depth 与路径过滤条件,按主题分组后把重点页面交给 POST /v1/web/read 核对正文。若怀疑漏页,将 Map 结果与网站公开的 sitemap.xml 或官方目录对照补漏。

合同与相关问题

执行前免费检查对应合同:data:web.search, data:web.read, data:web.map。

返回Web Search问题索引。