多格式输出

查看如何通过一次 API 调用获取多种输出格式。

你可以获取 多个结果类型 在单个 API 响应中。此功能在 Realtime 和 Push-Pull 集成方式下的工作方式相同。

可用结果类型

输出类型

说明

png

该 PNG 截图网页的。

parsed

网页内容的解析结果，格式为 JSON 数据结构。

markdown

Markdown 网页的。

xhr

XHR 请求在页面加载期间发出的。

原始

给定 URL 中找到的原始内容。它很可能是（但不一定总是）HTML 文档。

步骤 1：指定可供获取的结果类型

先在初始请求负载中启用结果类型，使其可用。

示例 POST https://data.oxylabs.io/v1/queries 负载：

{
  "source": "universal",
  "url": "https://example.com",
  "parse": true,
  "markdown": true,
  "xhr": true,
  "render": "png"
}

只设置你想检索的结果类型。

步骤 2：检索多个结果类型

然后，在获取结果时使用 type URL 参数指定要检索的类型。例如：

type=parsed,png 将返回解析结果和 PNG 截图
type=parsed,markdown,xhr,png,raw 将返回所有结果类型

Realtime API 端点：

POST https://realtime.oxylabs.io/v1/queries?type=parsed,markdown,xhr,png,raw

Push-Pull API 端点：

GET https://data.oxylabs.io/v1/queries/{job_id}/results?type=parsed,markdown,xhr,png,raw

输出示例

API 会在单个 results[] 数组中返回所有请求的类型：

{
    "results": [
        {
            "content": "<!DOCTYPE html>\n<html>\n<head>\n    <title>Example Domain</title>\n\n...",
            "type": "raw",
            "created_at": "2025-08-14 07:59:07",
            "updated_at": "2025-08-14 07:59:08",
            "page": 1,
            "url": "https://example.com",
            "job_id": "7333804527868451841",
            "is_render_forced": false,
            "status_code": 200
        },
        {
            "content": {"title": "Example Domain", "paragraph_text": "This domain..."},
            "type": "parsed",
            "created_at": "2025-08-14 07:59:07",
            "updated_at": "2025-08-14 07:59:08",
            "page": 1,
            "url": "https://example.com",
            "job_id": "7333804527868451841",
            "is_render_forced": false,
            "status_code": 200
        },
        {
            "content": "abcd1234",
            "type": "png",
            "created_at": "2025-08-14 07:59:07",
            "updated_at": "2025-08-14 07:59:08",
            "page": 1,
            "url": "https://example.com",
            "job_id": "7333804527868451841",
            "is_render_forced": false,
            "status_code": 200
        },
        {
            "content": "# Example Domain...",
            "type": "markdown",
            "created_at": "2025-08-14 07:59:07",
            "updated_at": "2025-08-14 07:59:08",
            "page": 1,
            "url": "https://example.com",
            "job_id": "7333804527868451841",
            "is_render_forced": false,
            "status_code": 200
        },
        {
            "content": [
              {"url": "...", "headers": "..."},
              {"url": "...", "headers": "..."}
            ],
            "type": "xhr", 
            "created_at": "2025-08-14 07:59:07",
            "updated_at": "2025-08-14 07:59:08",
            "page": 1,
            "url": "https://example.com",
            "job_id": "7333804527868451841",
            "is_render_forced": false,
            "status_code": 200
        }
      ]
}

上一页Markdown 输出下一页下载图片

最后更新于 1个月前

这有帮助吗？

{
    "results": [
        {
            "content": "<!DOCTYPE html>\n<html>\n<head>\n    <title>Example Domain</title>\n\n...",
            "type": "raw",
            "created_at": "2025-08-14 07:59:07",
            "updated_at": "2025-08-14 07:59:08",
            "page": 1,
            "url": "https://example.com",
            "job_id": "7333804527868451841",
            "is_render_forced": false,
            "status_code": 200
        },
        {
            "content": {"title": "Example Domain", "paragraph_text": "This domain..."},
            "type": "parsed",
            "created_at": "2025-08-14 07:59:07",
            "updated_at": "2025-08-14 07:59:08",
            "page": 1,
            "url": "https://example.com",
            "job_id": "7333804527868451841",
            "is_render_forced": false,
            "status_code": 200
        },
        {
            "content": "abcd1234",
            "type": "png",
            "created_at": "2025-08-14 07:59:07",
            "updated_at": "2025-08-14 07:59:08",
            "page": 1,
            "url": "https://example.com",
            "job_id": "7333804527868451841",
            "is_render_forced": false,
            "status_code": 200
        },
        {
            "content": "# Example Domain...",
            "type": "markdown",
            "created_at": "2025-08-14 07:59:07",
            "updated_at": "2025-08-14 07:59:08",
            "page": 1,
            "url": "https://example.com",
            "job_id": "7333804527868451841",
            "is_render_forced": false,
            "status_code": 200
        },
        {
            "content": [
              {"url": "...", "headers": "..."},
              {"url": "...", "headers": "..."}
            ],
            "type": "xhr", 
            "created_at": "2025-08-14 07:59:07",
            "updated_at": "2025-08-14 07:59:08",
            "page": 1,
            "url": "https://example.com",
            "job_id": "7333804527868451841",
            "is_render_forced": false,
            "status_code": 200
        }
      ]
}