Primeros pasos

Aprende a usar Oxylabs Custom Parser. En esta página encontrarás ejemplos completos, consejos y detalles sobre lo que sucede si falla el análisis.

Cómo usar Custom Parser

Ejemplo de escenario

Extrae el precio del primer producto publicado en un sitio de comercio electrónico, https://sandbox.oxylabs.io/products?q=super+mario:

Hay tres formas de crear un parser. Esta página recorre la más rápida, OxyCopilot, y las otras dos se tratan en sus propias páginas:

• Genera analizadores con OxyCopilot
• Genera analizadores mediante API
• Escribe instrucciones de análisis manualmente

Genera analizadores con OxyCopilot

OxyCopilot te permite describir tus necesidades en inglés sencillo para crear automáticamente raspadores y analizadores para un sitio web. Aprende los conceptos básicos siguiendo los pasos descritos a continuación y consulta la documentación de OxyCopilot para más información.

Abre el Web Scraper API Playground en nuestro panel para acceder a OxyCopilot.

1

Introduce la(s) URL(s)

Haz clic en el botón de OxyCopilot en la parte superior izquierda e introduce hasta 3 URL del mismo tipo de página y haz clic en Siguiente. Usemos esta URL de sandbox: https://sandbox.oxylabs.io/products?q=super+mario.

También puedes configurar el raspador manualmente rellenando los Sitio web, Raspador, y URL campos de la parte superior, y ajustando parámetros adicionales como el renderizado de JavaScript en el menú de la izquierda.

2

Configura los parámetros del raspador

A continuación, especifica los parámetros del raspador, las instrucciones del navegador y activa el renderizado de JavaScript si tu sitio web objetivo lo requiere.

La página de sandbox no necesita renderizado de JavaScript, así que deja los valores predeterminados y haz clic en Siguiente.

El renderizado importa cuando los datos que quieres no están en el HTML que envía el servidor, sino que JavaScript los añade después de que carga la página, como ocurre a menudo con precios, listados de productos y reseñas. Sin renderizado, Custom Parser solo ve el HTML inicial, así que las instrucciones que apuntan a esos datos no devuelven nada. Lee más sobre renderizado de JavaScript.

3

Escribe el prompt

Explica los datos que quieres extraer de una página. Asegúrate de ser descriptivo y proporcionar la información más importante. Puedes encontrar ejemplos de prompts para sitios web populares en nuestra biblioteca de prompts de OxyCopilot.

Pega el siguiente prompt para extraer el precio del primer producto:

Analiza el precio del primer producto en la página.

Haz clic en el Genera instrucciones botón para enviar tu prompt.

4

Revisa los datos analizados y las instrucciones

Cuando OxyCopilot termine, verás la siguiente ventana, donde los datos analizados están a la derecha:

Si quieres hacer algún ajuste, puedes hacerlo aquí. Modifica la(s) URL(s), ajusta el prompt, activa el renderizado de JavaScript o edita el esquema de análisis para adaptarlo a tus necesidades. Cuando actualices cualquier campo en esta ventana, puedes volver a ejecutar la solicitud seleccionando Iniciar nueva solicitud.

También puedes ver y editar directamente las instrucciones de análisis aquí:

Cuando estés satisfecho con el resultado, Cargar instrucciones para continuar.

5

Guardar el analizador como un preset

Puedes guardar fácilmente tus instrucciones de análisis como un preset de analizador. Esto te permite reutilizar el preset en OxyCopilot y con tus solicitudes de API.

En el Web Scraper API Playground, puedes elegir opcionalmente el usuario para el que guardar el preset. Cuando todo esté listo, simplemente haz clic en Guardar:

Aparecerá una ventana emergente que te pedirá que nombres el preset y añadas una descripción opcional:

6

Usa el preset con solicitudes de API

Para usar un preset con tus solicitudes de Web Scraper API, establece parse a true y especifica el nombre del preset con el parámetro parser_preset parameter.

Punto de conexión: POST https://realtime.oxylabs.io/v1/queries

