# 网页爬虫API Playground

[**Web Scraper API Playground**](https://dashboard.oxylabs.io/?route=/api-playground) 是 Oxylabs 控制面板中的一个交互式工具。它允许你在简化环境中构建和测试 Web Scraper API 请求。

使用 Web Scraper API Playground，你可以尝试不同的目标，调整请求参数，预览结果，并导出可直接使用的代码片段。它适用于初学者和高级用户，也适合快速原型开发和验证请求配置。

它还集成了 [**OxyCopilot**](https://developers.oxylabs.io/scraping-solutions/oxycopilot)，这是一个由 AI 驱动的助手，可帮助生成解析规则、创建解析器预设、构建爬虫，并根据自然语言提示生成浏览器指令。

## 主要功能

Web Scraper API Playground 是用于试验 Web Scraper API 请求的主要环境。其主要功能包括：

* **交互式请求构建器** – 选择一个来源（Universal、Amazon、Google、YouTube 等），输入 URL 或查询词，然后直接从控制面板运行请求。
* **参数自定义** – 调整 JavaScript 渲染、地理位置、区域设置、解析、用户代理类型等选项。
* **结果预览** – 以原始 HTML 或解析后的 JSON 查看响应，以确认请求输出。
* **导出选项** – 复制生成的代码片段（cURL、Python 等）或请求负载以供进一步使用。
* [**OxyCopilot**](https://developers.oxylabs.io/scraping-solutions/oxycopilot) **集成** – 使用内置助手，通过自然语言自动创建爬虫请求负载、解析逻辑、可复用的解析器预设或浏览器指令。

{% hint style="info" %}
在爬取时，Web Scraper API Playground 旨在用于 **测试和探索**。对于大规模或自动化工作流，请使用标准的 Web Scraper API 集成方式（[Realtime](https://developers.oxylabs.io/documentation/cn/zhua-qu-jie-jue-fang-an/web-scraper-api/integration-methods/realtime), [Push-Pull](https://developers.oxylabs.io/documentation/cn/zhua-qu-jie-jue-fang-an/web-scraper-api/integration-methods/push-pull)，或 [Proxy Endpoint](https://developers.oxylabs.io/documentation/cn/zhua-qu-jie-jue-fang-an/web-scraper-api/integration-methods/proxy-endpoint)).
{% endhint %}

## 如何使用

使用 Web Scraper API Playground 非常简单。请按以下步骤操作：

{% stepper %}
{% step %}

### 访问 Web Scraper API Playground

登录 [Oxylabs 控制面板](https://dashboard.oxylabs.io/) 并打开 Web Scraper API Playground。

<figure><img src="https://2655358775-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzrXw45naRpCZ0Ku9AjY1%2Fuploads%2F0rSdQFupLxcyaD1p7Kq1%2Foxy-dashboard-playground.png?alt=media&#x26;token=d668c1c2-32c5-48a8-91aa-b299ec637919" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### 选择来源

选择一个专用来源——特定网站（例如 Google、Amazon、YouTube 等）以及爬虫来源（例如 URL、 `amazon_product`, `google_search`）或“--Any other website--”，用于下拉菜单中未列出的网站。

<figure><img src="https://2655358775-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzrXw45naRpCZ0Ku9AjY1%2Fuploads%2FDAZly0wo2krfRkNUDzQH%2Fplayground-select-source.png?alt=media&#x26;token=345b066a-5b99-4be1-a0c1-505c27b8ba52" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### 输入查询或 URL

提供你想要爬取的搜索查询或页面 URL。

<figure><img src="https://2655358775-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzrXw45naRpCZ0Ku9AjY1%2Fuploads%2FZtPvKwXohRgiGfLgyugw%2Fplayground-enter-query.png?alt=media&#x26;token=97dcedc9-ae05-48e7-9501-ee9bbf75a941" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### 添加附加参数（可选）

根据你的使用场景调整渲染、解析、本地化或其他选项。

<figure><img src="https://2655358775-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzrXw45naRpCZ0Ku9AjY1%2Fuploads%2FtUlWX0n55hsXrQ17Prrq%2Fplayground-add-parameters.png?alt=media&#x26;token=1db941dd-7456-4812-b1ad-71494934c6c8" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### 运行请求

提交请求并立即预览返回的数据。

<figure><img src="https://2655358775-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzrXw45naRpCZ0Ku9AjY1%2Fuploads%2FEBPLJY05hqBD819M8Jlb%2Fplayground-run-request.png?alt=media&#x26;token=a093ce0d-ecac-4c11-bbe8-a36987b7009b" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### 导出

如果你对结果满意，可以复制生成的代码片段或你首选编程语言中的请求负载，并在脚本或应用程序中使用它。你也可以使用右上角下拉菜单导出 JSON 或 HTML 结果。

<figure><img src="https://2655358775-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzrXw45naRpCZ0Ku9AjY1%2Fuploads%2FyBnydcEnJnQ7SaeMpSmw%2Fplayground-export-results.png?alt=media&#x26;token=45475624-c175-4cfa-ab62-c87375a4d0b4" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

## 访问与试用

所有有权访问 Web Scraper API 的 Oxylabs 控制面板用户都可以使用 Web Scraper API Playground。

* **试用用户** 可以使用 [免费试用](https://oxylabs.io/products/scraper-api/web/pricing).
* **付费用户** 可以将 Web Scraper API Playground 与常规 API 集成一起使用，作为测试和原型开发环境。