参数 - Introduction

POST 端点

https://data.decodo.com/v1/map /map 为同步调用——URL 列表会在同一响应中返回。

输入参数

参数	类型	必填	描述
`url`	string	✅	用于发现 URL 的页面。必须是有效且可访问的 URL。
`sitemap`	string		URL 的收集来源。 `include`——同时收集站点地图和页面上的链接。默认值。 `only`——仅收集站点地图中列出的 URL。 `skip`——仅收集页面上的链接。仅读取顶层站点地图，不会跟踪嵌套的站点地图。如果网站的站点地图是站点地图索引（sitemap index），`only` 会返回 `400` 错误，而 `include` 会回退为仅收集页面上的链接。
`select_paths`	array		正则表达式模式。仅返回路径至少匹配其中一个模式的 URL。示例：`["^/blog"]`。
`exclude_paths`	array		正则表达式模式。路径匹配任一模式的 URL 将被排除。示例：`["^/use-cases"]`。
`domain_filter`	string		要包含的域名范围。 `domain`——仅主域名。默认值。 `subdomain`——主域名及其子域名（例如 `example.com` → `blog.example.com`）。 `all`——主域名、子域名以及外部网站。
`JS_rendering`	boolean		设置为 `true` 可在收集链接前先进行 JavaScript 渲染。适用于通过 JavaScript 加载导航的网站。按高级代理 + JS 费率计费。默认值为 `false`。
`geo`	string		发送请求所用的国家/地区。接受完整的国家/地区名称或 2 位字母国家/地区代码。
`locale`	string		请求页面时使用的语言和地区，例如 `en-US`。

请求示例

# 将 'TOKEN VALUE' 替换为您的 API 密钥
curl --request 'POST' \
  --url 'https://data.decodo.com/v1/map' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer TOKEN VALUE' \
  --header 'Content-Type: application/json' \
  --data '
{
  "url": "https://example.com",
  "sitemap": "include",
  "select_paths": ["^/blog"],
  "exclude_paths": ["^/use-cases"],
  "domain_filter": "subdomain",
  "geo": "United States"
}
'

输出

来自站点地图和页面的 URL 会合并为一个列表。系统会先对 URL 进行规范化，再去除重复项——因此 example.com/page/、example.com/page#section 和 example.com/page 会被视为同一个 URL。单次调用最多可返回 14.7 万个 URL。响应包含一个 results 数组，其中有一个对象，包含以下键：

键	描述
`content.links`	应用过滤条件后找到的所有 URL。每一项都是包含 `url` 键的对象。
`status_code`	只要至少有一个请求（页面或站点地图）成功，即为 `200`。
`url`	您提交的 URL。
`sitemap_status`	实际使用了哪些 URL 来源。取值见下文。
`map_id`	本次请求的唯一 ID。如需帮助，请将其提供给支持团队。
`created_at`	收到请求的时间（UTC）。
`updated_at`	响应完成的时间（UTC）。

`sitemap_status` 取值

值	含义
`include`	URL 同时收集自站点地图和页面上的链接。
`only`	URL 仅收集自站点地图。
`skip`	URL 仅收集自页面上的链接。如果网站没有可用的站点地图，即使设置了 `sitemap: "include"`，也会返回 `skip`。

响应示例

{
  "results": [
    {
      "content": {
        "links": [
          { "url": "https://decodo.com/blog" },
          { "url": "https://decodo.com/blog/asos-hacked" },
          { "url": "https://decodo.com/blog/topics/news" },
          { "url": "https://decodo.com/blog/how-to-scrape-bing-search" }
        ]
      },
      "status_code": 200,
      "url": "https://decodo.com",
      "sitemap_status": "skip",
      "map_id": "ad357923-0203-4677-87bd-2b2b69e78b1f",
      "created_at": "2026-10-07 11:09:54",
      "updated_at": "2026-10-07 11:09:54"
    }
  ]
}

支持

需要帮助或只是想打个招呼？我们的支持团队全天候为您服务。
您也可以随时通过电子邮件 support@decodo.com 联系我们。

反馈

找不到您要找的内容？请求一篇文章！
有反馈意见？分享您对我们如何改进的想法。

关于

住宅代理

静态住宅（ISP）代理

数据中心代理

免费代理

SITE UNBLOCKER

网页数据 API

视频下载器

DECODO 工具

集成

账户与仪表板

支付

故障排除

提示与技巧

有用链接

参数

POST 端点

输入参数

请求示例

输出

`sitemap_status` 取值

响应示例

支持

反馈

​POST 端点

​输入参数

​请求示例

​输出

​sitemap_status 取值

​响应示例

支持

反馈

POST 端点

输入参数

请求示例

输出

`sitemap_status` 取值

响应示例