Saída em múltiplos formatos

Veja como obter mais de um formato de saída com uma única chamada de API.

Você pode obter vários tipos de resultado em uma única resposta da API. Este recurso funciona da mesma forma com Realtime e Push-Pull métodos de integração.

Tipos de resultado disponíveis

Tipo de saída	Descrição
png	A captura de tela PNG de uma página da web.
parsed	Conteúdo parseado da página da web, formatado como uma estrutura de dados JSON.
markdown	Markdown de uma página da web.
xhr	requisições XHR feitas durante o carregamento da página.
raw	O conteúdo bruto encontrado em uma URL específica. É provável que seja (mas nem sempre será) um documento HTML.

Etapa 1: Especifique os tipos de resultado que estarão disponíveis para busca

Comece habilitando os tipos de resultado no payload inicial da sua solicitação para torná-los disponíveis. O exemplo usa uma fonte com um parser dedicado. Para uma página sem um, parse: true precisa Custom Parser instruções em vez disso.

Exemplo POST https://data.oxylabs.io/v1/queries payload:

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

Defina apenas os tipos de resultado que você quer recuperar.

Etapa 2: Recupere vários tipos de resultado

Em seguida, especifique quais tipos recuperar usando o type parâmetro de URL ao buscar resultados. Por exemplo:

• type=parsed,png retornará os resultados parseados e a captura de tela PNG
• type=parsed,markdown,xhr,png,raw retornará todos os tipos de resultado

Realtime omite um tipo solicitado que não foi habilitado, enquanto a Push-Pull /results endpoint o retorna com uma string content vazia. content string.

Endpoint da Realtime API:

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

Endpoint da Push-Pull API:

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

Exemplo de saída

A API retornará todos os tipos solicitados juntos em um único results[] array. A ordem das entradas não é fixa (Realtime e Push-Pull as retornam em ordens diferentes):

{
    "results": [
        {
            "content": {
                "url": "https://www.amazon.com/dp/B07FZ8S74R?language=en_US",
                "asin": "B07FZ8S74R",
                "title": "Echo Dot (3rd Gen, 2018 release) - Smart speaker with Alexa - Charcoal",
                "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## Skip to...",
            "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": {...}
}