多格式输出

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

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

可用结果类型

输出类型	描述
png	该 PNG 截图 的网页。
parsed	网页的解析内容，格式化为 JSON 数据结构。
markdown	Markdown 的网页。
xhr	XHR 请求 在加载页面时发出的。
raw	在给定 URL 处找到的原始内容。它很可能是（但不一定总是）HTML 文档。

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

首先在初始请求载荷中启用结果类型，使其可用。示例使用了一个带有 专用解析器。对于没有该解析器的页面， parse: true 需要 自定义解析器 说明。

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

{
    "source": "amazon_product",
    "query": "B07FZ8S74R",
    "parse": true,
    "markdown": true,
    "xhr": true,
    "render": "png"
}

仅设置你要检索的结果类型。

第 2 步：检索多种结果类型

然后，使用 type URL 参数指定要检索的类型。例如：

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

Realtime 会省略未启用的请求类型，而 Push-Pull /results 端点会返回它，并带有空的 content 字符串。

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[] 数组中。条目的顺序不固定（Realtime 和 Push-Pull 返回顺序不同）：

{
    "results": [
        {
            "content": {
                "url": "https://www.amazon.com/dp/B07FZ8S74R?language=en_US",
                "asin": "B07FZ8S74R",
                "title": "Echo Dot（第三代，2018 发布版）- 搭载 Alexa 的智能音箱 - 炭黑色",
                "rating": 4.7,
                "reviews_count": 1037924,
                "parse_status_code": 12000,
                ...
            },
            "type": "parsed",
            "created_at": "2026-09-14 11:48:10",
            "updated_at": "2026-09-14 11:48:27",
            "page": 1,
            "url": "https://www.amazon.com/dp/B07FZ8S74R?language=en_US",
            "job_id": "7505230915858120705",
            "is_render_forced": false,
            "status_code": 200
        },
        {
            "content": "![](https://m.media-amazon.com/images/G/01/gno/sprites/nav-sprite-global-1x-reorg-privacy._CB779528203_.png)\n\n## 跳转到...",
            "type": "markdown",
            "created_at": "2026-09-14 11:48:10",
            "updated_at": "2026-09-14 11:48:27",
            "page": 1,
            "url": "https://www.amazon.com/dp/B07FZ8S74R?language=en_US",
            "job_id": "7505230915858120705",
            "is_render_forced": false,
            "status_code": 200
        },
        {
            "content": [
                {
                    "url": "https://m.media-amazon.com/images/G/01/csm/showads.v2.js?adspot_=1",
                    "method": "GET",
                    "status_code": 200,
                    "request_headers": {
                        ...
                    },
                    "request_payload": null,
                    "response_headers": {
                        ...
                    },
                    "response_body": "window.ue_adb_chk = 1;\n..."
                },
                {...}
            ],
            "type": "xhr",
            "created_at": "2026-09-14 11:48:10",
            "updated_at": "2026-09-14 11:48:27",
            "page": 1,
            "url": "https://www.amazon.com/dp/B07FZ8S74R?language=en_US",
            "job_id": "7505230915858120705",
            "is_render_forced": false,
            "status_code": 200
        },
        {
            "content": "iVBORw0KGgoAAAANSUhEUgAAB3kAADklCAIAAAD9...",
            "type": "png",
            "created_at": "2026-09-14 11:48:10",
            "updated_at": "2026-09-14 11:48:27",
            "page": 1,
            "url": "https://www.amazon.com/dp/B07FZ8S74R?language=en_US",
            "job_id": "7505230915858120705",
            "is_render_forced": false,
            "status_code": 200
        },
        {
            "content": "<!DOCTYPE html><html lang=\"en-us\" class=\"a-ws a-js a-audio a-video a-c...",
            "type": "raw",
            "created_at": "2026-09-14 11:48:10",
            "updated_at": "2026-09-14 11:48:27",
            "page": 1,
            "url": "https://www.amazon.com/dp/B07FZ8S74R?language=en_US",
            "job_id": "7505230915858120705",
            "is_render_forced": false,
            "status_code": 200
        }
    ],
    "job": {...}
}