站点发现 · Map API

基础信息

接口说明： 通过 API 创建 Map API 的采集任务，发现指定网站中的页面 URL 及相关信息。

请求地址： https://aiwebapi.dataify.com/map

请求方式： POST

请求格式： application/json 或 application/x-www-form-urlencoded

请求参数

Headers：

参数名称	参数类型	是否必须	描述
Authorization	string	是	固定格式：Authorization: Bearer <YOUR_API_TOKEN>。YOUR_API_TOKEN 可在仪表板 → 设置 → Token 管理获取。不支持自定义 Token 请求头。

Body：

参数名称	参数类型	是否必须	描述
unique_id	string	是	用于指定使用的工具，固定参数：map
url	string	是	需要发现站内页面的目标 URL 地址。
country	string	否	用于设置采集请求的国家或地区，使用两位大写 ISO 国家代码，默认值为 US。
domain_filter	enum	否	用于设置发现页面的域名范围。可选值：all（不限制域名）、domain（限制在指定域名内），默认值为 all。
limit	integer	否	用于设置返回的 URL 数量上限，范围为 1～100000，默认值为 5000。
sitemap	enum	否	用于设置是否使用站点 Sitemap。可选值：skip（不使用）、include（辅助使用 Sitemap 和 HTML 链接发现页面）、only（仅使用 Sitemap），默认值为 include。

响应示例

{
    {
      "url": "https://docs.example.com/guide",
      "title": "Guide",
      "description": "Documentation guide"
    }
}

响应参数

参数名称	参数类型	描述
url	string	本次请求发现的页面 URL 地址。
title	string	页面标题。
description	string	页面描述信息。