> ## Documentation Index
> Fetch the complete documentation index at: https://help.decodo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 迁移到网页数据 API

> 将网页抓取 API 或快速搜索 API 集成迁移到网页数据 API：新的 API 密钥、新的基础 URL、Bearer 身份验证以及端点对应关系。

**网页数据 API** 取代了两款旧版产品：

* **网页抓取 API** 由 [/scrape](/docs/cn/web-data-api-scrape-introduction) 取代。
* **快速搜索 API** 由 [/search](/docs/cn/web-data-api-search-introduction) 取代。

现有配置仍可继续使用，因此您可以按自己的节奏进行迁移。请求参数保持不变，您只需更改 API 密钥、基础 URL 和身份验证请求头。

## 变更内容

| | 旧版 | 网页数据 API |
| :- | :- | :- |
| **基础 URL** | `https://scraper-api.decodo.com`（网页抓取 API）<br />`https://fastsearch.decodo.com`（快速搜索 API） | `https://data.decodo.com/v1` |
| **身份验证** | `Authorization: Basic TOKEN VALUE` | `Authorization: Bearer TOKEN VALUE` |
| **凭据** | 每个产品使用单独的令牌 | 一个 API 密钥适用于所有端点 |

## 端点对应关系

| 旧版端点 | 网页数据 API 端点 |
| :- | :- |
| `POST https://scraper-api.decodo.com/v2/scrape` | `POST https://data.decodo.com/v1/scrape` |
| `POST https://scraper-api.decodo.com/v3/task` | `POST https://data.decodo.com/v1/task` |
| `POST https://scraper-api.decodo.com/v3/task/batch` | `POST https://data.decodo.com/v1/task/batch` |
| `GET https://scraper-api.decodo.com/v3/task/{task_id}` | `GET https://data.decodo.com/v1/task/{task_id}` |
| `GET https://scraper-api.decodo.com/v3/task/{task_id}/results` | `GET https://data.decodo.com/v1/task/{task_id}/results` |
| `POST https://fastsearch.decodo.com/v0/search` | `POST https://data.decodo.com/v1/search` |

## 迁移步骤

### 1. 获取网页数据 API 密钥

旧版令牌无法用于网页数据 API，新的 API 密钥也无法用于旧版端点。请从[仪表盘](https://dashboard.decodo.com/)复制您的网页数据 API 密钥。

### 2. 更新 URL 和身份验证请求头

将旧版 URL 替换为上表中对应的网页数据 API 端点。然后将 `Authorization` 请求头中的 `Basic` 改为 `Bearer`，并使用您的新 API 密钥。

<CodeGroup>
  ```shellscript 迁移前（网页抓取 API） theme={null}
  curl --request 'POST' \
      --url 'https://scraper-api.decodo.com/v2/scrape' \
      --header 'Accept: application/json' \
      --header 'Authorization: Basic TOKEN VALUE' \
      --header 'Content-Type: application/json' \
      --data '
      {
        "target": "google_search",
        "query": "laptop",
        "parse": true
      }
  '
  ```

  ```shellscript 迁移后（/scrape） theme={null}
  curl --request 'POST' \
      --url 'https://data.decodo.com/v1/scrape' \
      --header 'Accept: application/json' \
      --header 'Authorization: Bearer TOKEN VALUE' \
      --header 'Content-Type: application/json' \
      --data '
      {
        "target": "google_search",
        "query": "laptop",
        "parse": true
      }
  '
  ```
</CodeGroup>

<CodeGroup>
  ```shellscript 迁移前（快速搜索 API） theme={null}
  curl --request 'POST' \
      --url 'https://fastsearch.decodo.com/v0/search' \
      --header 'Accept: application/json' \
      --header 'Authorization: Basic TOKEN VALUE' \
      --header 'Content-Type: application/json' \
      --data '
      {
        "query": "laptop"
      }
  '
  ```

  ```shellscript 迁移后（/search） theme={null}
  curl --request 'POST' \
      --url 'https://data.decodo.com/v1/search' \
      --header 'Accept: application/json' \
      --header 'Authorization: Bearer TOKEN VALUE' \
      --header 'Content-Type: application/json' \
      --data '
      {
        "query": "laptop"
      }
  '
  ```
</CodeGroup>

### 3. 保留请求体

您无需更改任何参数：

* **/scrape** 接受与网页抓取 API 相同的[参数](/docs/cn/web-data-api-scrape-parameters)，包括 `target`、`headless`、`proxy_pool` 和 `parse`，响应格式也保持不变。
* **/search** 接受与快速搜索 API 相同的[参数](/docs/cn/web-data-api-search-parameters)。响应包含 `organic`、`top_stories` 和 `status`，并可能包含 `answer_box`、`people_also_ask` 和 `related_searches` 等额外字段。

### 4. 先测试，再切换

使用新配置发送几个请求，并将结果与旧版集成进行对比。在确认新集成正常运行之前，请保持旧版集成继续运行。

## 新增功能

网页数据 API 还新增了两个旧版产品没有的端点：

* [/crawl](/docs/cn/web-data-api-crawl-introduction)：从您提交的 URL 开始，采集网站最多 10,000 个页面。
* [/map](/docs/cn/web-data-api-map-introduction)：列出某个页面中以及网站顶级站点地图中的 URL，不抓取页面内容。

***

<Columns cols={2}>
  <Card title="支持" href="https://direct.lc.chat/12092754" cta="让我们聊聊！">
    需要帮助或只是想打个招呼？我们的支持团队全天候为您服务。 \
    您也可以随时通过电子邮件 [support@decodo.com](mailto:support@decodo.com) 联系我们。
  </Card>

  <Card title="反馈" href="mailto:feedback@decodo.com" cta="分享反馈">
    找不到您要找的内容？请求一篇文章！ \
    有反馈意见？分享您对我们如何改进的想法。
  </Card>
</Columns>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.