{
    "source": "universal",
    "url": "https://sandbox.oxylabs.io/products",
    "parse": true,
    "parser_preset": "sandbox_first_product_price"
}

Al ejecutar la solicitud, obtendrás la siguiente salida JSON:

{
    "results": [
        {
            "_request": {...},
            "_response": {...},
            "content": {
                "parse_status_code": 12000,
                "price": 91.99
            },
            "created_at": "2026-09-08 11:21:03",
            "is_render_forced": false,
            "job_id": "7503049765014236161",
            "page": 1,
            "parser_preset": "sandbox_first_product_price",
            "parser_type": "preset",
            "session_info": {...},
            "status_code": 200,
            "type": "parsed",
            "updated_at": "2026-09-08 11:21:09",
            "url": "https://sandbox.oxylabs.io/products"
        }
    ]
}

Uso avanzado

OxyCopilot es la forma más rápida de crear un parser, pero cada paso también está disponible directamente a través de la API:

• Genera instrucciones de análisis mediante API – envía un prompt o un esquema JSON junto con algunas URL de ejemplo y recibe instrucciones listas para usar. Consulta Generación de instrucciones de análisis mediante API.
• Guarda y gestiona presets mediante API – crea, actualiza, lista y elimina presets de analizador, y activa la autorreparación. Consulta Presets de analizador.
• Escribe instrucciones de análisis manualmente – construye tu propio flujo de extracción con XPath y selectores CSS. Empieza con Cómo escribir instrucciones de análisis, luego explora los Ejemplos de instrucciones de análisis.

Qué pasa si el análisis falla al usar Custom Parser

Si Custom Parser no puede aplicar una de tus instrucciones, el trabajo sigue teniendo éxito: el resultado lleva parse_status_code 12005 (analizado con advertencias) y una _warnings lista que describe qué instrucción falló y por qué. Se te cobra por esos resultados.

Por ejemplo, esta solicitud pide un campo cuyo XPath no coincide con nada en la página:

{
    "source": "universal",
    "url": "https://sandbox.oxylabs.io/products",
    "parse": true,
    "parsing_instructions": {
        "first_product_price": {
            "_fns": [
                {
                    "_fn": "xpath_one",
                    "_args": [
                        "//div[contains(@class, 'price-wrapper')]/text()"
                    ]
                },
                {
                    "_fn": "amount_from_string"
                }
            ]
        },
        "number_of_reviews": {
            "_fns": [
                {
                    "_fn": "xpath",
                    "_args": [
                        "//this-will-not-match-anything"
                    ]
                },
                {
                    "_fn": "length"
                }
            ]
        }
    }
}

El precio se analiza normalmente, el campo que falla se devuelve como null, con una advertencia:

{
    "results": [
        {
            "_request": {...},
            "_response": {...},
            "content": {
                "_warnings": [
                    {
                        "_fn": "xpath",
                        "_fn_idx": 0,
                        "_msg": "XPath expressions did not match any data.",
                        "_path": ".number_of_reviews"
                    }
                ],
                "first_product_price": 91.99,
                "number_of_reviews": null,
                "parse_status_code": 12005
            },
            "created_at": "2026-09-08 09:00:40",
            "is_render_forced": false,
            "job_id": "7503014433245923329",
            "page": 1,
            "parser_preset": null,
            "parser_type": "custom",
            "session_info": {...},
            "status_code": 200,
            "type": "parsed",
            "updated_at": "2026-09-08 09:00:44",
            "url": "https://sandbox.oxylabs.io/products"
        }
    ]
}

Para ignorar un campo que falla en lugar de recibir una advertencia, consulta Ejemplos de instrucciones de análisis › Manejo de errores.

Si Custom Parser encuentra una excepción y falla durante la operación de análisis, puede devolver códigos de estado 12002, 12006, y 12007. No se te cobrará por estos errores inesperados.

Las instrucciones que hacen referencia a una función inexistente se rechazan al enviarlas y no se crea ningún trabajo. La API devuelve un error HTTP 400 que indica la función que falta y su ruta: function not_a_real_fn no está definida.

Códigos de estado

Consulta nuestros códigos de estado detallados aquí.