> For the complete documentation index, see [llms.txt](https://developers.oxylabs.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers.oxylabs.io/products/cn/web-scraper-api/faq.md).

# FAQ

关于 Oxylabs 网页爬虫API 的常见问题

查找有关网页爬虫API的常见问题答案。查看右侧目录，或向下滚动以查找答案。

### 如何开始使用网页爬虫API？

创建一个 [Oxylabs Dashboard 账户](https://dashboard.oxylabs.io/en/) 并选择网页爬虫API。选择试用或订阅，然后创建一个 API 用户。使用该用户的凭据为请求进行授权。

通过终端、Postman 或其他 HTTP 客户端发送您的第一个请求。使用 [网页爬虫API Playground](https://developers.oxylabs.io/products/cn/web-scraper-api/web-scraper-api-playground.md) 无需编写代码即可构建和测试请求。

### 我应使用哪种集成方法？

网页爬虫API提供三种集成方法：

* **Realtime** 会保持连接打开，直到结果准备就绪。
* **Push-Pull** 可为较大的工作负载创建异步任务。
* **Proxy Endpoint** 提供用于同步请求的代理式端点。

对于较简单的同步工作流，请使用 Realtime 或 Proxy Endpoint。当您需要异步处理或云端交付时，请使用 Push-Pull。请参阅 [集成方法](https://developers.oxylabs.io/products/cn/web-scraper-api/integration-methods.md) 以查看请求示例。

### 网页爬虫API支持哪些功能？

网页爬虫API支持 OxyCopilot、云端交付、批量查询、自定义解析器和任务管家。它还支持浏览器指令、Fetch/XHR 捕获和 Markdown 输出。

将云端交付用于 Amazon S3、Google Cloud Storage、Alibaba OSS 或兼容的存储服务。批量任务最多支持 5,000 个 `query` 或 `url` 值。请参阅 [功能](https://developers.oxylabs.io/products/cn/web-scraper-api/features.md) 以了解配置详情。

### 我可以在集成前测试网页爬虫API吗？

是的，您可以使用 [网页爬虫API Playground](https://developers.oxylabs.io/products/cn/web-scraper-api/web-scraper-api-playground.md) 在旧版 Oxylabs Dashboard 中。输入查询或 URL，配置请求参数，然后检查结果。

Playground 可以为您的实现生成请求代码。它还可帮助您测试解析、JavaScript 渲染、本地化和浏览器指令。

### 如何在 Dashboard 中管理网页爬虫API？

打开 **我的产品** 并选择网页爬虫API。使用 **统计信息** 以查看用量，并使用 **用户** 管理 API 凭据。

您可以配置消费限额、充值可用结果数、更改订阅或管理付款详情。使用 [网页爬虫API Playground](https://developers.oxylabs.io/products/cn/web-scraper-api/web-scraper-api-playground.md) 从 Dashboard 测试请求。

### 是否有任何受限目标？

部分网站受到限制，以防止滥用并支持负责任的数据收集。请参阅 [受限目标](https://developers.oxylabs.io/products/cn/web-scraper-api/restricted-targets.md) 以查看当前列表。

选定目标可能会在 KYC 审核后可用。请联系您的客户经理或 [Oxylabs 支持团队](mailto:support@oxylabs.io) 以请求访问权限。

### 网页爬虫API如何定价？

订阅包含每月结果额度。结果是指成功获取的内容，例如页面 HTML。

具有 `2xx` 或 `4xx` 目标状态码的响应会计为成功结果。具有 `5xx` 或 `6xx` 代码的系统错误响应不会产生结果费用。

额度取决于目标类别、套餐和 JavaScript 渲染要求。请参阅 [流量与计费](https://developers.oxylabs.io/products/cn/web-scraper-api/usage-and-billing/billing-information.md) 以了解计费详情。有关特定套餐的额度，请联系您的客户经理。

### 网页爬虫API可以返回哪些响应代码？

网页爬虫API返回标准 API 和特定于解析器的响应代码。使用响应正文诊断无效请求和授权错误。请参阅 [响应代码](https://developers.oxylabs.io/products/cn/web-scraper-api/response-codes.md) 以获取完整参考。

常见 API 代码包括：

* `200` – 请求已成功完成。
* `202` – 请求已被接受处理。
* `400`, `401`, `403`，或 `422` – 请求或授权问题。
* `429` – 已达到速率限制。
* `500`, `524`, `612`，或 `613` – 系统或处理问题。

重试发生故障的 `612` 或 `613` 任务。请联系 [Oxylabs 支持团队](mailto:support@oxylabs.io) 以获取更高的速率限制。

### 在哪里可以找到我的爬取任务 ID？

对于 Realtime 和 Proxy Endpoint 请求，请在响应中查找 `job_id` 。您还可以使用 `x-oxylabs-job-id` 响应标头。

对于 Push-Pull 请求，请使用 `id` 字段。任务 ID 会保留 48 小时。

### 哪些目标支持已解析的数据？

网页爬虫API会为支持的目标页面类型返回已解析的 JSON。支持的目标包括 Google、Google Shopping、Amazon、YouTube、ChatGPT、Perplexity、Bing、Walmart、Best Buy、Etsy 和 Target。

使用 [自定义解析器](https://developers.oxylabs.io/products/cn/web-scraper-api/features/custom-parser.md) 适用于其他目标。您可以将解析器保存为可重用的预设。OxyCopilot 可以根据自然语言指令生成解析逻辑。

### 我可以爬取哪些目标？

网页爬虫API支持热门的目标专用爬虫和通用网页爬取。浏览 [目标](https://developers.oxylabs.io/products/cn/web-scraper-api/mu-biao.md) 或使用 API Playground 测试您的目标。

在可用时使用目标专用 source。对于其他公开网站，请使用 `通用` source 并提供目标 URL。

### 我可以自动执行浏览器操作吗？

是。 [JS 渲染和浏览器控制](https://developers.oxylabs.io/products/cn/web-scraper-api/features/js-rendering-and-browser-control.md) 可以渲染 JavaScript，并自动执行点击、滚动、文本输入和其他浏览器操作。

手动或在 Playground 中创建指令。您也可以通过 OxyCopilot 根据自然语言提示生成指令。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://developers.oxylabs.io/products/cn/web-scraper-api/faq.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
