> 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/api-reference/es/scrapers-dedicados/scrapers-de-comercio.md).

# Scrapers de comercio

Referencia de los endpoints scraper de comercio de la Web API: Amazon, Walmart, Target, las marcas de Kroger y más. Parámetros y modos de entrega para cada endpoint.

Usa la barra de búsqueda de la tabla para encontrar un scraper de comercio dedicado y haz clic en un objetivo para ir a sus endpoints.

<table><thead><tr><th width="170.5">Scraper</th><th>Puntos de conexión</th></tr></thead><tbody><tr><td><a href="#alibaba">Alibaba</a></td><td><code>/alibaba</code>, <code>/alibaba/product</code>, <code>/alibaba/search</code></td></tr><tr><td><a href="#aliexpress">AliExpress</a></td><td><code>/aliexpress</code>, <code>/aliexpress/product</code>, <code>/aliexpress/search</code></td></tr><tr><td><a href="#allegro">Allegro</a></td><td><code>/allegro/product</code>, <code>/allegro/search</code></td></tr><tr><td><a href="#amazon">Amazon</a></td><td><code>/amazon</code>, <code>/amazon/bestsellers</code>, <code>/amazon/pricing</code>, <code>/amazon/product</code>, <code>/amazon/search</code>, <code>/amazon/sellers</code></td></tr><tr><td><a href="#bakers-plus">Baker's Plus</a></td><td><code>/bakersplus</code>, <code>/bakersplus/product</code>, <code>/bakersplus/search</code></td></tr><tr><td><a href="#bed-bath-and-beyond">Bed Bath &#x26; Beyond</a></td><td><code>/bedbathandbeyond</code>, <code>/bedbathandbeyond/product</code>, <code>/bedbathandbeyond/search</code></td></tr><tr><td><a href="#best-buy">Best Buy</a></td><td><code>/bestbuy</code>, <code>/bestbuy/product</code>, <code>/bestbuy/search</code></td></tr><tr><td><a href="#bodega-aurrera">Bodega Aurrera</a></td><td><code>/bodegaaurrera</code>, <code>/bodegaaurrera/product</code>, <code>/bodegaaurrera/search</code></td></tr><tr><td><a href="#cdiscount">Cdiscount</a></td><td><code>/cdiscount</code>, <code>/cdiscount/product</code>, <code>/cdiscount/search</code></td></tr><tr><td><a href="#city-market">City Market</a></td><td><code>/citymarket</code>, <code>/citymarket/product</code>, <code>/citymarket/search</code></td></tr><tr><td><a href="#costco">Costco</a></td><td><code>/costco</code>, <code>/costco/product</code>, <code>/costco/search</code></td></tr><tr><td><a href="#dcard">Dcard</a></td><td><code>/dcard/search</code></td></tr><tr><td><a href="#dillons">Dillons</a></td><td><code>/dillons</code>, <code>/dillons/product</code>, <code>/dillons/search</code></td></tr><tr><td><a href="#ebay">eBay</a></td><td><code>/ebay</code>, <code>/ebay/product</code>, <code>/ebay/search</code></td></tr><tr><td><a href="#etsy">Etsy</a></td><td><code>/etsy</code>, <code>/etsy/product</code>, <code>/etsy/search</code></td></tr><tr><td><a href="#falabella">Falabella</a></td><td><code>/falabella</code>, <code>/falabella/product</code>, <code>/falabella/search</code></td></tr><tr><td><a href="#flipkart">Flipkart</a></td><td><code>/flipkart</code>, <code>/flipkart/product</code>, <code>/flipkart/search</code></td></tr><tr><td><a href="#food-4-less">Food 4 Less</a></td><td><code>/foodfourless</code>, <code>/foodfourless/product</code>, <code>/foodfourless/search</code></td></tr><tr><td><a href="#fred-meyer">Fred Meyer</a></td><td><code>/fredmeyer</code>, <code>/fredmeyer/product</code>, <code>/fredmeyer/search</code></td></tr><tr><td><a href="#frys-food">Fry's Food</a></td><td><code>/frysfood</code>, <code>/frysfood/product</code>, <code>/frysfood/search</code></td></tr><tr><td><a href="#gerbes">Gerbes</a></td><td><code>/gerbes</code>, <code>/gerbes/product</code>, <code>/gerbes/search</code></td></tr><tr><td><a href="#grainger">Grainger</a></td><td><code>/grainger</code>, <code>/grainger/product</code>, <code>/grainger/search</code></td></tr><tr><td><a href="#harris-teeter">Harris Teeter</a></td><td><code>/harristeeter</code>, <code>/harristeeter/product</code>, <code>/harristeeter/search</code></td></tr><tr><td><a href="#idealo">Idealo</a></td><td><code>/idealo/search</code></td></tr><tr><td><a href="#indiamart">Indiamart</a></td><td><code>/indiamart</code>, <code>/indiamart/product</code>, <code>/indiamart/search</code></td></tr><tr><td><a href="#instacart">Instacart</a></td><td><code>/instacart</code>, <code>/instacart/product</code>, <code>/instacart/search</code></td></tr><tr><td><a href="#king-soopers">King Soopers</a></td><td><code>/kingsoopers</code>, <code>/kingsoopers/product</code>, <code>/kingsoopers/search</code></td></tr><tr><td><a href="#kroger">Kroger</a></td><td><code>/kroger</code>, <code>/kroger/product</code>, <code>/kroger/search</code></td></tr><tr><td><a href="#lazada">Lazada</a></td><td><code>/lazada</code>, <code>/lazada/product</code>, <code>/lazada/search</code></td></tr><tr><td><a href="#lowes">Lowe's</a></td><td><code>/lowes</code>, <code>/lowes/product</code>, <code>/lowes/search</code></td></tr><tr><td><a href="#magazine-luiza">Magazine Luiza</a></td><td><code>/magazineluiza</code>, <code>/magazineluiza/product</code>, <code>/magazineluiza/search</code></td></tr><tr><td><a href="#marianos">Mariano's</a></td><td><code>/marianos</code>, <code>/marianos/product</code>, <code>/marianos/search</code></td></tr><tr><td><a href="#mediamarkt">MediaMarkt</a></td><td><code>/mediamarkt</code>, <code>/mediamarkt/product</code>, <code>/mediamarkt/search</code></td></tr><tr><td><a href="#menards">Menards</a></td><td><code>/menards</code>, <code>/menards/product</code>, <code>/menards/search</code></td></tr><tr><td><a href="#mercado-libre">Mercado Libre</a></td><td><code>/mercadolibre</code>, <code>/mercadolibre/product</code>, <code>/mercadolibre/search</code></td></tr><tr><td><a href="#mercado-livre">Mercado Livre</a></td><td><code>/mercadolivre/product</code>, <code>/mercadolivre/search</code></td></tr><tr><td><a href="#metro-market">Metro Market</a></td><td><code>/metromarket</code>, <code>/metromarket/product</code>, <code>/metromarket/search</code></td></tr><tr><td><a href="#neobits">Neobits</a></td><td><code>/neobits/search</code></td></tr><tr><td><a href="#petco">Petco</a></td><td><code>/petco</code>, <code>/petco/search</code></td></tr><tr><td><a href="#pick-n-save">Pick 'n Save</a></td><td><code>/picknsave</code>, <code>/picknsave/product</code>, <code>/picknsave/search</code></td></tr><tr><td><a href="#publix">Publix</a></td><td><code>/publix</code>, <code>/publix/product</code>, <code>/publix/search</code></td></tr><tr><td><a href="#qfc">QFC</a></td><td><code>/qfc</code>, <code>/qfc/product</code>, <code>/qfc/search</code></td></tr><tr><td><a href="#rakuten">Rakuten</a></td><td><code>/rakuten</code>, <code>/rakuten/search</code></td></tr><tr><td><a href="#ralphs">Ralphs</a></td><td><code>/ralphs</code>, <code>/ralphs/product</code>, <code>/ralphs/search</code></td></tr><tr><td><a href="#safeway">Safeway</a></td><td><code>/safeway/product</code>, <code>/safeway/search</code>, <code>/safeway/category</code></td></tr><tr><td><a href="#smiths">Smith's</a></td><td><code>/smithsfoodanddrug</code>, <code>/smithsfoodanddrug/product</code>, <code>/smithsfoodanddrug/search</code></td></tr><tr><td><a href="#target">Target</a></td><td><code>/target</code>, <code>/target/category</code>, <code>/target/product</code>, <code>/target/search</code></td></tr><tr><td><a href="#tiktok-shop">TikTok Shop</a></td><td><code>/tiktok</code>, <code>/tiktok/shop/product</code>, <code>/tiktok/shop/search</code></td></tr><tr><td><a href="#walmart">Walmart</a></td><td><code>/walmart</code>, <code>/walmart/product</code>, <code>/walmart/search</code></td></tr></tbody></table>

### Alibaba

#### `POST /v1/scrape/alibaba`

Devuelve los campos analizados de una página de Alibaba a partir de una URL que proporciones.

**Modos:** `sincrónico`, `asíncrono`

<table><thead><tr><th width="144.5">Nombre</th><th width="92.5">Tipo</th><th width="88">Requerido</th><th>Descripción</th></tr></thead><tbody><tr><td><code>url</code></td><td>cadena</td><td>sí</td><td>Una URL de producto o búsqueda de Alibaba</td></tr><tr><td><code>output</code></td><td>arreglo de cadenas</td><td>no</td><td>Formatos a devolver: <code>Markdown</code>, <code>HTML</code>, <code>json</code>, <code>screenshot</code>. por defecto <code>["html"]</code>. <code>json</code> devuelve los campos analizados. <code>screenshot</code> requiere <code>run_js: true</code></td></tr><tr><td><code>json</code></td><td>objeto</td><td>no</td><td>Extracción personalizada: <code>{"prompt": string}</code> o <code>{"schema": object}</code>, nunca ambos. Anula el analizador integrado</td></tr><tr><td><code>location</code></td><td>cadena</td><td>no</td><td>Código de país de dos letras para obtener, por ejemplo <code>DE</code></td></tr><tr><td><code>device</code></td><td>cadena</td><td>no</td><td><code>escritorio</code> (predeterminado) o <code>móvil</code></td></tr><tr><td><code>run_js</code></td><td>booleano</td><td>no</td><td>Ejecuta el JavaScript de la página antes de capturarla. Más lento. Usa un tiempo de espera del cliente de 150 segundos o más</td></tr><tr><td><code>callback_url</code></td><td>cadena</td><td>no</td><td>URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con <code>400</code></td></tr><tr><td><code>storage</code></td><td>objeto</td><td>no</td><td>Entrega el resultado a un bucket en lugar de la respuesta: <code>{"type": string, "url": string}</code>. <code>type</code> es <code>s3</code>, <code>s3_gzip</code>, <code>s3_compatible</code>, <code>gcs</code>, o <code>tos</code>. Solo asíncrono. <code>url</code> no se valida</td></tr></tbody></table>

#### `POST /v1/scrape/alibaba/product`

Devuelve el precio, el stock y los detalles de un producto de Alibaba.

**Modos:** `sincrónico`, `asíncrono`

<table><thead><tr><th width="143">Nombre</th><th width="89">Tipo</th><th width="84">Requerido</th><th>Descripción</th></tr></thead><tbody><tr><td><code>query</code></td><td>cadena</td><td>sí</td><td>ID del producto</td></tr><tr><td><code>domain</code></td><td>cadena</td><td>no</td><td>TLD de la tienda</td></tr><tr><td><code>output</code></td><td>arreglo de cadenas</td><td>no</td><td>Formatos a devolver: <code>Markdown</code>, <code>HTML</code>, <code>json</code>, <code>screenshot</code>. por defecto <code>["html"]</code>. <code>json</code> devuelve los campos analizados. <code>screenshot</code> requiere <code>run_js: true</code></td></tr><tr><td><code>json</code></td><td>objeto</td><td>no</td><td>Extracción personalizada: <code>{"prompt": string}</code> o <code>{"schema": object}</code>, nunca ambos. Anula el analizador integrado</td></tr><tr><td><code>location</code></td><td>cadena</td><td>no</td><td>Código de país de dos letras para obtener, por ejemplo <code>DE</code></td></tr><tr><td><code>device</code></td><td>cadena</td><td>no</td><td><code>escritorio</code> (predeterminado) o <code>móvil</code></td></tr><tr><td><code>run_js</code></td><td>booleano</td><td>no</td><td>Ejecuta el JavaScript de la página antes de capturarla. Más lento — usa un tiempo de espera del cliente de 150 segundos o más</td></tr><tr><td><code>callback_url</code></td><td>cadena</td><td>no</td><td>URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con <code>400</code></td></tr><tr><td><code>storage</code></td><td>objeto</td><td>no</td><td>Entrega el resultado a un bucket en lugar de la respuesta: <code>{"type": string, "url": string}</code>. <code>type</code> es <code>s3</code>, <code>s3_gzip</code>, <code>s3_compatible</code>, <code>gcs</code>, o <code>tos</code>. Solo asíncrono. <code>url</code> no se valida</td></tr></tbody></table>

#### `POST /v1/scrape/alibaba/search`

Devuelve los resultados de búsqueda de Alibaba para una palabra clave.

**Modos:** `sincrónico`, `asíncrono`

<table><thead><tr><th width="132">Nombre</th><th width="95">Tipo</th><th width="93">Requerido</th><th>Descripción</th></tr></thead><tbody><tr><td><code>query</code></td><td>cadena</td><td>sí</td><td>Palabra clave de búsqueda</td></tr><tr><td><code>domain</code></td><td>cadena</td><td>no</td><td>TLD de la tienda</td></tr><tr><td><code>start_page</code></td><td>entero</td><td>no</td><td>Primera página de resultados</td></tr><tr><td><code>output</code></td><td>arreglo de cadenas</td><td>no</td><td>Formatos a devolver: <code>Markdown</code>, <code>HTML</code>, <code>json</code>, <code>screenshot</code>. por defecto <code>["html"]</code>. <code>json</code> devuelve los campos analizados. <code>screenshot</code> requiere <code>run_js: true</code></td></tr><tr><td><code>json</code></td><td>objeto</td><td>no</td><td>Extracción personalizada: <code>{"prompt": string}</code> o <code>{"schema": object}</code>, nunca ambos. Anula el analizador integrado</td></tr><tr><td><code>location</code></td><td>cadena</td><td>no</td><td>Código de país de dos letras para obtener, por ejemplo <code>DE</code></td></tr><tr><td><code>device</code></td><td>cadena</td><td>no</td><td><code>escritorio</code> (predeterminado) o <code>móvil</code></td></tr><tr><td><code>run_js</code></td><td>booleano</td><td>no</td><td>Ejecuta el JavaScript de la página antes de capturarla. Más lento — usa un tiempo de espera del cliente de 150 segundos o más</td></tr><tr><td><code>callback_url</code></td><td>cadena</td><td>no</td><td>URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con <code>400</code></td></tr><tr><td><code>storage</code></td><td>objeto</td><td>no</td><td>Entrega el resultado a un bucket en lugar de la respuesta: <code>{"type": string, "url": string}</code>. <code>type</code> es <code>s3</code>, <code>s3_gzip</code>, <code>s3_compatible</code>, <code>gcs</code>, o <code>tos</code>. Solo asíncrono. <code>url</code> no se valida</td></tr></tbody></table>

### AliExpress

#### `POST /v1/scrape/aliexpress`

Devuelve los campos analizados de una página de AliExpress a partir de una URL que proporciones.

**Modos:** `sincrónico`, `asíncrono`

<table><thead><tr><th width="138">Nombre</th><th width="95">Tipo</th><th width="89">Requerido</th><th>Descripción</th></tr></thead><tbody><tr><td><code>url</code></td><td>cadena</td><td>sí</td><td>Una URL de producto o búsqueda de AliExpress</td></tr><tr><td><code>output</code></td><td>arreglo de cadenas</td><td>no</td><td>Formatos a devolver: <code>Markdown</code>, <code>HTML</code>, <code>json</code>, <code>screenshot</code>. por defecto <code>["html"]</code>. <code>json</code> devuelve los campos analizados. <code>screenshot</code> requiere <code>run_js: true</code></td></tr><tr><td><code>json</code></td><td>objeto</td><td>no</td><td>Extracción personalizada: <code>{"prompt": string}</code> o <code>{"schema": object}</code>, nunca ambos. Anula el analizador integrado</td></tr><tr><td><code>location</code></td><td>cadena</td><td>no</td><td>Código de país de dos letras para obtener, por ejemplo <code>DE</code></td></tr><tr><td><code>device</code></td><td>cadena</td><td>no</td><td><code>escritorio</code> (predeterminado) o <code>móvil</code></td></tr><tr><td><code>run_js</code></td><td>booleano</td><td>no</td><td>Ejecuta el JavaScript de la página antes de capturarla. Más lento — usa un tiempo de espera del cliente de 150 segundos o más</td></tr><tr><td><code>callback_url</code></td><td>cadena</td><td>no</td><td>URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con <code>400</code></td></tr><tr><td><code>storage</code></td><td>objeto</td><td>no</td><td>Entrega el resultado a un bucket en lugar de la respuesta: <code>{"type": string, "url": string}</code>. <code>type</code> es <code>s3</code>, <code>s3_gzip</code>, <code>s3_compatible</code>, <code>gcs</code>, o <code>tos</code>. Solo asíncrono. <code>url</code> no se valida</td></tr></tbody></table>

#### `POST /v1/scrape/aliexpress/product`

Devuelve el precio, el stock y los detalles de un producto de AliExpress.

**Modos:** `sincrónico`, `asíncrono`

<table><thead><tr><th width="134">Nombre</th><th width="90">Tipo</th><th width="85">Requerido</th><th>Descripción</th></tr></thead><tbody><tr><td><code>query</code></td><td>cadena</td><td>sí</td><td>ID del producto</td></tr><tr><td><code>domain</code></td><td>cadena</td><td>no</td><td>TLD de la tienda</td></tr><tr><td><code>subdomain</code></td><td>cadena</td><td>no</td><td>Subdominio regional de la tienda</td></tr><tr><td><code>output</code></td><td>arreglo de cadenas</td><td>no</td><td>Formatos a devolver: <code>Markdown</code>, <code>HTML</code>, <code>json</code>, <code>screenshot</code>. por defecto <code>["html"]</code>. <code>json</code> devuelve los campos analizados. <code>screenshot</code> requiere <code>run_js: true</code></td></tr><tr><td><code>json</code></td><td>objeto</td><td>no</td><td>Extracción personalizada: <code>{"prompt": string}</code> o <code>{"schema": object}</code>, nunca ambos. Anula el analizador integrado</td></tr><tr><td><code>location</code></td><td>cadena</td><td>no</td><td>Código de país de dos letras para obtener, por ejemplo <code>DE</code></td></tr><tr><td><code>device</code></td><td>cadena</td><td>no</td><td><code>escritorio</code> (predeterminado) o <code>móvil</code></td></tr><tr><td><code>run_js</code></td><td>booleano</td><td>no</td><td>Ejecuta el JavaScript de la página antes de capturarla. Más lento — usa un tiempo de espera del cliente de 150 segundos o más</td></tr><tr><td><code>callback_url</code></td><td>cadena</td><td>no</td><td>URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con <code>400</code></td></tr><tr><td><code>storage</code></td><td>objeto</td><td>no</td><td>Entrega el resultado a un bucket en lugar de la respuesta: <code>{"type": string, "url": string}</code>. <code>type</code> es <code>s3</code>, <code>s3_gzip</code>, <code>s3_compatible</code>, <code>gcs</code>, o <code>tos</code>. Solo asíncrono. <code>url</code> no se valida</td></tr></tbody></table>

#### `POST /v1/scrape/aliexpress/search`

Devuelve los resultados de búsqueda de AliExpress para una palabra clave.

**Modos:** `sincrónico`, `asíncrono`

<table><thead><tr><th width="136">Nombre</th><th width="95">Tipo</th><th width="86">Requerido</th><th>Descripción</th></tr></thead><tbody><tr><td><code>query</code></td><td>cadena</td><td>sí</td><td>Palabra clave de búsqueda</td></tr><tr><td><code>domain</code></td><td>cadena</td><td>no</td><td>TLD de la tienda</td></tr><tr><td><code>start_page</code></td><td>entero</td><td>no</td><td>Primera página de resultados</td></tr><tr><td><code>output</code></td><td>arreglo de cadenas</td><td>no</td><td>Formatos a devolver: <code>Markdown</code>, <code>HTML</code>, <code>json</code>, <code>screenshot</code>. por defecto <code>["html"]</code>. <code>json</code> devuelve los campos analizados. <code>screenshot</code> requiere <code>run_js: true</code></td></tr><tr><td><code>json</code></td><td>objeto</td><td>no</td><td>Extracción personalizada: <code>{"prompt": string}</code> o <code>{"schema": object}</code>, nunca ambos. Anula el analizador integrado</td></tr><tr><td><code>location</code></td><td>cadena</td><td>no</td><td>Código de país de dos letras para obtener, por ejemplo <code>DE</code></td></tr><tr><td><code>device</code></td><td>cadena</td><td>no</td><td><code>escritorio</code> (predeterminado) o <code>móvil</code></td></tr><tr><td><code>run_js</code></td><td>booleano</td><td>no</td><td>Ejecuta el JavaScript de la página antes de capturarla. Más lento — usa un tiempo de espera del cliente de 150 segundos o más</td></tr><tr><td><code>callback_url</code></td><td>cadena</td><td>no</td><td>URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con <code>400</code></td></tr><tr><td><code>storage</code></td><td>objeto</td><td>no</td><td>Entrega el resultado a un bucket en lugar de la respuesta: <code>{"type": string, "url": string}</code>. <code>type</code> es <code>s3</code>, <code>s3_gzip</code>, <code>s3_compatible</code>, <code>gcs</code>, o <code>tos</code>. Solo asíncrono. <code>url</code> no se valida</td></tr></tbody></table>

### Allegro

#### `POST /v1/scrape/allegro/product`

Devuelve el precio, el stock y los detalles de un producto de Allegro.

**Modos:** `sincrónico`, `asíncrono`

<table><thead><tr><th width="139">Nombre</th><th width="92">Tipo</th><th width="83">Requerido</th><th>Descripción</th></tr></thead><tbody><tr><td><code>query</code></td><td>cadena</td><td>sí</td><td>ID del producto</td></tr><tr><td><code>output</code></td><td>arreglo de cadenas</td><td>no</td><td>Formatos a devolver: <code>Markdown</code>, <code>HTML</code>, <code>json</code>, <code>screenshot</code>. por defecto <code>["html"]</code>. <code>json</code> devuelve los campos analizados. <code>screenshot</code> requiere <code>run_js: true</code></td></tr><tr><td><code>json</code></td><td>objeto</td><td>no</td><td>Extracción personalizada: <code>{"prompt": string}</code> o <code>{"schema": object}</code>, nunca ambos. Anula el analizador integrado</td></tr><tr><td><code>location</code></td><td>cadena</td><td>no</td><td>Código de país de dos letras para obtener, por ejemplo <code>DE</code></td></tr><tr><td><code>device</code></td><td>cadena</td><td>no</td><td><code>escritorio</code> (predeterminado) o <code>móvil</code></td></tr><tr><td><code>run_js</code></td><td>booleano</td><td>no</td><td>Ejecuta el JavaScript de la página antes de capturarla. Más lento — usa un tiempo de espera del cliente de 150 segundos o más</td></tr><tr><td><code>callback_url</code></td><td>cadena</td><td>no</td><td>URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con <code>400</code></td></tr><tr><td><code>storage</code></td><td>objeto</td><td>no</td><td>Entrega el resultado a un bucket en lugar de la respuesta: <code>{"type": string, "url": string}</code>. <code>type</code> es <code>s3</code>, <code>s3_gzip</code>, <code>s3_compatible</code>, <code>gcs</code>, o <code>tos</code>. Solo asíncrono. <code>url</code> no se valida</td></tr></tbody></table>

#### `POST /v1/scrape/allegro/search`

Devuelve los resultados de búsqueda de Allegro para una palabra clave.

**Modos:** `sincrónico`, `asíncrono`

<table><thead><tr><th width="139">Nombre</th><th width="87">Tipo</th><th width="82">Requerido</th><th>Descripción</th></tr></thead><tbody><tr><td><code>query</code></td><td>cadena</td><td>sí</td><td>Palabra clave de búsqueda</td></tr><tr><td><code>delivery_time</code></td><td>cadena</td><td>no</td><td>Filtro por ventana de velocidad de entrega</td></tr><tr><td><code>domain</code></td><td>cadena</td><td>no</td><td>TLD de la tienda</td></tr><tr><td><code>shipping_from</code></td><td>cadena</td><td>no</td><td>País o región desde la que se envía el artículo</td></tr><tr><td><code>start_page</code></td><td>entero</td><td>no</td><td>Primera página de resultados</td></tr><tr><td><code>store_city</code></td><td>cadena</td><td>no</td><td>Ciudad del vendedor</td></tr><tr><td><code>store_region</code></td><td>cadena</td><td>no</td><td>Región del vendedor</td></tr><tr><td><code>output</code></td><td>arreglo de cadenas</td><td>no</td><td>Formatos a devolver: <code>Markdown</code>, <code>HTML</code>, <code>json</code>, <code>screenshot</code>. por defecto <code>["html"]</code>. <code>json</code> devuelve los campos analizados. <code>screenshot</code> requiere <code>run_js: true</code></td></tr><tr><td><code>json</code></td><td>objeto</td><td>no</td><td>Extracción personalizada: <code>{"prompt": string}</code> o <code>{"schema": object}</code>, nunca ambos. Anula el analizador integrado</td></tr><tr><td><code>location</code></td><td>cadena</td><td>no</td><td>Código de país de dos letras para obtener, por ejemplo <code>DE</code></td></tr><tr><td><code>device</code></td><td>cadena</td><td>no</td><td><code>escritorio</code> (predeterminado) o <code>móvil</code></td></tr><tr><td><code>run_js</code></td><td>booleano</td><td>no</td><td>Ejecuta el JavaScript de la página antes de capturarla. Más lento — usa un tiempo de espera del cliente de 150 segundos o más</td></tr><tr><td><code>callback_url</code></td><td>cadena</td><td>no</td><td>URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con <code>400</code></td></tr><tr><td><code>storage</code></td><td>objeto</td><td>no</td><td>Entrega el resultado a un bucket en lugar de la respuesta: <code>{"type": string, "url": string}</code>. <code>type</code> es <code>s3</code>, <code>s3_gzip</code>, <code>s3_compatible</code>, <code>gcs</code>, o <code>tos</code>. Solo asíncrono. <code>url</code> no se valida</td></tr></tbody></table>

### Amazon

#### `POST /v1/scrape/amazon`

Devuelve los campos analizados de una página de Amazon a partir de una URL que proporciones.

**Modos:** `sincrónico`, `asíncrono`, `por lotes`

<table><thead><tr><th width="177">Nombre</th><th width="98">Tipo</th><th width="82">Requerido</th><th>Descripción</th></tr></thead><tbody><tr><td><code>url</code></td><td>cadena</td><td>sí</td><td>Una URL de cualquier marketplace de Amazon. Envíala sin cambios — los parámetros de la cadena de consulta seleccionan la variante y el precio</td></tr><tr><td><code>autoselect_variant</code></td><td>booleano</td><td>no</td><td>Sigue la variante predeterminada del listado en lugar de devolver el listado padre sin formato. Usa esto cuando un ASIN padre no devuelva precio</td></tr><tr><td><code>category_id</code></td><td>cadena</td><td>no</td><td>Restringe a un nodo de navegación de Amazon</td></tr><tr><td><code>check_empty_geo</code></td><td>booleano</td><td>no</td><td>Hace fallar la solicitud en lugar de devolver contenido ignorado <code>location</code></td></tr><tr><td><code>condition</code></td><td>cadena</td><td>no</td><td>Condición de la oferta a devolver, p. ej. <code>usado</code></td></tr><tr><td><code>currency</code></td><td>cadena</td><td>no</td><td>Moneda en la que informar precios, p. ej. <code>EUR</code></td></tr><tr><td><code>locale</code></td><td>cadena</td><td>no</td><td>Idioma de la interfaz, p. ej. <code>en_US</code></td></tr><tr><td><code>max_price</code></td><td>entero</td><td>no</td><td>Precio máximo a incluir, en la moneda del marketplace</td></tr><tr><td><code>merchant_id</code></td><td>cadena</td><td>no</td><td>Restringe a los artículos de un solo vendedor</td></tr><tr><td><code>min_price</code></td><td>entero</td><td>no</td><td>Precio mínimo a incluir, en la moneda del marketplace</td></tr><tr><td><code>pages</code></td><td>entero</td><td>no</td><td>Páginas consecutivas desde las que obtener <code>start_page</code>. Cada página es una obtención y un cobro separados</td></tr><tr><td><code>refinamientos</code></td><td>arreglo de cadenas</td><td>no</td><td>Facetas de filtro de Amazon: marca, valoración, elegibilidad para Prime. Se reenvían tal cual; los valores difieren según el marketplace</td></tr><tr><td><code>safe_search</code></td><td>booleano</td><td>no</td><td>Filtro de contenido de Amazon</td></tr><tr><td><code>sort_by</code></td><td>cadena</td><td>no</td><td>Clave de ordenación propia de Amazon, p. ej. <code>price-asc-rank</code>, <code>review-rank</code>. Se reenvía tal cual; los valores difieren según el marketplace</td></tr><tr><td><code>start_page</code></td><td>entero</td><td>no</td><td>Primera página de resultados. Predeterminado <code>1</code></td></tr><tr><td><code>output</code></td><td>arreglo de cadenas</td><td>no</td><td>Formatos a devolver: <code>Markdown</code>, <code>HTML</code>, <code>json</code>, <code>screenshot</code>. por defecto <code>["html"]</code>. <code>json</code> devuelve los campos analizados. <code>screenshot</code> requiere <code>run_js: true</code></td></tr><tr><td><code>json</code></td><td>objeto</td><td>no</td><td>Extracción personalizada: <code>{"prompt": string}</code> o <code>{"schema": object}</code>, nunca ambos. Anula el analizador integrado</td></tr><tr><td><code>location</code></td><td>cadena</td><td>no</td><td>Código postal de entrega, p. ej. <code>10115</code>. Debe pertenecer al marketplace establecido por <code>domain</code></td></tr><tr><td><code>device</code></td><td>cadena</td><td>no</td><td><code>escritorio</code> (predeterminado) o <code>móvil</code></td></tr><tr><td><code>run_js</code></td><td>booleano</td><td>no</td><td>Ejecuta el JavaScript de la página antes de capturarla. Más lento — usa un tiempo de espera del cliente de 150 segundos o más</td></tr><tr><td><code>callback_url</code></td><td>cadena</td><td>no</td><td>URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con <code>400</code></td></tr><tr><td><code>storage</code></td><td>objeto</td><td>no</td><td>Entrega el resultado a un bucket en lugar de la respuesta: <code>{"type": string, "url": string}</code>. <code>type</code> es <code>s3</code>, <code>s3_gzip</code>, <code>s3_compatible</code>, <code>gcs</code>, o <code>tos</code>. Solo asíncrono. <code>url</code> no se valida</td></tr></tbody></table>

#### `POST /v1/scrape/amazon/bestsellers`

Devuelve el ranking de los más vendidos para una categoría.

**Modos:** `sincrónico`, `asíncrono`, `por lotes`

<table><thead><tr><th width="156">Nombre</th><th width="89">Tipo</th><th width="82">Requerido</th><th>Descripción</th></tr></thead><tbody><tr><td><code>query</code></td><td>cadena</td><td>sí</td><td>Categoría</td></tr><tr><td><code>category_id</code></td><td>cadena</td><td>no</td><td>Restringe a un nodo de navegación de Amazon</td></tr><tr><td><code>check_empty_geo</code></td><td>booleano</td><td>no</td><td>Hace fallar la solicitud en lugar de devolver contenido ignorado <code>location</code></td></tr><tr><td><code>currency</code></td><td>cadena</td><td>no</td><td>Moneda en la que informar precios, p. ej. <code>EUR</code></td></tr><tr><td><code>domain</code></td><td>cadena</td><td>no</td><td>TLD del marketplace: <code>com</code>, <code>de</code>, <code>co.uk</code>, <code>co.jp</code></td></tr><tr><td><code>locale</code></td><td>cadena</td><td>no</td><td>Idioma de la interfaz, p. ej. <code>en_US</code></td></tr><tr><td><code>pages</code></td><td>entero</td><td>no</td><td>Páginas consecutivas desde las que obtener <code>start_page</code>. Cada página es una obtención y un cobro separados</td></tr><tr><td><code>safe_search</code></td><td>booleano</td><td>no</td><td>Filtro de contenido de Amazon</td></tr><tr><td><code>start_page</code></td><td>entero</td><td>no</td><td>Primera página de resultados. Predeterminado <code>1</code></td></tr><tr><td><code>output</code></td><td>arreglo de cadenas</td><td>no</td><td>Formatos a devolver: <code>Markdown</code>, <code>HTML</code>, <code>json</code>, <code>screenshot</code>. por defecto <code>["html"]</code>. <code>json</code> devuelve los campos analizados. <code>screenshot</code> requiere <code>run_js: true</code></td></tr><tr><td><code>json</code></td><td>objeto</td><td>no</td><td>Extracción personalizada: <code>{"prompt": string}</code> o <code>{"schema": object}</code>, nunca ambos. Anula el analizador integrado</td></tr><tr><td><code>location</code></td><td>cadena</td><td>no</td><td>Código postal de entrega, p. ej. <code>10115</code>. Debe pertenecer al marketplace establecido por <code>domain</code></td></tr><tr><td><code>device</code></td><td>cadena</td><td>no</td><td><code>escritorio</code> (predeterminado) o <code>móvil</code></td></tr><tr><td><code>run_js</code></td><td>booleano</td><td>no</td><td>Ejecuta el JavaScript de la página antes de capturarla. Más lento — usa un tiempo de espera del cliente de 150 segundos o más</td></tr><tr><td><code>callback_url</code></td><td>cadena</td><td>no</td><td>URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con <code>400</code></td></tr><tr><td><code>storage</code></td><td>objeto</td><td>no</td><td>Entrega el resultado a un bucket en lugar de la respuesta: <code>{"type": string, "url": string}</code>. <code>type</code> es <code>s3</code>, <code>s3_gzip</code>, <code>s3_compatible</code>, <code>gcs</code>, o <code>tos</code>. Solo asíncrono. <code>url</code> no se valida</td></tr></tbody></table>

#### `POST /v1/scrape/amazon/pricing`

Devuelve todas las ofertas de un listado: todos los vendedores y condiciones.

**Modos:** `sincrónico`, `asíncrono`, `por lotes`

<table><thead><tr><th width="155">Nombre</th><th width="94">Tipo</th><th width="83">Requerido</th><th>Descripción</th></tr></thead><tbody><tr><td><code>query</code></td><td>cadena</td><td>sí</td><td>ASIN cuyas ofertas devolver</td></tr><tr><td><code>check_empty_geo</code></td><td>booleano</td><td>no</td><td>Hace fallar la solicitud en lugar de devolver contenido ignorado <code>location</code></td></tr><tr><td><code>condition</code></td><td>cadena</td><td>no</td><td>Condición de la oferta a devolver, p. ej. <code>usado</code></td></tr><tr><td><code>currency</code></td><td>cadena</td><td>no</td><td>Moneda en la que informar precios, p. ej. <code>EUR</code></td></tr><tr><td><code>domain</code></td><td>cadena</td><td>no</td><td>TLD del marketplace: <code>com</code>, <code>de</code>, <code>co.uk</code>, <code>co.jp</code></td></tr><tr><td><code>locale</code></td><td>cadena</td><td>no</td><td>Idioma de la interfaz, p. ej. <code>en_US</code></td></tr><tr><td><code>pages</code></td><td>entero</td><td>no</td><td>Páginas consecutivas desde las que obtener <code>start_page</code>. Cada página es una obtención y un cobro separados</td></tr><tr><td><code>safe_search</code></td><td>booleano</td><td>no</td><td>Filtro de contenido de Amazon</td></tr><tr><td><code>start_page</code></td><td>entero</td><td>no</td><td>Primera página de resultados. Predeterminado <code>1</code></td></tr><tr><td><code>output</code></td><td>arreglo de cadenas</td><td>no</td><td>Formatos a devolver: <code>Markdown</code>, <code>HTML</code>, <code>json</code>, <code>screenshot</code>. por defecto <code>["html"]</code>. <code>json</code> devuelve los campos analizados. <code>screenshot</code> requiere <code>run_js: true</code></td></tr><tr><td><code>json</code></td><td>objeto</td><td>no</td><td>Extracción personalizada: <code>{"prompt": string}</code> o <code>{"schema": object}</code>, nunca ambos. Anula el analizador integrado</td></tr><tr><td><code>location</code></td><td>cadena</td><td>no</td><td>Código postal de entrega, p. ej. <code>10115</code>. Debe pertenecer al marketplace establecido por <code>domain</code></td></tr><tr><td><code>device</code></td><td>cadena</td><td>no</td><td><code>escritorio</code> (predeterminado) o <code>móvil</code></td></tr><tr><td><code>run_js</code></td><td>booleano</td><td>no</td><td>Ejecuta el JavaScript de la página antes de capturarla. Más lento — usa un tiempo de espera del cliente de 150 segundos o más</td></tr><tr><td><code>callback_url</code></td><td>cadena</td><td>no</td><td>URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con <code>400</code></td></tr><tr><td><code>storage</code></td><td>objeto</td><td>no</td><td>Entrega el resultado a un bucket en lugar de la respuesta: <code>{"type": string, "url": string}</code>. <code>type</code> es <code>s3</code>, <code>s3_gzip</code>, <code>s3_compatible</code>, <code>gcs</code>, o <code>tos</code>. Solo asíncrono. <code>url</code> no se valida</td></tr></tbody></table>

#### `POST /v1/scrape/amazon/product`

Devuelve el título, precio, disponibilidad, valoración, imágenes y variantes de un producto de Amazon.

**Modos:** `sincrónico`, `asíncrono`, `por lotes`

<table><thead><tr><th width="183">Nombre</th><th width="92">Tipo</th><th width="84">Requerido</th><th>Descripción</th></tr></thead><tbody><tr><td><code>query</code></td><td>cadena</td><td>sí</td><td>ASIN, p. ej. <code>B0935DN1BN</code>. No es una URL ni un título</td></tr><tr><td><code>autoselect_variant</code></td><td>booleano</td><td>no</td><td>Sigue la variante predeterminada del listado en lugar de devolver el listado padre sin formato. Usa esto cuando un ASIN padre no devuelva precio</td></tr><tr><td><code>check_empty_geo</code></td><td>booleano</td><td>no</td><td>Hace fallar la solicitud en lugar de devolver contenido ignorado <code>location</code></td></tr><tr><td><code>currency</code></td><td>cadena</td><td>no</td><td>Moneda en la que informar precios, p. ej. <code>EUR</code></td></tr><tr><td><code>domain</code></td><td>cadena</td><td>no</td><td>TLD del marketplace: <code>com</code>, <code>de</code>, <code>co.uk</code>, <code>co.jp</code></td></tr><tr><td><code>locale</code></td><td>cadena</td><td>no</td><td>Idioma de la interfaz, p. ej. <code>en_US</code></td></tr><tr><td><code>safe_search</code></td><td>booleano</td><td>no</td><td>Filtro de contenido de Amazon</td></tr><tr><td><code>output</code></td><td>arreglo de cadenas</td><td>no</td><td>Formatos a devolver: <code>Markdown</code>, <code>HTML</code>, <code>json</code>, <code>screenshot</code>. por defecto <code>["html"]</code>. <code>json</code> devuelve los campos analizados. <code>screenshot</code> requiere <code>run_js: true</code></td></tr><tr><td><code>json</code></td><td>objeto</td><td>no</td><td>Extracción personalizada: <code>{"prompt": string}</code> o <code>{"schema": object}</code>, nunca ambos. Anula el analizador integrado</td></tr><tr><td><code>location</code></td><td>cadena</td><td>no</td><td>Código postal de entrega, p. ej. <code>10115</code>. Debe pertenecer al marketplace establecido por <code>domain</code></td></tr><tr><td><code>device</code></td><td>cadena</td><td>no</td><td><code>escritorio</code> (predeterminado) o <code>móvil</code></td></tr><tr><td><code>run_js</code></td><td>booleano</td><td>no</td><td>Ejecuta el JavaScript de la página antes de capturarla. Más lento — usa un tiempo de espera del cliente de 150 segundos o más</td></tr><tr><td><code>callback_url</code></td><td>cadena</td><td>no</td><td>URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con <code>400</code></td></tr><tr><td><code>storage</code></td><td>objeto</td><td>no</td><td>Entrega el resultado a un bucket en lugar de la respuesta: <code>{"type": string, "url": string}</code>. <code>type</code> es <code>s3</code>, <code>s3_gzip</code>, <code>s3_compatible</code>, <code>gcs</code>, o <code>tos</code>. Solo asíncrono. <code>url</code> no se valida</td></tr></tbody></table>

#### `POST /v1/scrape/amazon/search`

Devuelve los resultados de búsqueda de Amazon, con los anuncios pagados marcados.

**Modos:** `sincrónico`, `asíncrono`, `por lotes`

<table><thead><tr><th width="156">Nombre</th><th width="91">Tipo</th><th width="90">Requerido</th><th>Descripción</th></tr></thead><tbody><tr><td><code>query</code></td><td>cadena</td><td>sí</td><td>Palabra clave de búsqueda</td></tr><tr><td><code>category_id</code></td><td>cadena</td><td>no</td><td>Restringe a un nodo de navegación de Amazon</td></tr><tr><td><code>check_empty_geo</code></td><td>booleano</td><td>no</td><td>Hace fallar la solicitud en lugar de devolver contenido ignorado <code>location</code></td></tr><tr><td><code>currency</code></td><td>cadena</td><td>no</td><td>Moneda en la que informar precios, p. ej. <code>EUR</code></td></tr><tr><td><code>domain</code></td><td>cadena</td><td>no</td><td>TLD del marketplace: <code>com</code>, <code>de</code>, <code>co.uk</code>, <code>co.jp</code></td></tr><tr><td><code>locale</code></td><td>cadena</td><td>no</td><td>Idioma de la interfaz, p. ej. <code>en_US</code></td></tr><tr><td><code>max_price</code></td><td>entero</td><td>no</td><td>Precio máximo a incluir, en la moneda del marketplace</td></tr><tr><td><code>merchant_id</code></td><td>cadena</td><td>no</td><td>Restringe a los artículos de un solo vendedor</td></tr><tr><td><code>min_price</code></td><td>entero</td><td>no</td><td>Precio mínimo a incluir, en la moneda del marketplace</td></tr><tr><td><code>pages</code></td><td>entero</td><td>no</td><td>Páginas consecutivas desde las que obtener <code>start_page</code>. Cada página es una obtención y un cobro separados</td></tr><tr><td><code>refinamientos</code></td><td>arreglo de cadenas</td><td>no</td><td>Facetas de filtro de Amazon: marca, valoración, elegibilidad para Prime. Se reenvían tal cual; los valores difieren según el marketplace</td></tr><tr><td><code>safe_search</code></td><td>booleano</td><td>no</td><td>Filtro de contenido de Amazon</td></tr><tr><td><code>sort_by</code></td><td>cadena</td><td>no</td><td>Clave de ordenación propia de Amazon, p. ej. <code>price-asc-rank</code>, <code>review-rank</code>. Se reenvía tal cual; los valores difieren según el marketplace</td></tr><tr><td><code>start_page</code></td><td>entero</td><td>no</td><td>Primera página de resultados. Predeterminado <code>1</code></td></tr><tr><td><code>output</code></td><td>arreglo de cadenas</td><td>no</td><td>Formatos a devolver: <code>Markdown</code>, <code>HTML</code>, <code>json</code>, <code>screenshot</code>. por defecto <code>["html"]</code>. <code>json</code> devuelve los campos analizados. <code>screenshot</code> requiere <code>run_js: true</code></td></tr><tr><td><code>json</code></td><td>objeto</td><td>no</td><td>Extracción personalizada: <code>{"prompt": string}</code> o <code>{"schema": object}</code>, nunca ambos. Anula el analizador integrado</td></tr><tr><td><code>location</code></td><td>cadena</td><td>no</td><td>Código postal de entrega, p. ej. <code>10115</code>. Debe pertenecer al marketplace establecido por <code>domain</code></td></tr><tr><td><code>device</code></td><td>cadena</td><td>no</td><td><code>escritorio</code> (predeterminado) o <code>móvil</code></td></tr><tr><td><code>run_js</code></td><td>booleano</td><td>no</td><td>Ejecuta el JavaScript de la página antes de capturarla. Más lento — usa un tiempo de espera del cliente de 150 segundos o más</td></tr><tr><td><code>callback_url</code></td><td>cadena</td><td>no</td><td>URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con <code>400</code></td></tr><tr><td><code>storage</code></td><td>objeto</td><td>no</td><td>Entrega el resultado a un bucket en lugar de la respuesta: <code>{"type": string, "url": string}</code>. <code>type</code> es <code>s3</code>, <code>s3_gzip</code>, <code>s3_compatible</code>, <code>gcs</code>, o <code>tos</code>. Solo asíncrono. <code>url</code> no se valida</td></tr></tbody></table>

#### `POST /v1/scrape/amazon/sellers`

Devuelve la tienda del vendedor.

**Modos:** `sincrónico`, `asíncrono`, `por lotes`

<table><thead><tr><th width="158">Nombre</th><th width="92">Tipo</th><th width="83">Requerido</th><th>Descripción</th></tr></thead><tbody><tr><td><code>query</code></td><td>cadena</td><td>sí</td><td>ID del vendedor</td></tr><tr><td><code>check_empty_geo</code></td><td>booleano</td><td>no</td><td>Hace fallar la solicitud en lugar de devolver contenido ignorado <code>location</code></td></tr><tr><td><code>currency</code></td><td>cadena</td><td>no</td><td>Moneda en la que informar precios, p. ej. <code>EUR</code></td></tr><tr><td><code>domain</code></td><td>cadena</td><td>no</td><td>TLD del marketplace: <code>com</code>, <code>de</code>, <code>co.uk</code>, <code>co.jp</code></td></tr><tr><td><code>locale</code></td><td>cadena</td><td>no</td><td>Idioma de la interfaz, p. ej. <code>en_US</code></td></tr><tr><td><code>safe_search</code></td><td>booleano</td><td>no</td><td>Filtro de contenido de Amazon</td></tr><tr><td><code>output</code></td><td>arreglo de cadenas</td><td>no</td><td>Formatos a devolver: <code>Markdown</code>, <code>HTML</code>, <code>json</code>, <code>screenshot</code>. por defecto <code>["html"]</code>. <code>json</code> devuelve los campos analizados. <code>screenshot</code> requiere <code>run_js: true</code></td></tr><tr><td><code>json</code></td><td>objeto</td><td>no</td><td>Extracción personalizada: <code>{"prompt": string}</code> o <code>{"schema": object}</code>, nunca ambos. Anula el analizador integrado</td></tr><tr><td><code>location</code></td><td>cadena</td><td>no</td><td>Código postal de entrega, p. ej. <code>10115</code>. Debe pertenecer al marketplace establecido por <code>domain</code></td></tr><tr><td><code>device</code></td><td>cadena</td><td>no</td><td><code>escritorio</code> (predeterminado) o <code>móvil</code></td></tr><tr><td><code>run_js</code></td><td>booleano</td><td>no</td><td>Ejecuta el JavaScript de la página antes de capturarla. Más lento — usa un tiempo de espera del cliente de 150 segundos o más</td></tr><tr><td><code>callback_url</code></td><td>cadena</td><td>no</td><td>URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con <code>400</code></td></tr><tr><td><code>storage</code></td><td>objeto</td><td>no</td><td>Entrega el resultado a un bucket en lugar de la respuesta: <code>{"type": string, "url": string}</code>. <code>type</code> es <code>s3</code>, <code>s3_gzip</code>, <code>s3_compatible</code>, <code>gcs</code>, o <code>tos</code>. Solo asíncrono. <code>url</code> no se valida</td></tr></tbody></table>

### Baker's Plus

#### `POST /v1/scrape/bakersplus`

Devuelve los campos analizados de una página de Baker's Plus a partir de una URL que proporciones.

**Modos:** `sincrónico`, `asíncrono`

<table><thead><tr><th width="167">Nombre</th><th width="87">Tipo</th><th width="84">Requerido</th><th>Descripción</th></tr></thead><tbody><tr><td><code>url</code></td><td>cadena</td><td>sí</td><td>Una URL de producto o búsqueda de Baker's Plus</td></tr><tr><td><code>delivery_zip</code></td><td>cadena</td><td>no</td><td>La entrega al código postal se cotiza para</td></tr><tr><td><code>fulfillment_type</code></td><td>cadena</td><td>no</td><td>Filtro de entrega, recogida o envío a domicilio</td></tr><tr><td><code>store_id</code></td><td>cadena</td><td>no</td><td>La tienda cuyo catálogo y precios se devuelven</td></tr><tr><td><code>output</code></td><td>arreglo de cadenas</td><td>no</td><td>Formatos a devolver: <code>Markdown</code>, <code>HTML</code>, <code>json</code>, <code>screenshot</code>. por defecto <code>["html"]</code>. <code>json</code> devuelve los campos analizados. <code>screenshot</code> requiere <code>run_js: true</code></td></tr><tr><td><code>json</code></td><td>objeto</td><td>no</td><td>Extracción personalizada: <code>{"prompt": string}</code> o <code>{"schema": object}</code>, nunca ambos. Anula el analizador integrado</td></tr><tr><td><code>location</code></td><td>cadena</td><td>no</td><td>Código de país de dos letras para obtener, por ejemplo <code>DE</code></td></tr><tr><td><code>device</code></td><td>cadena</td><td>no</td><td><code>escritorio</code> (predeterminado) o <code>móvil</code></td></tr><tr><td><code>run_js</code></td><td>booleano</td><td>no</td><td>Ejecuta el JavaScript de la página antes de capturarla. Más lento — usa un tiempo de espera del cliente de 150 segundos o más</td></tr><tr><td><code>callback_url</code></td><td>cadena</td><td>no</td><td>URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con <code>400</code></td></tr><tr><td><code>storage</code></td><td>objeto</td><td>no</td><td>Entrega el resultado a un bucket en lugar de la respuesta: <code>{"type": string, "url": string}</code>. <code>type</code> es <code>s3</code>, <code>s3_gzip</code>, <code>s3_compatible</code>, <code>gcs</code>, o <code>tos</code>. Solo asíncrono. <code>url</code> no se valida</td></tr></tbody></table>

#### `POST /v1/scrape/bakersplus/product`

Devuelve el precio, el stock y los detalles de un producto de Baker's Plus.

**Modos:** `sincrónico`, `asíncrono`

<table><thead><tr><th width="164">Nombre</th><th width="87">Tipo</th><th width="83">Requerido</th><th>Descripción</th></tr></thead><tbody><tr><td><code>query</code></td><td>cadena</td><td>sí</td><td>ID del producto</td></tr><tr><td><code>delivery_zip</code></td><td>cadena</td><td>no</td><td>La entrega al código postal se cotiza para</td></tr><tr><td><code>fulfillment_type</code></td><td>cadena</td><td>no</td><td>Filtro de entrega, recogida o envío a domicilio</td></tr><tr><td><code>store_id</code></td><td>cadena</td><td>no</td><td>La tienda cuyo catálogo y precios se devuelven</td></tr><tr><td><code>output</code></td><td>arreglo de cadenas</td><td>no</td><td>Formatos a devolver: <code>Markdown</code>, <code>HTML</code>, <code>json</code>, <code>screenshot</code>. por defecto <code>["html"]</code>. <code>json</code> devuelve los campos analizados. <code>screenshot</code> requiere <code>run_js: true</code></td></tr><tr><td><code>json</code></td><td>objeto</td><td>no</td><td>Extracción personalizada: <code>{"prompt": string}</code> o <code>{"schema": object}</code>, nunca ambos. Anula el analizador integrado</td></tr><tr><td><code>location</code></td><td>cadena</td><td>no</td><td>Código de país de dos letras para obtener, por ejemplo <code>DE</code></td></tr><tr><td><code>device</code></td><td>cadena</td><td>no</td><td><code>escritorio</code> (predeterminado) o <code>móvil</code></td></tr><tr><td><code>run_js</code></td><td>booleano</td><td>no</td><td>Ejecuta el JavaScript de la página antes de capturarla. Más lento — usa un tiempo de espera del cliente de 150 segundos o más</td></tr><tr><td><code>callback_url</code></td><td>cadena</td><td>no</td><td>URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con <code>400</code></td></tr><tr><td><code>storage</code></td><td>objeto</td><td>no</td><td>Entrega el resultado a un bucket en lugar de la respuesta: <code>{"type": string, "url": string}</code>. <code>type</code> es <code>s3</code>, <code>s3_gzip</code>, <code>s3_compatible</code>, <code>gcs</code>, o <code>tos</code>. Solo asíncrono. <code>url</code> no se valida</td></tr></tbody></table>

#### `POST /v1/scrape/bakersplus/search`

Devuelve los resultados de búsqueda de Baker's Plus para una palabra clave.

**Modos:** `sincrónico`, `asíncrono`

<table><thead><tr><th width="167">Nombre</th><th width="88">Tipo</th><th width="83">Requerido</th><th>Descripción</th></tr></thead><tbody><tr><td><code>query</code></td><td>cadena</td><td>sí</td><td>Palabra clave de búsqueda</td></tr><tr><td><code>brand</code></td><td>cadena</td><td>no</td><td>Restringe los resultados a una marca</td></tr><tr><td><code>delivery_zip</code></td><td>cadena</td><td>no</td><td>La entrega al código postal se cotiza para</td></tr><tr><td><code>fulfillment_type</code></td><td>cadena</td><td>no</td><td>Filtro de entrega, recogida o envío a domicilio</td></tr><tr><td><code>price_range</code></td><td>cadena</td><td>no</td><td>Filtro de banda de precios</td></tr><tr><td><code>store_id</code></td><td>cadena</td><td>no</td><td>La tienda cuyo catálogo y precios se devuelven</td></tr><tr><td><code>output</code></td><td>arreglo de cadenas</td><td>no</td><td>Formatos a devolver: <code>Markdown</code>, <code>HTML</code>, <code>json</code>, <code>screenshot</code>. por defecto <code>["html"]</code>. <code>json</code> devuelve los campos analizados. <code>screenshot</code> requiere <code>run_js: true</code></td></tr><tr><td><code>json</code></td><td>objeto</td><td>no</td><td>Extracción personalizada: <code>{"prompt": string}</code> o <code>{"schema": object}</code>, nunca ambos. Anula el analizador integrado</td></tr><tr><td><code>location</code></td><td>cadena</td><td>no</td><td>Código de país de dos letras para obtener, por ejemplo <code>DE</code></td></tr><tr><td><code>device</code></td><td>cadena</td><td>no</td><td><code>escritorio</code> (predeterminado) o <code>móvil</code></td></tr><tr><td><code>run_js</code></td><td>booleano</td><td>no</td><td>Ejecuta el JavaScript de la página antes de capturarla. Más lento — usa un tiempo de espera del cliente de 150 segundos o más</td></tr><tr><td><code>callback_url</code></td><td>cadena</td><td>no</td><td>URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con <code>400</code></td></tr><tr><td><code>storage</code></td><td>objeto</td><td>no</td><td>Entrega el resultado a un bucket en lugar de la respuesta: <code>{"type": string, "url": string}</code>. <code>type</code> es <code>s3</code>, <code>s3_gzip</code>, <code>s3_compatible</code>, <code>gcs</code>, o <code>tos</code>. Solo asíncrono. <code>url</code> no se valida</td></tr></tbody></table>

### Bed Bath and Beyond

#### `POST /v1/scrape/bedbathandbeyond`

Devuelve una página de Bed Bath & Beyond a partir de una URL que proporciones.

**Modos:** `sincrónico`, `asíncrono`

<table><thead><tr><th width="133">Nombre</th><th width="86">Tipo</th><th width="83">Requerido</th><th>Descripción</th></tr></thead><tbody><tr><td><code>url</code></td><td>cadena</td><td>sí</td><td>Una URL de producto o búsqueda de Bed Bath &#x26; Beyond</td></tr><tr><td><code>output</code></td><td>arreglo de cadenas</td><td>no</td><td>Formatos a devolver: <code>Markdown</code>, <code>HTML</code>, <code>json</code>, <code>screenshot</code>. por defecto <code>["html"]</code>. <code>json</code> devuelve los campos analizados. <code>screenshot</code> requiere <code>run_js: true</code></td></tr><tr><td><code>json</code></td><td>objeto</td><td>no</td><td>Extracción personalizada: <code>{"prompt": string}</code> o <code>{"schema": object}</code>, nunca ambas.</td></tr><tr><td><code>location</code></td><td>cadena</td><td>no</td><td>Código de país de dos letras para obtener, por ejemplo <code>DE</code></td></tr><tr><td><code>device</code></td><td>cadena</td><td>no</td><td><code>escritorio</code> (predeterminado) o <code>móvil</code></td></tr><tr><td><code>run_js</code></td><td>booleano</td><td>no</td><td>Ejecuta el JavaScript de la página antes de capturarla. Más lento — usa un tiempo de espera del cliente de 150 segundos o más</td></tr><tr><td><code>callback_url</code></td><td>cadena</td><td>no</td><td>URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con <code>400</code></td></tr><tr><td><code>storage</code></td><td>objeto</td><td>no</td><td>Entrega el resultado a un bucket en lugar de la respuesta: <code>{"type": string, "url": string}</code>. <code>type</code> es <code>s3</code>, <code>s3_gzip</code>, <code>s3_compatible</code>, <code>gcs</code>, o <code>tos</code>. Solo asíncrono. <code>url</code> no se valida</td></tr></tbody></table>

#### `POST /v1/scrape/bedbathandbeyond/product`

Devuelve el precio, el stock y los detalles de un producto de Bed Bath & Beyond.

{% hint style="success" %}
**Para obtener datos JSON estructurados del producto con el analizador dedicado**, envía la URL de la página del producto (que termine en `/<product_id>/product.html`) a [`POST /v1/scrape`](/api-reference/es/endpoints-principales.md#post-v1-scrape) con `output: ["json"]`. No `json` se necesita prompt ni esquema.
{% endhint %}

**Modos:** `sincrónico`, `asíncrono`

<table><thead><tr><th width="133">Nombre</th><th width="92">Tipo</th><th width="82">Requerido</th><th>Descripción</th></tr></thead><tbody><tr><td><code>query</code></td><td>cadena</td><td>sí</td><td>ID del producto</td></tr><tr><td><code>domain</code></td><td>cadena</td><td>no</td><td>TLD de la tienda</td></tr><tr><td><code>output</code></td><td>arreglo de cadenas</td><td>no</td><td>Formatos a devolver: <code>Markdown</code>, <code>HTML</code>, <code>json</code>, <code>screenshot</code>. por defecto <code>["html"]</code>. <code>json</code> devuelve los campos analizados. <code>screenshot</code> requiere <code>run_js: true</code></td></tr><tr><td><code>json</code></td><td>objeto</td><td>no</td><td>Extracción personalizada: <code>{"prompt": string}</code> o <code>{"schema": object}</code>, nunca ambas.</td></tr><tr><td><code>location</code></td><td>cadena</td><td>no</td><td>Código de país de dos letras para obtener, por ejemplo <code>DE</code></td></tr><tr><td><code>device</code></td><td>cadena</td><td>no</td><td><code>escritorio</code> (predeterminado) o <code>móvil</code></td></tr><tr><td><code>run_js</code></td><td>booleano</td><td>no</td><td>Ejecuta el JavaScript de la página antes de capturarla. Más lento — usa un tiempo de espera del cliente de 150 segundos o más</td></tr><tr><td><code>callback_url</code></td><td>cadena</td><td>no</td><td>URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con <code>400</code></td></tr><tr><td><code>storage</code></td><td>objeto</td><td>no</td><td>Entrega el resultado a un bucket en lugar de la respuesta: <code>{"type": string, "url": string}</code>. <code>type</code> es <code>s3</code>, <code>s3_gzip</code>, <code>s3_compatible</code>, <code>gcs</code>, o <code>tos</code>. Solo asíncrono. <code>url</code> no se valida</td></tr></tbody></table>

#### `POST /v1/scrape/bedbathandbeyond/search`

Devuelve los resultados de búsqueda de Bed Bath & Beyond para una palabra clave.

**Modos:** `sincrónico`, `asíncrono`

<table><thead><tr><th width="135">Nombre</th><th width="88">Tipo</th><th width="84">Requerido</th><th>Descripción</th></tr></thead><tbody><tr><td><code>query</code></td><td>cadena</td><td>sí</td><td>Palabra clave de búsqueda</td></tr><tr><td><code>domain</code></td><td>cadena</td><td>no</td><td>TLD de la tienda</td></tr><tr><td><code>start_page</code></td><td>entero</td><td>no</td><td>Primera página de resultados</td></tr><tr><td><code>output</code></td><td>arreglo de cadenas</td><td>no</td><td>Formatos a devolver: <code>Markdown</code>, <code>HTML</code>, <code>json</code>, <code>screenshot</code>. por defecto <code>["html"]</code>. <code>json</code> devuelve los campos analizados. <code>screenshot</code> requiere <code>run_js: true</code></td></tr><tr><td><code>json</code></td><td>objeto</td><td>no</td><td>Extracción personalizada: <code>{"prompt": string}</code> o <code>{"schema": object}</code>, nunca ambas.</td></tr><tr><td><code>location</code></td><td>cadena</td><td>no</td><td>Código de país de dos letras para obtener, por ejemplo <code>DE</code></td></tr><tr><td><code>device</code></td><td>cadena</td><td>no</td><td><code>escritorio</code> (predeterminado) o <code>móvil</code></td></tr><tr><td><code>run_js</code></td><td>booleano</td><td>no</td><td>Ejecuta el JavaScript de la página antes de capturarla. Más lento — usa un tiempo de espera del cliente de 150 segundos o más</td></tr><tr><td><code>callback_url</code></td><td>cadena</td><td>no</td><td>URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con <code>400</code></td></tr><tr><td><code>storage</code></td><td>objeto</td><td>no</td><td>Entrega el resultado a un bucket en lugar de la respuesta: <code>{"type": string, "url": string}</code>. <code>type</code> es <code>s3</code>, <code>s3_gzip</code>, <code>s3_compatible</code>, <code>gcs</code>, o <code>tos</code>. Solo asíncrono. <code>url</code> no se valida</td></tr></tbody></table>

### Best Buy

#### `POST /v1/scrape/bestbuy`

Devuelve los campos analizados de una página de Best Buy a partir de una URL que proporciones.

**Modos:** `sincrónico`, `asíncrono`

<table><thead><tr><th width="131">Nombre</th><th width="91">Tipo</th><th width="85">Requerido</th><th>Descripción</th></tr></thead><tbody><tr><td><code>url</code></td><td>cadena</td><td>sí</td><td>Una URL de producto o búsqueda de Best Buy</td></tr><tr><td><code>delivery_zip</code></td><td>cadena</td><td>no</td><td>La entrega al código postal se cotiza para</td></tr><tr><td><code>store_id</code></td><td>cadena</td><td>no</td><td>La tienda cuyo catálogo y precios se devuelven</td></tr><tr><td><code>output</code></td><td>arreglo de cadenas</td><td>no</td><td>Formatos a devolver: <code>Markdown</code>, <code>HTML</code>, <code>json</code>, <code>screenshot</code>. por defecto <code>["html"]</code>. <code>json</code> devuelve los campos analizados. <code>screenshot</code> requiere <code>run_js: true</code></td></tr><tr><td><code>json</code></td><td>objeto</td><td>no</td><td>Extracción personalizada: <code>{"prompt": string}</code> o <code>{"schema": object}</code>, nunca ambos. Anula el analizador integrado</td></tr><tr><td><code>location</code></td><td>cadena</td><td>no</td><td>Código de país de dos letras para obtener, por ejemplo <code>DE</code></td></tr><tr><td><code>device</code></td><td>cadena</td><td>no</td><td><code>escritorio</code> (predeterminado) o <code>móvil</code></td></tr><tr><td><code>run_js</code></td><td>booleano</td><td>no</td><td>Ejecuta el JavaScript de la página antes de capturarla. Más lento — usa un tiempo de espera del cliente de 150 segundos o más</td></tr><tr><td><code>callback_url</code></td><td>cadena</td><td>no</td><td>URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con <code>400</code></td></tr><tr><td><code>storage</code></td><td>objeto</td><td>no</td><td>Entrega el resultado a un bucket en lugar de la respuesta: <code>{"type": string, "url": string}</code>. <code>type</code> es <code>s3</code>, <code>s3_gzip</code>, <code>s3_compatible</code>, <code>gcs</code>, o <code>tos</code>. Solo asíncrono. <code>url</code> no se valida</td></tr></tbody></table>

#### `POST /v1/scrape/bestbuy/product`

Devuelve el precio, el stock y los detalles de un producto de Best Buy.

**Modos:** `sincrónico`, `asíncrono`

<table><thead><tr><th width="132">Nombre</th><th width="90">Tipo</th><th width="85">Requerido</th><th>Descripción</th></tr></thead><tbody><tr><td><code>query</code></td><td>cadena</td><td>sí</td><td>ID del producto</td></tr><tr><td><code>delivery_zip</code></td><td>cadena</td><td>no</td><td>La entrega al código postal se cotiza para</td></tr><tr><td><code>domain</code></td><td>cadena</td><td>no</td><td>TLD de la tienda</td></tr><tr><td><code>store_id</code></td><td>cadena</td><td>no</td><td>La tienda cuyo catálogo y precios se devuelven</td></tr><tr><td><code>output</code></td><td>arreglo de cadenas</td><td>no</td><td>Formatos a devolver: <code>Markdown</code>, <code>HTML</code>, <code>json</code>, <code>screenshot</code>. por defecto <code>["html"]</code>. <code>json</code> devuelve los campos analizados. <code>screenshot</code> requiere <code>run_js: true</code></td></tr><tr><td><code>json</code></td><td>objeto</td><td>no</td><td>Extracción personalizada: <code>{"prompt": string}</code> o <code>{"schema": object}</code>, nunca ambos. Anula el analizador integrado</td></tr><tr><td><code>location</code></td><td>cadena</td><td>no</td><td>Código de país de dos letras para obtener, por ejemplo <code>DE</code></td></tr><tr><td><code>device</code></td><td>cadena</td><td>no</td><td><code>escritorio</code> (predeterminado) o <code>móvil</code></td></tr><tr><td><code>run_js</code></td><td>booleano</td><td>no</td><td>Ejecuta el JavaScript de la página antes de capturarla. Más lento — usa un tiempo de espera del cliente de 150 segundos o más</td></tr><tr><td><code>callback_url</code></td><td>cadena</td><td>no</td><td>URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con <code>400</code></td></tr><tr><td><code>storage</code></td><td>objeto</td><td>no</td><td>Entrega el resultado a un bucket en lugar de la respuesta: <code>{"type": string, "url": string}</code>. <code>type</code> es <code>s3</code>, <code>s3_gzip</code>, <code>s3_compatible</code>, <code>gcs</code>, o <code>tos</code>. Solo asíncrono. <code>url</code> no se valida</td></tr></tbody></table>

#### `POST /v1/scrape/bestbuy/search`

Devuelve los resultados de búsqueda de Best Buy para una palabra clave.

**Modos:** `sincrónico`, `asíncrono`

<table><thead><tr><th width="165">Nombre</th><th width="89">Tipo</th><th width="88">Requerido</th><th>Descripción</th></tr></thead><tbody><tr><td><code>query</code></td><td>cadena</td><td>sí</td><td>Palabra clave de búsqueda</td></tr><tr><td><code>delivery_zip</code></td><td>cadena</td><td>no</td><td>La entrega al código postal se cotiza para</td></tr><tr><td><code>domain</code></td><td>cadena</td><td>no</td><td>TLD de la tienda</td></tr><tr><td><code>fulfillment_type</code></td><td>cadena</td><td>no</td><td>Filtro de entrega, recogida o envío a domicilio</td></tr><tr><td><code>start_page</code></td><td>entero</td><td>no</td><td>Primera página de resultados</td></tr><tr><td><code>store_id</code></td><td>cadena</td><td>no</td><td>La tienda cuyo catálogo y precios se devuelven</td></tr><tr><td><code>output</code></td><td>arreglo de cadenas</td><td>no</td><td>Formatos a devolver: <code>Markdown</code>, <code>HTML</code>, <code>json</code>, <code>screenshot</code>. por defecto <code>["html"]</code>. <code>json</code> devuelve los campos analizados. <code>screenshot</code> requiere <code>run_js: true</code></td></tr><tr><td><code>json</code></td><td>objeto</td><td>no</td><td>Extracción personalizada: <code>{"prompt": string}</code> o <code>{"schema": object}</code>, nunca ambos. Anula el analizador integrado</td></tr><tr><td><code>location</code></td><td>cadena</td><td>no</td><td>Código de país de dos letras para obtener, por ejemplo <code>DE</code></td></tr><tr><td><code>device</code></td><td>cadena</td><td>no</td><td><code>escritorio</code> (predeterminado) o <code>móvil</code></td></tr><tr><td><code>run_js</code></td><td>booleano</td><td>no</td><td>Ejecuta el JavaScript de la página antes de capturarla. Más lento — usa un tiempo de espera del cliente de 150 segundos o más</td></tr><tr><td><code>callback_url</code></td><td>cadena</td><td>no</td><td>URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con <code>400</code></td></tr><tr><td><code>storage</code></td><td>objeto</td><td>no</td><td>Entrega el resultado a un bucket en lugar de la respuesta: <code>{"type": string, "url": string}</code>. <code>type</code> es <code>s3</code>, <code>s3_gzip</code>, <code>s3_compatible</code>, <code>gcs</code>, o <code>tos</code>. Solo asíncrono. <code>url</code> no se valida</td></tr></tbody></table>

### Bodega Aurrera

#### `POST /v1/scrape/bodegaaurrera`

Devuelve los campos analizados de una página de Bodega Aurrera a partir de una URL que proporciones.

**Modos:** `sincrónico`, `asíncrono`

<table><thead><tr><th width="137">Nombre</th><th width="86">Tipo</th><th width="82">Requerido</th><th>Descripción</th></tr></thead><tbody><tr><td><code>url</code></td><td>cadena</td><td>sí</td><td>Una URL de producto o búsqueda de Bodega Aurrera</td></tr><tr><td><code>delivery_zip</code></td><td>cadena</td><td>no</td><td>La entrega al código postal se cotiza para</td></tr><tr><td><code>store_id</code></td><td>cadena</td><td>no</td><td>La tienda cuyo catálogo y precios se devuelven</td></tr><tr><td><code>output</code></td><td>arreglo de cadenas</td><td>no</td><td>Formatos a devolver: <code>Markdown</code>, <code>HTML</code>, <code>json</code>, <code>screenshot</code>. por defecto <code>["html"]</code>. <code>json</code> devuelve los campos analizados. <code>screenshot</code> requiere <code>run_js: true</code></td></tr><tr><td><code>json</code></td><td>objeto</td><td>no</td><td>Extracción personalizada: <code>{"prompt": string}</code> o <code>{"schema": object}</code>, nunca ambos. Anula el analizador integrado</td></tr><tr><td><code>location</code></td><td>cadena</td><td>no</td><td>Código de país de dos letras para obtener, por ejemplo <code>DE</code></td></tr><tr><td><code>device</code></td><td>cadena</td><td>no</td><td><code>escritorio</code> (predeterminado) o <code>móvil</code></td></tr><tr><td><code>run_js</code></td><td>booleano</td><td>no</td><td>Ejecuta el JavaScript de la página antes de capturarla. Más lento — usa un tiempo de espera del cliente de 150 segundos o más</td></tr><tr><td><code>callback_url</code></td><td>cadena</td><td>no</td><td>URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con <code>400</code></td></tr><tr><td><code>storage</code></td><td>objeto</td><td>no</td><td>Entrega el resultado a un bucket en lugar de la respuesta: <code>{"type": string, "url": string}</code>. <code>type</code> es <code>s3</code>, <code>s3_gzip</code>, <code>s3_compatible</code>, <code>gcs</code>, o <code>tos</code>. Solo asíncrono. <code>url</code> no se valida</td></tr></tbody></table>

#### `POST /v1/scrape/bodegaaurrera/product`

Devuelve el precio, el stock y los detalles de un producto de Bodega Aurrera.

**Modos:** `sincrónico`, `asíncrono`

<table><thead><tr><th width="167">Nombre</th><th width="92">Tipo</th><th width="86">Requerido</th><th>Descripción</th></tr></thead><tbody><tr><td><code>query</code></td><td>cadena</td><td>sí</td><td>ID del producto</td></tr><tr><td><code>delivery_zip</code></td><td>cadena</td><td>no</td><td>La entrega al código postal se cotiza para</td></tr><tr><td><code>domain</code></td><td>cadena</td><td>no</td><td>TLD de la tienda</td></tr><tr><td><code>fulfillment_type</code></td><td>cadena</td><td>no</td><td>Filtro de entrega, recogida o envío a domicilio</td></tr><tr><td><code>store_id</code></td><td>cadena</td><td>no</td><td>La tienda cuyo catálogo y precios se devuelven</td></tr><tr><td><code>subdomain</code></td><td>cadena</td><td>no</td><td>Subdominio regional de la tienda</td></tr><tr><td><code>output</code></td><td>arreglo de cadenas</td><td>no</td><td>Formatos a devolver: <code>Markdown</code>, <code>HTML</code>, <code>json</code>, <code>screenshot</code>. por defecto <code>["html"]</code>. <code>json</code> devuelve los campos analizados. <code>screenshot</code> requiere <code>run_js: true</code></td></tr><tr><td><code>json</code></td><td>objeto</td><td>no</td><td>Extracción personalizada: <code>{"prompt": string}</code> o <code>{"schema": object}</code>, nunca ambos. Anula el analizador integrado</td></tr><tr><td><code>location</code></td><td>cadena</td><td>no</td><td>Código de país de dos letras para obtener, por ejemplo <code>DE</code></td></tr><tr><td><code>device</code></td><td>cadena</td><td>no</td><td><code>escritorio</code> (predeterminado) o <code>móvil</code></td></tr><tr><td><code>run_js</code></td><td>booleano</td><td>no</td><td>Ejecuta el JavaScript de la página antes de capturarla. Más lento — usa un tiempo de espera del cliente de 150 segundos o más</td></tr><tr><td><code>callback_url</code></td><td>cadena</td><td>no</td><td>URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con <code>400</code></td></tr><tr><td><code>storage</code></td><td>objeto</td><td>no</td><td>Entrega el resultado a un bucket en lugar de la respuesta: <code>{"type": string, "url": string}</code>. <code>type</code> es <code>s3</code>, <code>s3_gzip</code>, <code>s3_compatible</code>, <code>gcs</code>, o <code>tos</code>. Solo asíncrono. <code>url</code> no se valida</td></tr></tbody></table>

#### `POST /v1/scrape/bodegaaurrera/search`

Devuelve los resultados de búsqueda de Bodega Aurrera para una palabra clave.

**Modos:** `sincrónico`, `asíncrono`

<table><thead><tr><th width="170">Nombre</th><th width="97">Tipo</th><th width="82">Requerido</th><th>Descripción</th></tr></thead><tbody><tr><td><code>query</code></td><td>cadena</td><td>sí</td><td>Palabra clave de búsqueda</td></tr><tr><td><code>delivery_zip</code></td><td>cadena</td><td>no</td><td>La entrega al código postal se cotiza para</td></tr><tr><td><code>domain</code></td><td>cadena</td><td>no</td><td>TLD de la tienda</td></tr><tr><td><code>fulfillment_type</code></td><td>cadena</td><td>no</td><td>Filtro de entrega, recogida o envío a domicilio</td></tr><tr><td><code>store_id</code></td><td>cadena</td><td>no</td><td>La tienda cuyo catálogo y precios se devuelven</td></tr><tr><td><code>subdomain</code></td><td>cadena</td><td>no</td><td>Subdominio regional de la tienda</td></tr><tr><td><code>output</code></td><td>arreglo de cadenas</td><td>no</td><td>Formatos a devolver: <code>Markdown</code>, <code>HTML</code>, <code>json</code>, <code>screenshot</code>. por defecto <code>["html"]</code>. <code>json</code> devuelve los campos analizados. <code>screenshot</code> requiere <code>run_js: true</code></td></tr><tr><td><code>json</code></td><td>objeto</td><td>no</td><td>Extracción personalizada: <code>{"prompt": string}</code> o <code>{"schema": object}</code>, nunca ambos. Anula el analizador integrado</td></tr><tr><td><code>location</code></td><td>cadena</td><td>no</td><td>Código de país de dos letras para obtener, por ejemplo <code>DE</code></td></tr><tr><td><code>device</code></td><td>cadena</td><td>no</td><td><code>escritorio</code> (predeterminado) o <code>móvil</code></td></tr><tr><td><code>run_js</code></td><td>booleano</td><td>no</td><td>Ejecuta el JavaScript de la página antes de capturarla. Más lento — usa un tiempo de espera del cliente de 150 segundos o más</td></tr><tr><td><code>callback_url</code></td><td>cadena</td><td>no</td><td>URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con <code>400</code></td></tr><tr><td><code>storage</code></td><td>objeto</td><td>no</td><td>Entrega el resultado a un bucket en lugar de la respuesta: <code>{"type": string, "url": string}</code>. <code>type</code> es <code>s3</code>, <code>s3_gzip</code>, <code>s3_compatible</code>, <code>gcs</code>, o <code>tos</code>. Solo asíncrono. <code>url</code> no se valida</td></tr></tbody></table>

***

### Cdiscount

#### `POST /v1/scrape/cdiscount`

Devuelve los campos analizados de una página de Cdiscount a partir de una URL que proporciones.

**Modos:** sincrónico · asincrónico

<table><thead><tr><th width="134">Nombre</th><th width="93">Tipo</th><th width="83">Requerido</th><th>Descripción</th></tr></thead><tbody><tr><td><code>url</code></td><td>cadena</td><td>sí</td><td>Una URL de producto o búsqueda de Cdiscount</td></tr><tr><td><code>output</code></td><td>arreglo de cadenas</td><td>no</td><td>Formatos a devolver: <code>Markdown</code>, <code>HTML</code>, <code>json</code>, <code>screenshot</code>. por defecto <code>["html"]</code>. <code>json</code> devuelve los campos analizados. <code>screenshot</code> requiere <code>run_js: true</code></td></tr><tr><td><code>json</code></td><td>objeto</td><td>no</td><td>Extracción personalizada: <code>{"prompt": string}</code> o <code>{"schema": object}</code>, nunca ambos. Anula el analizador integrado</td></tr><tr><td><code>location</code></td><td>cadena</td><td>no</td><td>Código de país de dos letras para obtener, por ejemplo <code>DE</code></td></tr><tr><td><code>device</code></td><td>cadena</td><td>no</td><td><code>escritorio</code> (predeterminado) o <code>móvil</code></td></tr><tr><td><code>run_js</code></td><td>booleano</td><td>no</td><td>Ejecuta el JavaScript de la página antes de capturarla. Más lento — usa un tiempo de espera del cliente de 150 segundos o más</td></tr><tr><td><code>callback_url</code></td><td>cadena</td><td>no</td><td>URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con <code>400</code></td></tr><tr><td><code>storage</code></td><td>objeto</td><td>no</td><td>Entrega el resultado a un bucket en lugar de la respuesta: <code>{"type": string, "url": string}</code>. <code>type</code> es <code>s3</code>, <code>s3_gzip</code>, <code>s3_compatible</code>, <code>gcs</code>, o <code>tos</code>. Solo asíncrono. <code>url</code> no se valida</td></tr></tbody></table>

#### `POST /v1/scrape/cdiscount/product`

Devuelve el precio, el stock y los detalles de un producto de Cdiscount.

**Modos:** sincrónico · asincrónico

<table><thead><tr><th width="133">Nombre</th><th width="95">Tipo</th><th width="85">Requerido</th><th>Descripción</th></tr></thead><tbody><tr><td><code>query</code></td><td>cadena</td><td>sí</td><td>ID del producto</td></tr><tr><td><code>domain</code></td><td>cadena</td><td>no</td><td>TLD de la tienda</td></tr><tr><td><code>output</code></td><td>arreglo de cadenas</td><td>no</td><td>Formatos a devolver: <code>Markdown</code>, <code>HTML</code>, <code>json</code>, <code>screenshot</code>. por defecto <code>["html"]</code>. <code>json</code> devuelve los campos analizados. <code>screenshot</code> requiere <code>run_js: true</code></td></tr><tr><td><code>json</code></td><td>objeto</td><td>no</td><td>Extracción personalizada: <code>{"prompt": string}</code> o <code>{"schema": object}</code>, nunca ambos. Anula el analizador integrado</td></tr><tr><td><code>location</code></td><td>cadena</td><td>no</td><td>Código de país de dos letras para obtener, por ejemplo <code>DE</code></td></tr><tr><td><code>device</code></td><td>cadena</td><td>no</td><td><code>escritorio</code> (predeterminado) o <code>móvil</code></td></tr><tr><td><code>run_js</code></td><td>booleano</td><td>no</td><td>Ejecuta el JavaScript de la página antes de capturarla. Más lento — usa un tiempo de espera del cliente de 150 segundos o más</td></tr><tr><td><code>callback_url</code></td><td>cadena</td><td>no</td><td>URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con <code>400</code></td></tr><tr><td><code>storage</code></td><td>objeto</td><td>no</td><td>Entrega el resultado a un bucket en lugar de la respuesta: <code>{"type": string, "url": string}</code>. <code>type</code> es <code>s3</code>, <code>s3_gzip</code>, <code>s3_compatible</code>, <code>gcs</code>, o <code>tos</code>. Solo asíncrono. <code>url</code> no se valida</td></tr></tbody></table>

#### `POST /v1/scrape/cdiscount/search`

Devuelve los resultados de búsqueda de Cdiscount para una palabra clave.

**Modos:** sincrónico · asincrónico

<table><thead><tr><th width="132">Nombre</th><th width="86">Tipo</th><th width="88">Requerido</th><th>Descripción</th></tr></thead><tbody><tr><td><code>query</code></td><td>cadena</td><td>sí</td><td>Palabra clave de búsqueda</td></tr><tr><td><code>domain</code></td><td>cadena</td><td>no</td><td>TLD de la tienda</td></tr><tr><td><code>start_page</code></td><td>entero</td><td>no</td><td>Primera página de resultados</td></tr><tr><td><code>output</code></td><td>arreglo de cadenas</td><td>no</td><td>Formatos a devolver: <code>Markdown</code>, <code>HTML</code>, <code>json</code>, <code>screenshot</code>. por defecto <code>["html"]</code>. <code>json</code> devuelve los campos analizados. <code>screenshot</code> requiere <code>run_js: true</code></td></tr><tr><td><code>json</code></td><td>objeto</td><td>no</td><td>Extracción personalizada: <code>{"prompt": string}</code> o <code>{"schema": object}</code>, nunca ambos. Anula el analizador integrado</td></tr><tr><td><code>location</code></td><td>cadena</td><td>no</td><td>Código de país de dos letras para obtener, por ejemplo <code>DE</code></td></tr><tr><td><code>device</code></td><td>cadena</td><td>no</td><td><code>escritorio</code> (predeterminado) o <code>móvil</code></td></tr><tr><td><code>run_js</code></td><td>booleano</td><td>no</td><td>Ejecuta el JavaScript de la página antes de capturarla. Más lento — usa un tiempo de espera del cliente de 150 segundos o más</td></tr><tr><td><code>callback_url</code></td><td>cadena</td><td>no</td><td>URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con <code>400</code></td></tr><tr><td><code>storage</code></td><td>objeto</td><td>no</td><td>Entrega el resultado a un bucket en lugar de la respuesta: <code>{"type": string, "url": string}</code>. <code>type</code> es <code>s3</code>, <code>s3_gzip</code>, <code>s3_compatible</code>, <code>gcs</code>, o <code>tos</code>. Solo asíncrono. <code>url</code> no se valida</td></tr></tbody></table>

***

### City Market

#### `POST /v1/scrape/citymarket`

Devuelve los campos analizados de una página de City Market a partir de una URL que proporciones.

**Modos:** sincrónico · asincrónico

| Nombre             | Tipo               | Requerido | Descripción                                                                                                                                                                                  |
| ------------------ | ------------------ | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `url`              | cadena             | sí        | Una URL de producto o búsqueda de City Market                                                                                                                                                |
| `delivery_zip`     | cadena             | no        | La entrega al código postal se cotiza para                                                                                                                                                   |
| `fulfillment_type` | cadena             | no        | Filtro de entrega, recogida o envío a domicilio                                                                                                                                              |
| `store_id`         | cadena             | no        | La tienda cuyo catálogo y precios se devuelven                                                                                                                                               |
| `output`           | arreglo de cadenas | no        | Formatos a devolver: `Markdown`, `HTML`, `json`, `screenshot`. por defecto `["html"]`. `json` devuelve los campos analizados. `screenshot` requiere `run_js: true`                           |
| `json`             | objeto             | no        | Extracción personalizada: `{"prompt": string}` o `{"schema": object}`, nunca ambos. Anula el analizador integrado                                                                            |
| `location`         | cadena             | no        | Código de país de dos letras para obtener, por ejemplo `DE`                                                                                                                                  |
| `device`           | cadena             | no        | `escritorio` (predeterminado) o `móvil`                                                                                                                                                      |
| `run_js`           | booleano           | no        | Ejecuta el JavaScript de la página antes de capturarla. Más lento — usa un tiempo de espera del cliente de 150 segundos o más                                                                |
| `callback_url`     | cadena             | no        | URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con `400`                                                                                        |
| `storage`          | objeto             | no        | Entrega el resultado a un bucket en lugar de la respuesta: `{"type": string, "url": string}`. `type` es `s3`, `s3_gzip`, `s3_compatible`, `gcs`, o `tos`. Solo asíncrono. `url` no se valida |

#### `POST /v1/scrape/citymarket/product`

Devuelve el precio, el stock y los detalles de un producto de City Market.

**Modos:** sincrónico · asincrónico

| Nombre             | Tipo               | Requerido | Descripción                                                                                                                                                                                  |
| ------------------ | ------------------ | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`            | cadena             | sí        | ID del producto                                                                                                                                                                              |
| `delivery_zip`     | cadena             | no        | La entrega al código postal se cotiza para                                                                                                                                                   |
| `fulfillment_type` | cadena             | no        | Filtro de entrega, recogida o envío a domicilio                                                                                                                                              |
| `store_id`         | cadena             | no        | La tienda cuyo catálogo y precios se devuelven                                                                                                                                               |
| `output`           | arreglo de cadenas | no        | Formatos a devolver: `Markdown`, `HTML`, `json`, `screenshot`. por defecto `["html"]`. `json` devuelve los campos analizados. `screenshot` requiere `run_js: true`                           |
| `json`             | objeto             | no        | Extracción personalizada: `{"prompt": string}` o `{"schema": object}`, nunca ambos. Anula el analizador integrado                                                                            |
| `location`         | cadena             | no        | Código de país de dos letras para obtener, por ejemplo `DE`                                                                                                                                  |
| `device`           | cadena             | no        | `escritorio` (predeterminado) o `móvil`                                                                                                                                                      |
| `run_js`           | booleano           | no        | Ejecuta el JavaScript de la página antes de capturarla. Más lento — usa un tiempo de espera del cliente de 150 segundos o más                                                                |
| `callback_url`     | cadena             | no        | URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con `400`                                                                                        |
| `storage`          | objeto             | no        | Entrega el resultado a un bucket en lugar de la respuesta: `{"type": string, "url": string}`. `type` es `s3`, `s3_gzip`, `s3_compatible`, `gcs`, o `tos`. Solo asíncrono. `url` no se valida |

#### `POST /v1/scrape/citymarket/search`

Devuelve los resultados de búsqueda de City Market para una palabra clave.

**Modos:** sincrónico · asincrónico

| Nombre             | Tipo               | Requerido | Descripción                                                                                                                                                                                  |
| ------------------ | ------------------ | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`            | cadena             | sí        | Palabra clave de búsqueda                                                                                                                                                                    |
| `brand`            | cadena             | no        | Restringe los resultados a una marca                                                                                                                                                         |
| `delivery_zip`     | cadena             | no        | La entrega al código postal se cotiza para                                                                                                                                                   |
| `fulfillment_type` | cadena             | no        | Filtro de entrega, recogida o envío a domicilio                                                                                                                                              |
| `price_range`      | cadena             | no        | Filtro de banda de precios                                                                                                                                                                   |
| `store_id`         | cadena             | no        | La tienda cuyo catálogo y precios se devuelven                                                                                                                                               |
| `output`           | arreglo de cadenas | no        | Formatos a devolver: `Markdown`, `HTML`, `json`, `screenshot`. por defecto `["html"]`. `json` devuelve los campos analizados. `screenshot` requiere `run_js: true`                           |
| `json`             | objeto             | no        | Extracción personalizada: `{"prompt": string}` o `{"schema": object}`, nunca ambos. Anula el analizador integrado                                                                            |
| `location`         | cadena             | no        | Código de país de dos letras para obtener, por ejemplo `DE`                                                                                                                                  |
| `device`           | cadena             | no        | `escritorio` (predeterminado) o `móvil`                                                                                                                                                      |
| `run_js`           | booleano           | no        | Ejecuta el JavaScript de la página antes de capturarla. Más lento — usa un tiempo de espera del cliente de 150 segundos o más                                                                |
| `callback_url`     | cadena             | no        | URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con `400`                                                                                        |
| `storage`          | objeto             | no        | Entrega el resultado a un bucket en lugar de la respuesta: `{"type": string, "url": string}`. `type` es `s3`, `s3_gzip`, `s3_compatible`, `gcs`, o `tos`. Solo asíncrono. `url` no se valida |

***

### Costco

#### `POST /v1/scrape/costco`

Devuelve los campos analizados de una página de Costco a partir de una URL que proporciones.

**Modos:** sincrónico · asincrónico

| Nombre         | Tipo               | Requerido | Descripción                                                                                                                                                                                  |
| -------------- | ------------------ | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `url`          | cadena             | sí        | Una URL de producto o búsqueda de Costco                                                                                                                                                     |
| `output`       | arreglo de cadenas | no        | Formatos a devolver: `Markdown`, `HTML`, `json`, `screenshot`. por defecto `["html"]`. `json` devuelve los campos analizados. `screenshot` requiere `run_js: true`                           |
| `json`         | objeto             | no        | Extracción personalizada: `{"prompt": string}` o `{"schema": object}`, nunca ambos. Anula el analizador integrado                                                                            |
| `location`     | cadena             | no        | Código de país de dos letras para obtener, por ejemplo `DE`                                                                                                                                  |
| `device`       | cadena             | no        | `escritorio` (predeterminado) o `móvil`                                                                                                                                                      |
| `run_js`       | booleano           | no        | Ejecuta el JavaScript de la página antes de capturarla. Más lento — usa un tiempo de espera del cliente de 150 segundos o más                                                                |
| `callback_url` | cadena             | no        | URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con `400`                                                                                        |
| `storage`      | objeto             | no        | Entrega el resultado a un bucket en lugar de la respuesta: `{"type": string, "url": string}`. `type` es `s3`, `s3_gzip`, `s3_compatible`, `gcs`, o `tos`. Solo asíncrono. `url` no se valida |

#### `POST /v1/scrape/costco/product`

Devuelve el precio, el stock y los detalles de un producto de Costco.

**Modos:** sincrónico · asincrónico

| Nombre         | Tipo               | Requerido | Descripción                                                                                                                                                                                  |
| -------------- | ------------------ | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`        | cadena             | sí        | ID del producto                                                                                                                                                                              |
| `domain`       | cadena             | no        | TLD de la tienda                                                                                                                                                                             |
| `output`       | arreglo de cadenas | no        | Formatos a devolver: `Markdown`, `HTML`, `json`, `screenshot`. por defecto `["html"]`. `json` devuelve los campos analizados. `screenshot` requiere `run_js: true`                           |
| `json`         | objeto             | no        | Extracción personalizada: `{"prompt": string}` o `{"schema": object}`, nunca ambos. Anula el analizador integrado                                                                            |
| `location`     | cadena             | no        | Código de país de dos letras para obtener, por ejemplo `DE`                                                                                                                                  |
| `device`       | cadena             | no        | `escritorio` (predeterminado) o `móvil`                                                                                                                                                      |
| `run_js`       | booleano           | no        | Ejecuta el JavaScript de la página antes de capturarla. Más lento — usa un tiempo de espera del cliente de 150 segundos o más                                                                |
| `callback_url` | cadena             | no        | URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con `400`                                                                                        |
| `storage`      | objeto             | no        | Entrega el resultado a un bucket en lugar de la respuesta: `{"type": string, "url": string}`. `type` es `s3`, `s3_gzip`, `s3_compatible`, `gcs`, o `tos`. Solo asíncrono. `url` no se valida |

#### `POST /v1/scrape/costco/search`

Devuelve los resultados de búsqueda de Costco para una palabra clave.

**Modos:** sincrónico · asincrónico

| Nombre         | Tipo               | Requerido | Descripción                                                                                                                                                                                  |
| -------------- | ------------------ | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`        | cadena             | sí        | Palabra clave de búsqueda                                                                                                                                                                    |
| `domain`       | cadena             | no        | TLD de la tienda                                                                                                                                                                             |
| `start_page`   | entero             | no        | Primera página de resultados                                                                                                                                                                 |
| `output`       | arreglo de cadenas | no        | Formatos a devolver: `Markdown`, `HTML`, `json`, `screenshot`. por defecto `["html"]`. `json` devuelve los campos analizados. `screenshot` requiere `run_js: true`                           |
| `json`         | objeto             | no        | Extracción personalizada: `{"prompt": string}` o `{"schema": object}`, nunca ambos. Anula el analizador integrado                                                                            |
| `location`     | cadena             | no        | Código de país de dos letras para obtener, por ejemplo `DE`                                                                                                                                  |
| `device`       | cadena             | no        | `escritorio` (predeterminado) o `móvil`                                                                                                                                                      |
| `run_js`       | booleano           | no        | Ejecuta el JavaScript de la página antes de capturarla. Más lento — usa un tiempo de espera del cliente de 150 segundos o más                                                                |
| `callback_url` | cadena             | no        | URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con `400`                                                                                        |
| `storage`      | objeto             | no        | Entrega el resultado a un bucket en lugar de la respuesta: `{"type": string, "url": string}`. `type` es `s3`, `s3_gzip`, `s3_compatible`, `gcs`, o `tos`. Solo asíncrono. `url` no se valida |

***

### Dcard

#### `POST /v1/scrape/dcard/search`

Devuelve los resultados de búsqueda de Dcard para una palabra clave.

**Modos:** sincrónico · asincrónico

| Nombre         | Tipo               | Requerido | Descripción                                                                                                                                                                                  |
| -------------- | ------------------ | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`        | cadena             | sí        | Palabra clave de búsqueda                                                                                                                                                                    |
| `domain`       | cadena             | no        | TLD de la tienda                                                                                                                                                                             |
| `output`       | arreglo de cadenas | no        | Formatos a devolver: `Markdown`, `HTML`, `json`, `screenshot`. por defecto `["html"]`. `json` devuelve los campos analizados. `screenshot` requiere `run_js: true`                           |
| `json`         | objeto             | no        | Extracción personalizada: `{"prompt": string}` o `{"schema": object}`, nunca ambos. Anula el analizador integrado                                                                            |
| `location`     | cadena             | no        | Código de país de dos letras para obtener, por ejemplo `DE`                                                                                                                                  |
| `device`       | cadena             | no        | `escritorio` (predeterminado) o `móvil`                                                                                                                                                      |
| `run_js`       | booleano           | no        | Ejecuta el JavaScript de la página antes de capturarla. Más lento — usa un tiempo de espera del cliente de 150 segundos o más                                                                |
| `callback_url` | cadena             | no        | URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con `400`                                                                                        |
| `storage`      | objeto             | no        | Entrega el resultado a un bucket en lugar de la respuesta: `{"type": string, "url": string}`. `type` es `s3`, `s3_gzip`, `s3_compatible`, `gcs`, o `tos`. Solo asíncrono. `url` no se valida |

***

### Dillons

#### `POST /v1/scrape/dillons`

Devuelve los campos analizados de una página de Dillons a partir de una URL que proporciones.

**Modos:** sincrónico · asincrónico

| Nombre             | Tipo               | Requerido | Descripción                                                                                                                                                                                  |
| ------------------ | ------------------ | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `url`              | cadena             | sí        | Una URL de producto o búsqueda de Dillons                                                                                                                                                    |
| `delivery_zip`     | cadena             | no        | La entrega al código postal se cotiza para                                                                                                                                                   |
| `fulfillment_type` | cadena             | no        | Filtro de entrega, recogida o envío a domicilio                                                                                                                                              |
| `store_id`         | cadena             | no        | La tienda cuyo catálogo y precios se devuelven                                                                                                                                               |
| `output`           | arreglo de cadenas | no        | Formatos a devolver: `Markdown`, `HTML`, `json`, `screenshot`. por defecto `["html"]`. `json` devuelve los campos analizados. `screenshot` requiere `run_js: true`                           |
| `json`             | objeto             | no        | Extracción personalizada: `{"prompt": string}` o `{"schema": object}`, nunca ambos. Anula el analizador integrado                                                                            |
| `location`         | cadena             | no        | Código de país de dos letras para obtener, por ejemplo `DE`                                                                                                                                  |
| `device`           | cadena             | no        | `escritorio` (predeterminado) o `móvil`                                                                                                                                                      |
| `run_js`           | booleano           | no        | Ejecuta el JavaScript de la página antes de capturarla. Más lento — usa un tiempo de espera del cliente de 150 segundos o más                                                                |
| `callback_url`     | cadena             | no        | URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con `400`                                                                                        |
| `storage`          | objeto             | no        | Entrega el resultado a un bucket en lugar de la respuesta: `{"type": string, "url": string}`. `type` es `s3`, `s3_gzip`, `s3_compatible`, `gcs`, o `tos`. Solo asíncrono. `url` no se valida |

#### `POST /v1/scrape/dillons/product`

Devuelve el precio, el stock y los detalles de un producto de Dillons.

**Modos:** sincrónico · asincrónico

| Nombre             | Tipo               | Requerido | Descripción                                                                                                                                                                                  |
| ------------------ | ------------------ | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`            | cadena             | sí        | ID del producto                                                                                                                                                                              |
| `delivery_zip`     | cadena             | no        | La entrega al código postal se cotiza para                                                                                                                                                   |
| `fulfillment_type` | cadena             | no        | Filtro de entrega, recogida o envío a domicilio                                                                                                                                              |
| `store_id`         | cadena             | no        | La tienda cuyo catálogo y precios se devuelven                                                                                                                                               |
| `output`           | arreglo de cadenas | no        | Formatos a devolver: `Markdown`, `HTML`, `json`, `screenshot`. por defecto `["html"]`. `json` devuelve los campos analizados. `screenshot` requiere `run_js: true`                           |
| `json`             | objeto             | no        | Extracción personalizada: `{"prompt": string}` o `{"schema": object}`, nunca ambos. Anula el analizador integrado                                                                            |
| `location`         | cadena             | no        | Código de país de dos letras para obtener, por ejemplo `DE`                                                                                                                                  |
| `device`           | cadena             | no        | `escritorio` (predeterminado) o `móvil`                                                                                                                                                      |
| `run_js`           | booleano           | no        | Ejecuta el JavaScript de la página antes de capturarla. Más lento — usa un tiempo de espera del cliente de 150 segundos o más                                                                |
| `callback_url`     | cadena             | no        | URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con `400`                                                                                        |
| `storage`          | objeto             | no        | Entrega el resultado a un bucket en lugar de la respuesta: `{"type": string, "url": string}`. `type` es `s3`, `s3_gzip`, `s3_compatible`, `gcs`, o `tos`. Solo asíncrono. `url` no se valida |

#### `POST /v1/scrape/dillons/search`

Devuelve los resultados de búsqueda de Dillons para una palabra clave.

**Modos:** sincrónico · asincrónico

| Nombre             | Tipo               | Requerido | Descripción                                                                                                                                                                                  |
| ------------------ | ------------------ | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`            | cadena             | sí        | Palabra clave de búsqueda                                                                                                                                                                    |
| `brand`            | cadena             | no        | Restringe los resultados a una marca                                                                                                                                                         |
| `delivery_zip`     | cadena             | no        | La entrega al código postal se cotiza para                                                                                                                                                   |
| `fulfillment_type` | cadena             | no        | Filtro de entrega, recogida o envío a domicilio                                                                                                                                              |
| `price_range`      | cadena             | no        | Filtro de banda de precios                                                                                                                                                                   |
| `store_id`         | cadena             | no        | La tienda cuyo catálogo y precios se devuelven                                                                                                                                               |
| `output`           | arreglo de cadenas | no        | Formatos a devolver: `Markdown`, `HTML`, `json`, `screenshot`. por defecto `["html"]`. `json` devuelve los campos analizados. `screenshot` requiere `run_js: true`                           |
| `json`             | objeto             | no        | Extracción personalizada: `{"prompt": string}` o `{"schema": object}`, nunca ambos. Anula el analizador integrado                                                                            |
| `location`         | cadena             | no        | Código de país de dos letras para obtener, por ejemplo `DE`                                                                                                                                  |
| `device`           | cadena             | no        | `escritorio` (predeterminado) o `móvil`                                                                                                                                                      |
| `run_js`           | booleano           | no        | Ejecuta el JavaScript de la página antes de capturarla. Más lento — usa un tiempo de espera del cliente de 150 segundos o más                                                                |
| `callback_url`     | cadena             | no        | URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con `400`                                                                                        |
| `storage`          | objeto             | no        | Entrega el resultado a un bucket en lugar de la respuesta: `{"type": string, "url": string}`. `type` es `s3`, `s3_gzip`, `s3_compatible`, `gcs`, o `tos`. Solo asíncrono. `url` no se valida |

***

### eBay

#### `POST /v1/scrape/ebay`

Devuelve los campos analizados de una página de eBay a partir de una URL que proporciones.

**Modos:** sincrónico · asincrónico

| Nombre         | Tipo               | Requerido | Descripción                                                                                                                                                                                  |
| -------------- | ------------------ | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `url`          | cadena             | sí        | Una URL de producto o búsqueda de eBay                                                                                                                                                       |
| `output`       | arreglo de cadenas | no        | Formatos a devolver: `Markdown`, `HTML`, `json`, `screenshot`. por defecto `["html"]`. `json` devuelve los campos analizados. `screenshot` requiere `run_js: true`                           |
| `json`         | objeto             | no        | Extracción personalizada: `{"prompt": string}` o `{"schema": object}`, nunca ambos. Anula el analizador integrado                                                                            |
| `location`     | cadena             | no        | Código de país de dos letras para obtener, por ejemplo `DE`                                                                                                                                  |
| `device`       | cadena             | no        | `escritorio` (predeterminado) o `móvil`                                                                                                                                                      |
| `run_js`       | booleano           | no        | Ejecuta el JavaScript de la página antes de capturarla. Más lento — usa un tiempo de espera del cliente de 150 segundos o más                                                                |
| `callback_url` | cadena             | no        | URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con `400`                                                                                        |
| `storage`      | objeto             | no        | Entrega el resultado a un bucket en lugar de la respuesta: `{"type": string, "url": string}`. `type` es `s3`, `s3_gzip`, `s3_compatible`, `gcs`, o `tos`. Solo asíncrono. `url` no se valida |

#### `POST /v1/scrape/ebay/product`

Devuelve el precio, el stock y los detalles de un producto de eBay.

**Modos:** sincrónico · asincrónico

| Nombre         | Tipo               | Requerido | Descripción                                                                                                                                                                                  |
| -------------- | ------------------ | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`        | cadena             | sí        | ID del producto                                                                                                                                                                              |
| `domain`       | cadena             | no        | TLD de la tienda                                                                                                                                                                             |
| `output`       | arreglo de cadenas | no        | Formatos a devolver: `Markdown`, `HTML`, `json`, `screenshot`. por defecto `["html"]`. `json` devuelve los campos analizados. `screenshot` requiere `run_js: true`                           |
| `json`         | objeto             | no        | Extracción personalizada: `{"prompt": string}` o `{"schema": object}`, nunca ambos. Anula el analizador integrado                                                                            |
| `location`     | cadena             | no        | Código de país de dos letras para obtener, por ejemplo `DE`                                                                                                                                  |
| `device`       | cadena             | no        | `escritorio` (predeterminado) o `móvil`                                                                                                                                                      |
| `run_js`       | booleano           | no        | Ejecuta el JavaScript de la página antes de capturarla. Más lento — usa un tiempo de espera del cliente de 150 segundos o más                                                                |
| `callback_url` | cadena             | no        | URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con `400`                                                                                        |
| `storage`      | objeto             | no        | Entrega el resultado a un bucket en lugar de la respuesta: `{"type": string, "url": string}`. `type` es `s3`, `s3_gzip`, `s3_compatible`, `gcs`, o `tos`. Solo asíncrono. `url` no se valida |

#### `POST /v1/scrape/ebay/search`

Devuelve los resultados de búsqueda de eBay para una palabra clave.

**Modos:** sincrónico · asincrónico

| Nombre         | Tipo               | Requerido | Descripción                                                                                                                                                                                  |
| -------------- | ------------------ | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`        | cadena             | sí        | Palabra clave de búsqueda                                                                                                                                                                    |
| `domain`       | cadena             | no        | TLD de la tienda                                                                                                                                                                             |
| `start_page`   | entero             | no        | Primera página de resultados                                                                                                                                                                 |
| `output`       | arreglo de cadenas | no        | Formatos a devolver: `Markdown`, `HTML`, `json`, `screenshot`. por defecto `["html"]`. `json` devuelve los campos analizados. `screenshot` requiere `run_js: true`                           |
| `json`         | objeto             | no        | Extracción personalizada: `{"prompt": string}` o `{"schema": object}`, nunca ambos. Anula el analizador integrado                                                                            |
| `location`     | cadena             | no        | Código de país de dos letras para obtener, por ejemplo `DE`                                                                                                                                  |
| `device`       | cadena             | no        | `escritorio` (predeterminado) o `móvil`                                                                                                                                                      |
| `run_js`       | booleano           | no        | Ejecuta el JavaScript de la página antes de capturarla. Más lento — usa un tiempo de espera del cliente de 150 segundos o más                                                                |
| `callback_url` | cadena             | no        | URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con `400`                                                                                        |
| `storage`      | objeto             | no        | Entrega el resultado a un bucket en lugar de la respuesta: `{"type": string, "url": string}`. `type` es `s3`, `s3_gzip`, `s3_compatible`, `gcs`, o `tos`. Solo asíncrono. `url` no se valida |

***

### Etsy

#### `POST /v1/scrape/etsy`

Devuelve los campos analizados de una página de Etsy a partir de una URL que proporciones.

**Modos:** sincrónico · asincrónico

| Nombre         | Tipo               | Requerido | Descripción                                                                                                                                                                                  |
| -------------- | ------------------ | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `url`          | cadena             | sí        | Una URL de producto o búsqueda de Etsy                                                                                                                                                       |
| `output`       | arreglo de cadenas | no        | Formatos a devolver: `Markdown`, `HTML`, `json`, `screenshot`. por defecto `["html"]`. `json` devuelve los campos analizados. `screenshot` requiere `run_js: true`                           |
| `json`         | objeto             | no        | Extracción personalizada: `{"prompt": string}` o `{"schema": object}`, nunca ambos. Anula el analizador integrado                                                                            |
| `location`     | cadena             | no        | Código de país de dos letras para obtener, por ejemplo `DE`                                                                                                                                  |
| `device`       | cadena             | no        | `escritorio` (predeterminado) o `móvil`                                                                                                                                                      |
| `run_js`       | booleano           | no        | Ejecuta el JavaScript de la página antes de capturar. Más lento — use un tiempo de espera del cliente de 120 segundos o más                                                                  |
| `callback_url` | cadena             | no        | URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con `400`                                                                                        |
| `storage`      | objeto             | no        | Entrega el resultado a un bucket en lugar de la respuesta: `{"type": string, "url": string}`. `type` es `s3`, `s3_gzip`, `s3_compatible`, `gcs`, o `tos`. Solo asíncrono. `url` no se valida |

#### `POST /v1/scrape/etsy/product`

Devuelve el precio, el stock y los detalles de un producto de Etsy.

**Modos:** sincrónico · asincrónico

| Nombre         | Tipo               | Requerido | Descripción                                                                                                                                                                                  |
| -------------- | ------------------ | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`        | cadena             | sí        | ID del producto                                                                                                                                                                              |
| `output`       | arreglo de cadenas | no        | Formatos a devolver: `Markdown`, `HTML`, `json`, `screenshot`. por defecto `["html"]`. `json` devuelve los campos analizados. `screenshot` requiere `run_js: true`                           |
| `json`         | objeto             | no        | Extracción personalizada: `{"prompt": string}` o `{"schema": object}`, nunca ambos. Anula el analizador integrado                                                                            |
| `location`     | cadena             | no        | Código de país de dos letras para obtener, por ejemplo `DE`                                                                                                                                  |
| `device`       | cadena             | no        | `escritorio` (predeterminado) o `móvil`                                                                                                                                                      |
| `run_js`       | booleano           | no        | Ejecuta el JavaScript de la página antes de capturar. Más lento — use un tiempo de espera del cliente de 120 segundos o más                                                                  |
| `callback_url` | cadena             | no        | URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con `400`                                                                                        |
| `storage`      | objeto             | no        | Entrega el resultado a un bucket en lugar de la respuesta: `{"type": string, "url": string}`. `type` es `s3`, `s3_gzip`, `s3_compatible`, `gcs`, o `tos`. Solo asíncrono. `url` no se valida |

#### `POST /v1/scrape/etsy/search`

Devuelve los resultados de búsqueda de Etsy para una palabra clave.

**Modos:** sincrónico · asincrónico

| Nombre         | Tipo               | Requerido | Descripción                                                                                                                                                                                  |
| -------------- | ------------------ | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`        | cadena             | sí        | Palabra clave de búsqueda                                                                                                                                                                    |
| `domain`       | cadena             | no        | TLD de la tienda                                                                                                                                                                             |
| `ship_to`      | cadena             | no        | Destino de envío                                                                                                                                                                             |
| `start_page`   | entero             | no        | Primera página de resultados                                                                                                                                                                 |
| `store_id`     | cadena             | no        | La tienda cuyo catálogo y precios se devuelven                                                                                                                                               |
| `output`       | arreglo de cadenas | no        | Formatos a devolver: `Markdown`, `HTML`, `json`, `screenshot`. por defecto `["html"]`. `json` devuelve los campos analizados. `screenshot` requiere `run_js: true`                           |
| `json`         | objeto             | no        | Extracción personalizada: `{"prompt": string}` o `{"schema": object}`, nunca ambos. Anula el analizador integrado                                                                            |
| `location`     | cadena             | no        | Código de país de dos letras para obtener, por ejemplo `DE`                                                                                                                                  |
| `device`       | cadena             | no        | `escritorio` (predeterminado) o `móvil`                                                                                                                                                      |
| `run_js`       | booleano           | no        | Ejecuta el JavaScript de la página antes de capturar. Más lento — use un tiempo de espera del cliente de 120 segundos o más                                                                  |
| `callback_url` | cadena             | no        | URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con `400`                                                                                        |
| `storage`      | objeto             | no        | Entrega el resultado a un bucket en lugar de la respuesta: `{"type": string, "url": string}`. `type` es `s3`, `s3_gzip`, `s3_compatible`, `gcs`, o `tos`. Solo asíncrono. `url` no se valida |

***

### Falabella

#### `POST /v1/scrape/falabella`

Devuelve los campos analizados de una página de Falabella a partir de una URL que proporciones.

**Modos:** sincrónico · asincrónico

| Nombre         | Tipo               | Requerido | Descripción                                                                                                                                                                                  |
| -------------- | ------------------ | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `url`          | cadena             | sí        | Una URL de producto o búsqueda de Falabella                                                                                                                                                  |
| `output`       | arreglo de cadenas | no        | Formatos a devolver: `Markdown`, `HTML`, `json`, `screenshot`. por defecto `["html"]`. `json` devuelve los campos analizados. `screenshot` requiere `run_js: true`                           |
| `json`         | objeto             | no        | Extracción personalizada: `{"prompt": string}` o `{"schema": object}`, nunca ambos. Anula el analizador integrado                                                                            |
| `location`     | cadena             | no        | Código de país de dos letras para obtener, por ejemplo `DE`                                                                                                                                  |
| `device`       | cadena             | no        | `escritorio` (predeterminado) o `móvil`                                                                                                                                                      |
| `run_js`       | booleano           | no        | Ejecuta el JavaScript de la página antes de capturar. Más lento — use un tiempo de espera del cliente de 120 segundos o más                                                                  |
| `callback_url` | cadena             | no        | URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con `400`                                                                                        |
| `storage`      | objeto             | no        | Entrega el resultado a un bucket en lugar de la respuesta: `{"type": string, "url": string}`. `type` es `s3`, `s3_gzip`, `s3_compatible`, `gcs`, o `tos`. Solo asíncrono. `url` no se valida |

#### `POST /v1/scrape/falabella/product`

Devuelve el precio, el stock y los detalles de un producto de Falabella.

**Modos:** sincrónico · asincrónico

| Nombre         | Tipo               | Requerido | Descripción                                                                                                                                                                                  |
| -------------- | ------------------ | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`        | cadena             | sí        | ID del producto                                                                                                                                                                              |
| `domain`       | cadena             | no        | TLD de la tienda                                                                                                                                                                             |
| `output`       | arreglo de cadenas | no        | Formatos a devolver: `Markdown`, `HTML`, `json`, `screenshot`. por defecto `["html"]`. `json` devuelve los campos analizados. `screenshot` requiere `run_js: true`                           |
| `json`         | objeto             | no        | Extracción personalizada: `{"prompt": string}` o `{"schema": object}`, nunca ambos. Anula el analizador integrado                                                                            |
| `location`     | cadena             | no        | Código de país de dos letras para obtener, por ejemplo `DE`                                                                                                                                  |
| `device`       | cadena             | no        | `escritorio` (predeterminado) o `móvil`                                                                                                                                                      |
| `run_js`       | booleano           | no        | Ejecuta el JavaScript de la página antes de capturar. Más lento — use un tiempo de espera del cliente de 120 segundos o más                                                                  |
| `callback_url` | cadena             | no        | URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con `400`                                                                                        |
| `storage`      | objeto             | no        | Entrega el resultado a un bucket en lugar de la respuesta: `{"type": string, "url": string}`. `type` es `s3`, `s3_gzip`, `s3_compatible`, `gcs`, o `tos`. Solo asíncrono. `url` no se valida |

#### `POST /v1/scrape/falabella/search`

Devuelve resultados de búsqueda de Falabella para una palabra clave.

**Modos:** sincrónico · asincrónico

| Nombre         | Tipo               | Requerido | Descripción                                                                                                                                                                                  |
| -------------- | ------------------ | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`        | cadena             | sí        | Palabra clave de búsqueda                                                                                                                                                                    |
| `domain`       | cadena             | no        | TLD de la tienda                                                                                                                                                                             |
| `start_page`   | entero             | no        | Primera página de resultados                                                                                                                                                                 |
| `output`       | arreglo de cadenas | no        | Formatos a devolver: `Markdown`, `HTML`, `json`, `screenshot`. por defecto `["html"]`. `json` devuelve los campos analizados. `screenshot` requiere `run_js: true`                           |
| `json`         | objeto             | no        | Extracción personalizada: `{"prompt": string}` o `{"schema": object}`, nunca ambos. Anula el analizador integrado                                                                            |
| `location`     | cadena             | no        | Código de país de dos letras para obtener, por ejemplo `DE`                                                                                                                                  |
| `device`       | cadena             | no        | `escritorio` (predeterminado) o `móvil`                                                                                                                                                      |
| `run_js`       | booleano           | no        | Ejecuta el JavaScript de la página antes de capturar. Más lento — use un tiempo de espera del cliente de 120 segundos o más                                                                  |
| `callback_url` | cadena             | no        | URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con `400`                                                                                        |
| `storage`      | objeto             | no        | Entrega el resultado a un bucket en lugar de la respuesta: `{"type": string, "url": string}`. `type` es `s3`, `s3_gzip`, `s3_compatible`, `gcs`, o `tos`. Solo asíncrono. `url` no se valida |

***

### Flipkart

#### `POST /v1/scrape/flipkart`

Devuelve los campos analizados de una página de Flipkart a partir de una URL que proporciones.

**Modos:** sincrónico · asincrónico

| Nombre         | Tipo               | Requerido | Descripción                                                                                                                                                                                  |
| -------------- | ------------------ | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `url`          | cadena             | sí        | Una URL de producto o búsqueda de Flipkart                                                                                                                                                   |
| `output`       | arreglo de cadenas | no        | Formatos a devolver: `Markdown`, `HTML`, `json`, `screenshot`. por defecto `["html"]`. `json` devuelve los campos analizados. `screenshot` requiere `run_js: true`                           |
| `json`         | objeto             | no        | Extracción personalizada: `{"prompt": string}` o `{"schema": object}`, nunca ambos. Anula el analizador integrado                                                                            |
| `location`     | cadena             | no        | Código de país de dos letras para obtener, por ejemplo `DE`                                                                                                                                  |
| `device`       | cadena             | no        | `escritorio` (predeterminado) o `móvil`                                                                                                                                                      |
| `run_js`       | booleano           | no        | Ejecuta el JavaScript de la página antes de capturar. Más lento — use un tiempo de espera del cliente de 120 segundos o más                                                                  |
| `callback_url` | cadena             | no        | URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con `400`                                                                                        |
| `storage`      | objeto             | no        | Entrega el resultado a un bucket en lugar de la respuesta: `{"type": string, "url": string}`. `type` es `s3`, `s3_gzip`, `s3_compatible`, `gcs`, o `tos`. Solo asíncrono. `url` no se valida |

#### `POST /v1/scrape/flipkart/product`

Devuelve el precio, el stock y los detalles de un producto de Flipkart.

**Modos:** sincrónico · asincrónico

| Nombre         | Tipo               | Requerido | Descripción                                                                                                                                                                                  |
| -------------- | ------------------ | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`        | cadena             | sí        | ID del producto                                                                                                                                                                              |
| `domain`       | cadena             | no        | TLD de la tienda                                                                                                                                                                             |
| `output`       | arreglo de cadenas | no        | Formatos a devolver: `Markdown`, `HTML`, `json`, `screenshot`. por defecto `["html"]`. `json` devuelve los campos analizados. `screenshot` requiere `run_js: true`                           |
| `json`         | objeto             | no        | Extracción personalizada: `{"prompt": string}` o `{"schema": object}`, nunca ambos. Anula el analizador integrado                                                                            |
| `location`     | cadena             | no        | Código de país de dos letras para obtener, por ejemplo `DE`                                                                                                                                  |
| `device`       | cadena             | no        | `escritorio` (predeterminado) o `móvil`                                                                                                                                                      |
| `run_js`       | booleano           | no        | Ejecuta el JavaScript de la página antes de capturar. Más lento — use un tiempo de espera del cliente de 120 segundos o más                                                                  |
| `callback_url` | cadena             | no        | URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con `400`                                                                                        |
| `storage`      | objeto             | no        | Entrega el resultado a un bucket en lugar de la respuesta: `{"type": string, "url": string}`. `type` es `s3`, `s3_gzip`, `s3_compatible`, `gcs`, o `tos`. Solo asíncrono. `url` no se valida |

#### `POST /v1/scrape/flipkart/search`

Devuelve resultados de búsqueda de Flipkart para una palabra clave.

**Modos:** sincrónico · asincrónico

| Nombre         | Tipo               | Requerido | Descripción                                                                                                                                                                                  |
| -------------- | ------------------ | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`        | cadena             | sí        | Palabra clave de búsqueda                                                                                                                                                                    |
| `domain`       | cadena             | no        | TLD de la tienda                                                                                                                                                                             |
| `start_page`   | entero             | no        | Primera página de resultados                                                                                                                                                                 |
| `output`       | arreglo de cadenas | no        | Formatos a devolver: `Markdown`, `HTML`, `json`, `screenshot`. por defecto `["html"]`. `json` devuelve los campos analizados. `screenshot` requiere `run_js: true`                           |
| `json`         | objeto             | no        | Extracción personalizada: `{"prompt": string}` o `{"schema": object}`, nunca ambos. Anula el analizador integrado                                                                            |
| `location`     | cadena             | no        | Código de país de dos letras para obtener, por ejemplo `DE`                                                                                                                                  |
| `device`       | cadena             | no        | `escritorio` (predeterminado) o `móvil`                                                                                                                                                      |
| `run_js`       | booleano           | no        | Ejecuta el JavaScript de la página antes de capturar. Más lento — use un tiempo de espera del cliente de 120 segundos o más                                                                  |
| `callback_url` | cadena             | no        | URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con `400`                                                                                        |
| `storage`      | objeto             | no        | Entrega el resultado a un bucket en lugar de la respuesta: `{"type": string, "url": string}`. `type` es `s3`, `s3_gzip`, `s3_compatible`, `gcs`, o `tos`. Solo asíncrono. `url` no se valida |

***

### Food 4 Less

#### `POST /v1/scrape/foodfourless`

Devuelve los campos analizados de una página de Food 4 Less a partir de una URL que proporciones.

**Modos:** sincrónico · asincrónico

| Nombre             | Tipo               | Requerido | Descripción                                                                                                                                                                                  |
| ------------------ | ------------------ | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `url`              | cadena             | sí        | Una URL de producto o búsqueda de Food 4 Less                                                                                                                                                |
| `delivery_zip`     | cadena             | no        | La entrega al código postal se cotiza para                                                                                                                                                   |
| `fulfillment_type` | cadena             | no        | Filtro de entrega, recogida o envío a domicilio                                                                                                                                              |
| `store_id`         | cadena             | no        | La tienda cuyo catálogo y precios se devuelven                                                                                                                                               |
| `output`           | arreglo de cadenas | no        | Formatos a devolver: `Markdown`, `HTML`, `json`, `screenshot`. por defecto `["html"]`. `json` devuelve los campos analizados. `screenshot` requiere `run_js: true`                           |
| `json`             | objeto             | no        | Extracción personalizada: `{"prompt": string}` o `{"schema": object}`, nunca ambos. Anula el analizador integrado                                                                            |
| `location`         | cadena             | no        | Código de país de dos letras para obtener, por ejemplo `DE`                                                                                                                                  |
| `device`           | cadena             | no        | `escritorio` (predeterminado) o `móvil`                                                                                                                                                      |
| `run_js`           | booleano           | no        | Ejecuta el JavaScript de la página antes de capturar. Más lento — use un tiempo de espera del cliente de 120 segundos o más                                                                  |
| `callback_url`     | cadena             | no        | URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con `400`                                                                                        |
| `storage`          | objeto             | no        | Entrega el resultado a un bucket en lugar de la respuesta: `{"type": string, "url": string}`. `type` es `s3`, `s3_gzip`, `s3_compatible`, `gcs`, o `tos`. Solo asíncrono. `url` no se valida |

#### `POST /v1/scrape/foodfourless/product`

Devuelve el precio, el stock y los detalles de un producto de Food 4 Less.

**Modos:** sincrónico · asincrónico

| Nombre             | Tipo               | Requerido | Descripción                                                                                                                                                                                  |
| ------------------ | ------------------ | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`            | cadena             | sí        | ID del producto                                                                                                                                                                              |
| `delivery_zip`     | cadena             | no        | La entrega al código postal se cotiza para                                                                                                                                                   |
| `fulfillment_type` | cadena             | no        | Filtro de entrega, recogida o envío a domicilio                                                                                                                                              |
| `store_id`         | cadena             | no        | La tienda cuyo catálogo y precios se devuelven                                                                                                                                               |
| `output`           | arreglo de cadenas | no        | Formatos a devolver: `Markdown`, `HTML`, `json`, `screenshot`. por defecto `["html"]`. `json` devuelve los campos analizados. `screenshot` requiere `run_js: true`                           |
| `json`             | objeto             | no        | Extracción personalizada: `{"prompt": string}` o `{"schema": object}`, nunca ambos. Anula el analizador integrado                                                                            |
| `location`         | cadena             | no        | Código de país de dos letras para obtener, por ejemplo `DE`                                                                                                                                  |
| `device`           | cadena             | no        | `escritorio` (predeterminado) o `móvil`                                                                                                                                                      |
| `run_js`           | booleano           | no        | Ejecuta el JavaScript de la página antes de capturar. Más lento — use un tiempo de espera del cliente de 120 segundos o más                                                                  |
| `callback_url`     | cadena             | no        | URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con `400`                                                                                        |
| `storage`          | objeto             | no        | Entrega el resultado a un bucket en lugar de la respuesta: `{"type": string, "url": string}`. `type` es `s3`, `s3_gzip`, `s3_compatible`, `gcs`, o `tos`. Solo asíncrono. `url` no se valida |

#### `POST /v1/scrape/foodfourless/search`

Devuelve resultados de búsqueda de Food 4 Less para una palabra clave.

**Modos:** sincrónico · asincrónico

| Nombre             | Tipo               | Requerido | Descripción                                                                                                                                                                                  |
| ------------------ | ------------------ | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`            | cadena             | sí        | Palabra clave de búsqueda                                                                                                                                                                    |
| `delivery_zip`     | cadena             | no        | La entrega al código postal se cotiza para                                                                                                                                                   |
| `fulfillment_type` | cadena             | no        | Filtro de entrega, recogida o envío a domicilio                                                                                                                                              |
| `store_id`         | cadena             | no        | La tienda cuyo catálogo y precios se devuelven                                                                                                                                               |
| `output`           | arreglo de cadenas | no        | Formatos a devolver: `Markdown`, `HTML`, `json`, `screenshot`. por defecto `["html"]`. `json` devuelve los campos analizados. `screenshot` requiere `run_js: true`                           |
| `json`             | objeto             | no        | Extracción personalizada: `{"prompt": string}` o `{"schema": object}`, nunca ambos. Anula el analizador integrado                                                                            |
| `location`         | cadena             | no        | Código de país de dos letras para obtener, por ejemplo `DE`                                                                                                                                  |
| `device`           | cadena             | no        | `escritorio` (predeterminado) o `móvil`                                                                                                                                                      |
| `run_js`           | booleano           | no        | Ejecuta el JavaScript de la página antes de capturar. Más lento — use un tiempo de espera del cliente de 120 segundos o más                                                                  |
| `callback_url`     | cadena             | no        | URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con `400`                                                                                        |
| `storage`          | objeto             | no        | Entrega el resultado a un bucket en lugar de la respuesta: `{"type": string, "url": string}`. `type` es `s3`, `s3_gzip`, `s3_compatible`, `gcs`, o `tos`. Solo asíncrono. `url` no se valida |

Toma la forma del producto: no `brand` o `price_range`.

***

### Fred Meyer

#### `POST /v1/scrape/fredmeyer`

Devuelve los campos analizados de una página de Fred Meyer a partir de una URL que proporciones.

**Modos:** sincrónico · asincrónico

| Nombre             | Tipo               | Requerido | Descripción                                                                                                                                                                                  |
| ------------------ | ------------------ | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `url`              | cadena             | sí        | Una URL de producto o búsqueda de Fred Meyer                                                                                                                                                 |
| `delivery_zip`     | cadena             | no        | La entrega al código postal se cotiza para                                                                                                                                                   |
| `fulfillment_type` | cadena             | no        | Filtro de entrega, recogida o envío a domicilio                                                                                                                                              |
| `store_id`         | cadena             | no        | La tienda cuyo catálogo y precios se devuelven                                                                                                                                               |
| `output`           | arreglo de cadenas | no        | Formatos a devolver: `Markdown`, `HTML`, `json`, `screenshot`. por defecto `["html"]`. `json` devuelve los campos analizados. `screenshot` requiere `run_js: true`                           |
| `json`             | objeto             | no        | Extracción personalizada: `{"prompt": string}` o `{"schema": object}`, nunca ambos. Anula el analizador integrado                                                                            |
| `location`         | cadena             | no        | Código de país de dos letras para obtener, por ejemplo `DE`                                                                                                                                  |
| `device`           | cadena             | no        | `escritorio` (predeterminado) o `móvil`                                                                                                                                                      |
| `run_js`           | booleano           | no        | Ejecuta el JavaScript de la página antes de capturar. Más lento — use un tiempo de espera del cliente de 120 segundos o más                                                                  |
| `callback_url`     | cadena             | no        | URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con `400`                                                                                        |
| `storage`          | objeto             | no        | Entrega el resultado a un bucket en lugar de la respuesta: `{"type": string, "url": string}`. `type` es `s3`, `s3_gzip`, `s3_compatible`, `gcs`, o `tos`. Solo asíncrono. `url` no se valida |

#### `POST /v1/scrape/fredmeyer/product`

Devuelve el precio, el stock y los detalles de un producto de Fred Meyer.

**Modos:** sincrónico · asincrónico

| Nombre             | Tipo               | Requerido | Descripción                                                                                                                                                                                  |
| ------------------ | ------------------ | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`            | cadena             | sí        | ID del producto                                                                                                                                                                              |
| `delivery_zip`     | cadena             | no        | La entrega al código postal se cotiza para                                                                                                                                                   |
| `fulfillment_type` | cadena             | no        | Filtro de entrega, recogida o envío a domicilio                                                                                                                                              |
| `store_id`         | cadena             | no        | La tienda cuyo catálogo y precios se devuelven                                                                                                                                               |
| `output`           | arreglo de cadenas | no        | Formatos a devolver: `Markdown`, `HTML`, `json`, `screenshot`. por defecto `["html"]`. `json` devuelve los campos analizados. `screenshot` requiere `run_js: true`                           |
| `json`             | objeto             | no        | Extracción personalizada: `{"prompt": string}` o `{"schema": object}`, nunca ambos. Anula el analizador integrado                                                                            |
| `location`         | cadena             | no        | Código de país de dos letras para obtener, por ejemplo `DE`                                                                                                                                  |
| `device`           | cadena             | no        | `escritorio` (predeterminado) o `móvil`                                                                                                                                                      |
| `run_js`           | booleano           | no        | Ejecuta el JavaScript de la página antes de capturar. Más lento — use un tiempo de espera del cliente de 120 segundos o más                                                                  |
| `callback_url`     | cadena             | no        | URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con `400`                                                                                        |
| `storage`          | objeto             | no        | Entrega el resultado a un bucket en lugar de la respuesta: `{"type": string, "url": string}`. `type` es `s3`, `s3_gzip`, `s3_compatible`, `gcs`, o `tos`. Solo asíncrono. `url` no se valida |

#### `POST /v1/scrape/fredmeyer/search`

Devuelve resultados de búsqueda de Fred Meyer para una palabra clave.

**Modos:** sincrónico · asincrónico

| Nombre             | Tipo               | Requerido | Descripción                                                                                                                                                                                  |
| ------------------ | ------------------ | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`            | cadena             | sí        | Palabra clave de búsqueda                                                                                                                                                                    |
| `brand`            | cadena             | no        | Restringe los resultados a una marca                                                                                                                                                         |
| `delivery_zip`     | cadena             | no        | La entrega al código postal se cotiza para                                                                                                                                                   |
| `fulfillment_type` | cadena             | no        | Filtro de entrega, recogida o envío a domicilio                                                                                                                                              |
| `price_range`      | cadena             | no        | Filtro de banda de precios                                                                                                                                                                   |
| `store_id`         | cadena             | no        | La tienda cuyo catálogo y precios se devuelven                                                                                                                                               |
| `output`           | arreglo de cadenas | no        | Formatos a devolver: `Markdown`, `HTML`, `json`, `screenshot`. por defecto `["html"]`. `json` devuelve los campos analizados. `screenshot` requiere `run_js: true`                           |
| `json`             | objeto             | no        | Extracción personalizada: `{"prompt": string}` o `{"schema": object}`, nunca ambos. Anula el analizador integrado                                                                            |
| `location`         | cadena             | no        | Código de país de dos letras para obtener, por ejemplo `DE`                                                                                                                                  |
| `device`           | cadena             | no        | `escritorio` (predeterminado) o `móvil`                                                                                                                                                      |
| `run_js`           | booleano           | no        | Ejecuta el JavaScript de la página antes de capturar. Más lento — use un tiempo de espera del cliente de 120 segundos o más                                                                  |
| `callback_url`     | cadena             | no        | URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con `400`                                                                                        |
| `storage`          | objeto             | no        | Entrega el resultado a un bucket en lugar de la respuesta: `{"type": string, "url": string}`. `type` es `s3`, `s3_gzip`, `s3_compatible`, `gcs`, o `tos`. Solo asíncrono. `url` no se valida |

***

### Fry's Food

#### `POST /v1/scrape/frysfood`

Devuelve los campos analizados de una página de Fry's Food a partir de una URL que proporciones.

**Modos:** sincrónico · asincrónico

| Nombre             | Tipo               | Requerido | Descripción                                                                                                                                                                                  |
| ------------------ | ------------------ | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `url`              | cadena             | sí        | Una URL de producto o búsqueda de Fry's Food                                                                                                                                                 |
| `delivery_zip`     | cadena             | no        | La entrega al código postal se cotiza para                                                                                                                                                   |
| `fulfillment_type` | cadena             | no        | Filtro de entrega, recogida o envío a domicilio                                                                                                                                              |
| `store_id`         | cadena             | no        | La tienda cuyo catálogo y precios se devuelven                                                                                                                                               |
| `output`           | arreglo de cadenas | no        | Formatos a devolver: `Markdown`, `HTML`, `json`, `screenshot`. por defecto `["html"]`. `json` devuelve los campos analizados. `screenshot` requiere `run_js: true`                           |
| `json`             | objeto             | no        | Extracción personalizada: `{"prompt": string}` o `{"schema": object}`, nunca ambos. Anula el analizador integrado                                                                            |
| `location`         | cadena             | no        | Código de país de dos letras para obtener, por ejemplo `DE`                                                                                                                                  |
| `device`           | cadena             | no        | `escritorio` (predeterminado) o `móvil`                                                                                                                                                      |
| `run_js`           | booleano           | no        | Ejecuta el JavaScript de la página antes de capturar. Más lento — use un tiempo de espera del cliente de 120 segundos o más                                                                  |
| `callback_url`     | cadena             | no        | URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con `400`                                                                                        |
| `storage`          | objeto             | no        | Entrega el resultado a un bucket en lugar de la respuesta: `{"type": string, "url": string}`. `type` es `s3`, `s3_gzip`, `s3_compatible`, `gcs`, o `tos`. Solo asíncrono. `url` no se valida |

#### `POST /v1/scrape/frysfood/product`

Devuelve el precio, el stock y los detalles de un producto de Fry's Food.

**Modos:** sincrónico · asincrónico

| Nombre             | Tipo               | Requerido | Descripción                                                                                                                                                                                  |
| ------------------ | ------------------ | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`            | cadena             | sí        | ID del producto                                                                                                                                                                              |
| `delivery_zip`     | cadena             | no        | La entrega al código postal se cotiza para                                                                                                                                                   |
| `fulfillment_type` | cadena             | no        | Filtro de entrega, recogida o envío a domicilio                                                                                                                                              |
| `store_id`         | cadena             | no        | La tienda cuyo catálogo y precios se devuelven                                                                                                                                               |
| `output`           | arreglo de cadenas | no        | Formatos a devolver: `Markdown`, `HTML`, `json`, `screenshot`. por defecto `["html"]`. `json` devuelve los campos analizados. `screenshot` requiere `run_js: true`                           |
| `json`             | objeto             | no        | Extracción personalizada: `{"prompt": string}` o `{"schema": object}`, nunca ambos. Anula el analizador integrado                                                                            |
| `location`         | cadena             | no        | Código de país de dos letras para obtener, por ejemplo `DE`                                                                                                                                  |
| `device`           | cadena             | no        | `escritorio` (predeterminado) o `móvil`                                                                                                                                                      |
| `run_js`           | booleano           | no        | Ejecuta el JavaScript de la página antes de capturar. Más lento — use un tiempo de espera del cliente de 120 segundos o más                                                                  |
| `callback_url`     | cadena             | no        | URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con `400`                                                                                        |
| `storage`          | objeto             | no        | Entrega el resultado a un bucket en lugar de la respuesta: `{"type": string, "url": string}`. `type` es `s3`, `s3_gzip`, `s3_compatible`, `gcs`, o `tos`. Solo asíncrono. `url` no se valida |

#### `POST /v1/scrape/frysfood/search`

Devuelve resultados de búsqueda de Fry's Food para una palabra clave.

**Modos:** sincrónico · asincrónico

| Nombre             | Tipo               | Requerido | Descripción                                                                                                                                                                                  |
| ------------------ | ------------------ | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`            | cadena             | sí        | Palabra clave de búsqueda                                                                                                                                                                    |
| `brand`            | cadena             | no        | Restringe los resultados a una marca                                                                                                                                                         |
| `delivery_zip`     | cadena             | no        | La entrega al código postal se cotiza para                                                                                                                                                   |
| `fulfillment_type` | cadena             | no        | Filtro de entrega, recogida o envío a domicilio                                                                                                                                              |
| `price_range`      | cadena             | no        | Filtro de banda de precios                                                                                                                                                                   |
| `store_id`         | cadena             | no        | La tienda cuyo catálogo y precios se devuelven                                                                                                                                               |
| `output`           | arreglo de cadenas | no        | Formatos a devolver: `Markdown`, `HTML`, `json`, `screenshot`. por defecto `["html"]`. `json` devuelve los campos analizados. `screenshot` requiere `run_js: true`                           |
| `json`             | objeto             | no        | Extracción personalizada: `{"prompt": string}` o `{"schema": object}`, nunca ambos. Anula el analizador integrado                                                                            |
| `location`         | cadena             | no        | Código de país de dos letras para obtener, por ejemplo `DE`                                                                                                                                  |
| `device`           | cadena             | no        | `escritorio` (predeterminado) o `móvil`                                                                                                                                                      |
| `run_js`           | booleano           | no        | Ejecuta el JavaScript de la página antes de capturar. Más lento — use un tiempo de espera del cliente de 120 segundos o más                                                                  |
| `callback_url`     | cadena             | no        | URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con `400`                                                                                        |
| `storage`          | objeto             | no        | Entrega el resultado a un bucket en lugar de la respuesta: `{"type": string, "url": string}`. `type` es `s3`, `s3_gzip`, `s3_compatible`, `gcs`, o `tos`. Solo asíncrono. `url` no se valida |

***

### Gerbes

#### `POST /v1/scrape/gerbes`

Devuelve los campos analizados de una página de Gerbes a partir de una URL que proporciones.

**Modos:** sincrónico · asincrónico

| Nombre             | Tipo               | Requerido | Descripción                                                                                                                                                                                  |
| ------------------ | ------------------ | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `url`              | cadena             | sí        | Una URL de producto o búsqueda de Gerbes                                                                                                                                                     |
| `delivery_zip`     | cadena             | no        | La entrega al código postal se cotiza para                                                                                                                                                   |
| `fulfillment_type` | cadena             | no        | Filtro de entrega, recogida o envío a domicilio                                                                                                                                              |
| `store_id`         | cadena             | no        | La tienda cuyo catálogo y precios se devuelven                                                                                                                                               |
| `output`           | arreglo de cadenas | no        | Formatos a devolver: `Markdown`, `HTML`, `json`, `screenshot`. por defecto `["html"]`. `json` devuelve los campos analizados. `screenshot` requiere `run_js: true`                           |
| `json`             | objeto             | no        | Extracción personalizada: `{"prompt": string}` o `{"schema": object}`, nunca ambos. Anula el analizador integrado                                                                            |
| `location`         | cadena             | no        | Código de país de dos letras para obtener, por ejemplo `DE`                                                                                                                                  |
| `device`           | cadena             | no        | `escritorio` (predeterminado) o `móvil`                                                                                                                                                      |
| `run_js`           | booleano           | no        | Ejecuta el JavaScript de la página antes de capturar. Más lento — use un tiempo de espera del cliente de 120 segundos o más                                                                  |
| `callback_url`     | cadena             | no        | URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con `400`                                                                                        |
| `storage`          | objeto             | no        | Entrega el resultado a un bucket en lugar de la respuesta: `{"type": string, "url": string}`. `type` es `s3`, `s3_gzip`, `s3_compatible`, `gcs`, o `tos`. Solo asíncrono. `url` no se valida |

#### `POST /v1/scrape/gerbes/product`

Devuelve el precio, el stock y los detalles de un producto de Gerbes.

**Modos:** sincrónico · asincrónico

| Nombre             | Tipo               | Requerido | Descripción                                                                                                                                                                                  |
| ------------------ | ------------------ | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`            | cadena             | sí        | ID del producto                                                                                                                                                                              |
| `delivery_zip`     | cadena             | no        | La entrega al código postal se cotiza para                                                                                                                                                   |
| `fulfillment_type` | cadena             | no        | Filtro de entrega, recogida o envío a domicilio                                                                                                                                              |
| `store_id`         | cadena             | no        | La tienda cuyo catálogo y precios se devuelven                                                                                                                                               |
| `output`           | arreglo de cadenas | no        | Formatos a devolver: `Markdown`, `HTML`, `json`, `screenshot`. por defecto `["html"]`. `json` devuelve los campos analizados. `screenshot` requiere `run_js: true`                           |
| `json`             | objeto             | no        | Extracción personalizada: `{"prompt": string}` o `{"schema": object}`, nunca ambos. Anula el analizador integrado                                                                            |
| `location`         | cadena             | no        | Código de país de dos letras para obtener, por ejemplo `DE`                                                                                                                                  |
| `device`           | cadena             | no        | `escritorio` (predeterminado) o `móvil`                                                                                                                                                      |
| `run_js`           | booleano           | no        | Ejecuta el JavaScript de la página antes de capturar. Más lento — use un tiempo de espera del cliente de 120 segundos o más                                                                  |
| `callback_url`     | cadena             | no        | URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con `400`                                                                                        |
| `storage`          | objeto             | no        | Entrega el resultado a un bucket en lugar de la respuesta: `{"type": string, "url": string}`. `type` es `s3`, `s3_gzip`, `s3_compatible`, `gcs`, o `tos`. Solo asíncrono. `url` no se valida |

#### `POST /v1/scrape/gerbes/search`

Devuelve resultados de búsqueda de Gerbes para una palabra clave.

**Modos:** sincrónico · asincrónico

| Nombre             | Tipo               | Requerido | Descripción                                                                                                                                                                                  |
| ------------------ | ------------------ | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`            | cadena             | sí        | Palabra clave de búsqueda                                                                                                                                                                    |
| `brand`            | cadena             | no        | Restringe los resultados a una marca                                                                                                                                                         |
| `delivery_zip`     | cadena             | no        | La entrega al código postal se cotiza para                                                                                                                                                   |
| `fulfillment_type` | cadena             | no        | Filtro de entrega, recogida o envío a domicilio                                                                                                                                              |
| `price_range`      | cadena             | no        | Filtro de banda de precios                                                                                                                                                                   |
| `store_id`         | cadena             | no        | La tienda cuyo catálogo y precios se devuelven                                                                                                                                               |
| `output`           | arreglo de cadenas | no        | Formatos a devolver: `Markdown`, `HTML`, `json`, `screenshot`. por defecto `["html"]`. `json` devuelve los campos analizados. `screenshot` requiere `run_js: true`                           |
| `json`             | objeto             | no        | Extracción personalizada: `{"prompt": string}` o `{"schema": object}`, nunca ambos. Anula el analizador integrado                                                                            |
| `location`         | cadena             | no        | Código de país de dos letras para obtener, por ejemplo `DE`                                                                                                                                  |
| `device`           | cadena             | no        | `escritorio` (predeterminado) o `móvil`                                                                                                                                                      |
| `run_js`           | booleano           | no        | Ejecuta el JavaScript de la página antes de capturar. Más lento — use un tiempo de espera del cliente de 120 segundos o más                                                                  |
| `callback_url`     | cadena             | no        | URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con `400`                                                                                        |
| `storage`          | objeto             | no        | Entrega el resultado a un bucket en lugar de la respuesta: `{"type": string, "url": string}`. `type` es `s3`, `s3_gzip`, `s3_compatible`, `gcs`, o `tos`. Solo asíncrono. `url` no se valida |

***

### Grainger

#### `POST /v1/scrape/grainger`

Devuelve los campos analizados de una página de Grainger a partir de una URL que proporciones.

**Modos:** sincrónico · asincrónico

| Nombre         | Tipo               | Requerido | Descripción                                                                                                                                                                                  |
| -------------- | ------------------ | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `url`          | cadena             | sí        | Una URL de producto o búsqueda de Grainger                                                                                                                                                   |
| `output`       | arreglo de cadenas | no        | Formatos a devolver: `Markdown`, `HTML`, `json`, `screenshot`. por defecto `["html"]`. `json` devuelve los campos analizados. `screenshot` requiere `run_js: true`                           |
| `json`         | objeto             | no        | Extracción personalizada: `{"prompt": string}` o `{"schema": object}`, nunca ambos. Anula el analizador integrado                                                                            |
| `location`     | cadena             | no        | Código de país de dos letras para obtener, por ejemplo `DE`                                                                                                                                  |
| `device`       | cadena             | no        | `escritorio` (predeterminado) o `móvil`                                                                                                                                                      |
| `run_js`       | booleano           | no        | Ejecuta el JavaScript de la página antes de capturar. Más lento — use un tiempo de espera del cliente de 120 segundos o más                                                                  |
| `callback_url` | cadena             | no        | URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con `400`                                                                                        |
| `storage`      | objeto             | no        | Entrega el resultado a un bucket en lugar de la respuesta: `{"type": string, "url": string}`. `type` es `s3`, `s3_gzip`, `s3_compatible`, `gcs`, o `tos`. Solo asíncrono. `url` no se valida |

#### `POST /v1/scrape/grainger/product`

Devuelve el precio, el stock y los detalles de un producto de Grainger.

**Modos:** sincrónico · asincrónico

| Nombre         | Tipo               | Requerido | Descripción                                                                                                                                                                                  |
| -------------- | ------------------ | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`        | cadena             | sí        | ID del producto                                                                                                                                                                              |
| `domain`       | cadena             | no        | TLD de la tienda                                                                                                                                                                             |
| `output`       | arreglo de cadenas | no        | Formatos a devolver: `Markdown`, `HTML`, `json`, `screenshot`. por defecto `["html"]`. `json` devuelve los campos analizados. `screenshot` requiere `run_js: true`                           |
| `json`         | objeto             | no        | Extracción personalizada: `{"prompt": string}` o `{"schema": object}`, nunca ambos. Anula el analizador integrado                                                                            |
| `location`     | cadena             | no        | Código de país de dos letras para obtener, por ejemplo `DE`                                                                                                                                  |
| `device`       | cadena             | no        | `escritorio` (predeterminado) o `móvil`                                                                                                                                                      |
| `run_js`       | booleano           | no        | Ejecuta el JavaScript de la página antes de capturar. Más lento — use un tiempo de espera del cliente de 120 segundos o más                                                                  |
| `callback_url` | cadena             | no        | URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con `400`                                                                                        |
| `storage`      | objeto             | no        | Entrega el resultado a un bucket en lugar de la respuesta: `{"type": string, "url": string}`. `type` es `s3`, `s3_gzip`, `s3_compatible`, `gcs`, o `tos`. Solo asíncrono. `url` no se valida |

#### `POST /v1/scrape/grainger/search`

Devuelve resultados de búsqueda de Grainger para una palabra clave.

**Modos:** sincrónico · asincrónico

| Nombre         | Tipo               | Requerido | Descripción                                                                                                                                                                                  |
| -------------- | ------------------ | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`        | cadena             | sí        | Palabra clave de búsqueda                                                                                                                                                                    |
| `domain`       | cadena             | no        | TLD de la tienda                                                                                                                                                                             |
| `output`       | arreglo de cadenas | no        | Formatos a devolver: `Markdown`, `HTML`, `json`, `screenshot`. por defecto `["html"]`. `json` devuelve los campos analizados. `screenshot` requiere `run_js: true`                           |
| `json`         | objeto             | no        | Extracción personalizada: `{"prompt": string}` o `{"schema": object}`, nunca ambos. Anula el analizador integrado                                                                            |
| `location`     | cadena             | no        | Código de país de dos letras para obtener, por ejemplo `DE`                                                                                                                                  |
| `device`       | cadena             | no        | `escritorio` (predeterminado) o `móvil`                                                                                                                                                      |
| `run_js`       | booleano           | no        | Ejecuta el JavaScript de la página antes de capturar. Más lento — use un tiempo de espera del cliente de 120 segundos o más                                                                  |
| `callback_url` | cadena             | no        | URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con `400`                                                                                        |
| `storage`      | objeto             | no        | Entrega el resultado a un bucket en lugar de la respuesta: `{"type": string, "url": string}`. `type` es `s3`, `s3_gzip`, `s3_compatible`, `gcs`, o `tos`. Solo asíncrono. `url` no se valida |

***

### Harris Teeter

#### `POST /v1/scrape/harristeeter`

Devuelve los campos analizados de una página de Harris Teeter a partir de una URL que proporciones.

**Modos:** sincrónico · asincrónico

| Nombre             | Tipo               | Requerido | Descripción                                                                                                                                                                                  |
| ------------------ | ------------------ | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `url`              | cadena             | sí        | Una URL de producto o búsqueda de Harris Teeter                                                                                                                                              |
| `delivery_zip`     | cadena             | no        | La entrega al código postal se cotiza para                                                                                                                                                   |
| `fulfillment_type` | cadena             | no        | Filtro de entrega, recogida o envío a domicilio                                                                                                                                              |
| `store_id`         | cadena             | no        | La tienda cuyo catálogo y precios se devuelven                                                                                                                                               |
| `output`           | arreglo de cadenas | no        | Formatos a devolver: `Markdown`, `HTML`, `json`, `screenshot`. por defecto `["html"]`. `json` devuelve los campos analizados. `screenshot` requiere `run_js: true`                           |
| `json`             | objeto             | no        | Extracción personalizada: `{"prompt": string}` o `{"schema": object}`, nunca ambos. Anula el analizador integrado                                                                            |
| `location`         | cadena             | no        | Código de país de dos letras para obtener, por ejemplo `DE`                                                                                                                                  |
| `device`           | cadena             | no        | `escritorio` (predeterminado) o `móvil`                                                                                                                                                      |
| `run_js`           | booleano           | no        | Ejecuta el JavaScript de la página antes de capturar. Más lento — use un tiempo de espera del cliente de 120 segundos o más                                                                  |
| `callback_url`     | cadena             | no        | URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con `400`                                                                                        |
| `storage`          | objeto             | no        | Entrega el resultado a un bucket en lugar de la respuesta: `{"type": string, "url": string}`. `type` es `s3`, `s3_gzip`, `s3_compatible`, `gcs`, o `tos`. Solo asíncrono. `url` no se valida |

#### `POST /v1/scrape/harristeeter/product`

Devuelve el precio, el stock y los detalles de un producto de Harris Teeter.

**Modos:** sincrónico · asincrónico

| Nombre             | Tipo               | Requerido | Descripción                                                                                                                                                                                  |
| ------------------ | ------------------ | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`            | cadena             | sí        | ID del producto                                                                                                                                                                              |
| `delivery_zip`     | cadena             | no        | La entrega al código postal se cotiza para                                                                                                                                                   |
| `fulfillment_type` | cadena             | no        | Filtro de entrega, recogida o envío a domicilio                                                                                                                                              |
| `store_id`         | cadena             | no        | La tienda cuyo catálogo y precios se devuelven                                                                                                                                               |
| `output`           | arreglo de cadenas | no        | Formatos a devolver: `Markdown`, `HTML`, `json`, `screenshot`. por defecto `["html"]`. `json` devuelve los campos analizados. `screenshot` requiere `run_js: true`                           |
| `json`             | objeto             | no        | Extracción personalizada: `{"prompt": string}` o `{"schema": object}`, nunca ambos. Anula el analizador integrado                                                                            |
| `location`         | cadena             | no        | Código de país de dos letras para obtener, por ejemplo `DE`                                                                                                                                  |
| `device`           | cadena             | no        | `escritorio` (predeterminado) o `móvil`                                                                                                                                                      |
| `run_js`           | booleano           | no        | Ejecuta el JavaScript de la página antes de capturar. Más lento — use un tiempo de espera del cliente de 120 segundos o más                                                                  |
| `callback_url`     | cadena             | no        | URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con `400`                                                                                        |
| `storage`          | objeto             | no        | Entrega el resultado a un bucket en lugar de la respuesta: `{"type": string, "url": string}`. `type` es `s3`, `s3_gzip`, `s3_compatible`, `gcs`, o `tos`. Solo asíncrono. `url` no se valida |

#### `POST /v1/scrape/harristeeter/search`

Devuelve resultados de búsqueda de Harris Teeter para una palabra clave.

**Modos:** sincrónico · asincrónico

| Nombre             | Tipo               | Requerido | Descripción                                                                                                                                                                                  |
| ------------------ | ------------------ | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`            | cadena             | sí        | Palabra clave de búsqueda                                                                                                                                                                    |
| `brand`            | cadena             | no        | Restringe los resultados a una marca                                                                                                                                                         |
| `delivery_zip`     | cadena             | no        | La entrega al código postal se cotiza para                                                                                                                                                   |
| `fulfillment_type` | cadena             | no        | Filtro de entrega, recogida o envío a domicilio                                                                                                                                              |
| `price_range`      | cadena             | no        | Filtro de banda de precios                                                                                                                                                                   |
| `store_id`         | cadena             | no        | La tienda cuyo catálogo y precios se devuelven                                                                                                                                               |
| `output`           | arreglo de cadenas | no        | Formatos a devolver: `Markdown`, `HTML`, `json`, `screenshot`. por defecto `["html"]`. `json` devuelve los campos analizados. `screenshot` requiere `run_js: true`                           |
| `json`             | objeto             | no        | Extracción personalizada: `{"prompt": string}` o `{"schema": object}`, nunca ambos. Anula el analizador integrado                                                                            |
| `location`         | cadena             | no        | Código de país de dos letras para obtener, por ejemplo `DE`                                                                                                                                  |
| `device`           | cadena             | no        | `escritorio` (predeterminado) o `móvil`                                                                                                                                                      |
| `run_js`           | booleano           | no        | Ejecuta el JavaScript de la página antes de capturar. Más lento — use un tiempo de espera del cliente de 120 segundos o más                                                                  |
| `callback_url`     | cadena             | no        | URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con `400`                                                                                        |
| `storage`          | objeto             | no        | Entrega el resultado a un bucket en lugar de la respuesta: `{"type": string, "url": string}`. `type` es `s3`, `s3_gzip`, `s3_compatible`, `gcs`, o `tos`. Solo asíncrono. `url` no se valida |

***

### Idealo

#### `POST /v1/scrape/idealo/search`

Devuelve resultados de búsqueda de Idealo para una palabra clave.

**Modos:** sincrónico · asincrónico

| Nombre         | Tipo               | Requerido | Descripción                                                                                                                                                                                  |
| -------------- | ------------------ | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`        | cadena             | sí        | Palabra clave de búsqueda                                                                                                                                                                    |
| `domain`       | cadena             | no        | TLD de la tienda                                                                                                                                                                             |
| `output`       | arreglo de cadenas | no        | Formatos a devolver: `Markdown`, `HTML`, `json`, `screenshot`. por defecto `["html"]`. `json` devuelve los campos analizados. `screenshot` requiere `run_js: true`                           |
| `json`         | objeto             | no        | Extracción personalizada: `{"prompt": string}` o `{"schema": object}`, nunca ambos. Anula el analizador integrado                                                                            |
| `location`     | cadena             | no        | Código de país de dos letras para obtener, por ejemplo `DE`                                                                                                                                  |
| `device`       | cadena             | no        | `escritorio` (predeterminado) o `móvil`                                                                                                                                                      |
| `run_js`       | booleano           | no        | Ejecuta el JavaScript de la página antes de capturar. Más lento — use un tiempo de espera del cliente de 120 segundos o más                                                                  |
| `callback_url` | cadena             | no        | URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con `400`                                                                                        |
| `storage`      | objeto             | no        | Entrega el resultado a un bucket en lugar de la respuesta: `{"type": string, "url": string}`. `type` es `s3`, `s3_gzip`, `s3_compatible`, `gcs`, o `tos`. Solo asíncrono. `url` no se valida |

***

### Indiamart

#### `POST /v1/scrape/indiamart`

Devuelve los campos analizados de una página de Indiamart a partir de una URL que proporciones.

**Modos:** sincrónico · asincrónico

| Nombre         | Tipo               | Requerido | Descripción                                                                                                                                                                                  |
| -------------- | ------------------ | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `url`          | cadena             | sí        | Una URL de producto o búsqueda de Indiamart                                                                                                                                                  |
| `output`       | arreglo de cadenas | no        | Formatos a devolver: `Markdown`, `HTML`, `json`, `screenshot`. por defecto `["html"]`. `json` devuelve los campos analizados. `screenshot` requiere `run_js: true`                           |
| `json`         | objeto             | no        | Extracción personalizada: `{"prompt": string}` o `{"schema": object}`, nunca ambos. Anula el analizador integrado                                                                            |
| `location`     | cadena             | no        | Código de país de dos letras para obtener, por ejemplo `DE`                                                                                                                                  |
| `device`       | cadena             | no        | `escritorio` (predeterminado) o `móvil`                                                                                                                                                      |
| `run_js`       | booleano           | no        | Ejecuta el JavaScript de la página antes de capturar. Más lento — use un tiempo de espera del cliente de 120 segundos o más                                                                  |
| `callback_url` | cadena             | no        | URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con `400`                                                                                        |
| `storage`      | objeto             | no        | Entrega el resultado a un bucket en lugar de la respuesta: `{"type": string, "url": string}`. `type` es `s3`, `s3_gzip`, `s3_compatible`, `gcs`, o `tos`. Solo asíncrono. `url` no se valida |

#### `POST /v1/scrape/indiamart/product`

Devuelve el precio, el stock y los detalles de un producto de Indiamart.

**Modos:** sincrónico · asincrónico

| Nombre         | Tipo               | Requerido | Descripción                                                                                                                                                                                  |
| -------------- | ------------------ | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`        | cadena             | sí        | ID del producto                                                                                                                                                                              |
| `domain`       | cadena             | no        | TLD de la tienda                                                                                                                                                                             |
| `output`       | arreglo de cadenas | no        | Formatos a devolver: `Markdown`, `HTML`, `json`, `screenshot`. por defecto `["html"]`. `json` devuelve los campos analizados. `screenshot` requiere `run_js: true`                           |
| `json`         | objeto             | no        | Extracción personalizada: `{"prompt": string}` o `{"schema": object}`, nunca ambos. Anula el analizador integrado                                                                            |
| `location`     | cadena             | no        | Código de país de dos letras para obtener, por ejemplo `DE`                                                                                                                                  |
| `device`       | cadena             | no        | `escritorio` (predeterminado) o `móvil`                                                                                                                                                      |
| `run_js`       | booleano           | no        | Ejecuta el JavaScript de la página antes de capturar. Más lento — use un tiempo de espera del cliente de 120 segundos o más                                                                  |
| `callback_url` | cadena             | no        | URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con `400`                                                                                        |
| `storage`      | objeto             | no        | Entrega el resultado a un bucket en lugar de la respuesta: `{"type": string, "url": string}`. `type` es `s3`, `s3_gzip`, `s3_compatible`, `gcs`, o `tos`. Solo asíncrono. `url` no se valida |

#### `POST /v1/scrape/indiamart/search`

Devuelve resultados de búsqueda de Indiamart para una palabra clave.

**Modos:** sincrónico · asincrónico

| Nombre         | Tipo               | Requerido | Descripción                                                                                                                                                                                  |
| -------------- | ------------------ | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`        | cadena             | sí        | Palabra clave de búsqueda                                                                                                                                                                    |
| `domain`       | cadena             | no        | TLD de la tienda                                                                                                                                                                             |
| `output`       | arreglo de cadenas | no        | Formatos a devolver: `Markdown`, `HTML`, `json`, `screenshot`. por defecto `["html"]`. `json` devuelve los campos analizados. `screenshot` requiere `run_js: true`                           |
| `json`         | objeto             | no        | Extracción personalizada: `{"prompt": string}` o `{"schema": object}`, nunca ambos. Anula el analizador integrado                                                                            |
| `location`     | cadena             | no        | Código de país de dos letras para obtener, por ejemplo `DE`                                                                                                                                  |
| `device`       | cadena             | no        | `escritorio` (predeterminado) o `móvil`                                                                                                                                                      |
| `run_js`       | booleano           | no        | Ejecuta el JavaScript de la página antes de capturar. Más lento — use un tiempo de espera del cliente de 120 segundos o más                                                                  |
| `callback_url` | cadena             | no        | URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con `400`                                                                                        |
| `storage`      | objeto             | no        | Entrega el resultado a un bucket en lugar de la respuesta: `{"type": string, "url": string}`. `type` es `s3`, `s3_gzip`, `s3_compatible`, `gcs`, o `tos`. Solo asíncrono. `url` no se valida |

***

### Instacart

#### `POST /v1/scrape/instacart`

Devuelve los campos analizados de una página de Instacart a partir de una URL que proporciones.

**Modos:** sincrónico · asincrónico

| Nombre         | Tipo               | Requerido | Descripción                                                                                                                                                                                  |
| -------------- | ------------------ | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `url`          | cadena             | sí        | Una URL de producto o búsqueda de Instacart                                                                                                                                                  |
| `output`       | arreglo de cadenas | no        | Formatos a devolver: `Markdown`, `HTML`, `json`, `screenshot`. por defecto `["html"]`. `json` devuelve los campos analizados. `screenshot` requiere `run_js: true`                           |
| `json`         | objeto             | no        | Extracción personalizada: `{"prompt": string}` o `{"schema": object}`, nunca ambos. Anula el analizador integrado                                                                            |
| `location`     | cadena             | no        | Código de país de dos letras para obtener, por ejemplo `DE`                                                                                                                                  |
| `device`       | cadena             | no        | `escritorio` (predeterminado) o `móvil`                                                                                                                                                      |
| `run_js`       | booleano           | no        | Ejecuta el JavaScript de la página antes de capturar. Más lento — use un tiempo de espera del cliente de 120 segundos o más                                                                  |
| `callback_url` | cadena             | no        | URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con `400`                                                                                        |
| `storage`      | objeto             | no        | Entrega el resultado a un bucket en lugar de la respuesta: `{"type": string, "url": string}`. `type` es `s3`, `s3_gzip`, `s3_compatible`, `gcs`, o `tos`. Solo asíncrono. `url` no se valida |

#### `POST /v1/scrape/instacart/product`

Devuelve el precio, el stock y los detalles de un producto de Instacart.

**Modos:** sincrónico · asincrónico

| Nombre         | Tipo               | Requerido | Descripción                                                                                                                                                                                  |
| -------------- | ------------------ | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`        | cadena             | sí        | ID del producto                                                                                                                                                                              |
| `domain`       | cadena             | no        | TLD de la tienda                                                                                                                                                                             |
| `output`       | arreglo de cadenas | no        | Formatos a devolver: `Markdown`, `HTML`, `json`, `screenshot`. por defecto `["html"]`. `json` devuelve los campos analizados. `screenshot` requiere `run_js: true`                           |
| `json`         | objeto             | no        | Extracción personalizada: `{"prompt": string}` o `{"schema": object}`, nunca ambos. Anula el analizador integrado                                                                            |
| `location`     | cadena             | no        | Código de país de dos letras para obtener, por ejemplo `DE`                                                                                                                                  |
| `device`       | cadena             | no        | `escritorio` (predeterminado) o `móvil`                                                                                                                                                      |
| `run_js`       | booleano           | no        | Ejecuta el JavaScript de la página antes de capturar. Más lento — use un tiempo de espera del cliente de 120 segundos o más                                                                  |
| `callback_url` | cadena             | no        | URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con `400`                                                                                        |
| `storage`      | objeto             | no        | Entrega el resultado a un bucket en lugar de la respuesta: `{"type": string, "url": string}`. `type` es `s3`, `s3_gzip`, `s3_compatible`, `gcs`, o `tos`. Solo asíncrono. `url` no se valida |

#### `POST /v1/scrape/instacart/search`

Devuelve resultados de búsqueda de Instacart para una palabra clave.

**Modos:** sincrónico · asincrónico

| Nombre         | Tipo               | Requerido | Descripción                                                                                                                                                                                  |
| -------------- | ------------------ | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`        | cadena             | sí        | Palabra clave de búsqueda                                                                                                                                                                    |
| `domain`       | cadena             | no        | TLD de la tienda                                                                                                                                                                             |
| `output`       | arreglo de cadenas | no        | Formatos a devolver: `Markdown`, `HTML`, `json`, `screenshot`. por defecto `["html"]`. `json` devuelve los campos analizados. `screenshot` requiere `run_js: true`                           |
| `json`         | objeto             | no        | Extracción personalizada: `{"prompt": string}` o `{"schema": object}`, nunca ambos. Anula el analizador integrado                                                                            |
| `location`     | cadena             | no        | Código de país de dos letras para obtener, por ejemplo `DE`                                                                                                                                  |
| `device`       | cadena             | no        | `escritorio` (predeterminado) o `móvil`                                                                                                                                                      |
| `run_js`       | booleano           | no        | Ejecuta el JavaScript de la página antes de capturar. Más lento — use un tiempo de espera del cliente de 120 segundos o más                                                                  |
| `callback_url` | cadena             | no        | URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con `400`                                                                                        |
| `storage`      | objeto             | no        | Entrega el resultado a un bucket en lugar de la respuesta: `{"type": string, "url": string}`. `type` es `s3`, `s3_gzip`, `s3_compatible`, `gcs`, o `tos`. Solo asíncrono. `url` no se valida |

***

### King Soopers

#### `POST /v1/scrape/kingsoopers`

Devuelve los campos analizados de una página de King Soopers a partir de una URL que proporciones.

**Modos:** sincrónico · asincrónico

| Nombre             | Tipo               | Requerido | Descripción                                                                                                                                                                                  |
| ------------------ | ------------------ | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `url`              | cadena             | sí        | Una URL de producto o búsqueda de King Soopers                                                                                                                                               |
| `delivery_zip`     | cadena             | no        | La entrega al código postal se cotiza para                                                                                                                                                   |
| `fulfillment_type` | cadena             | no        | Filtro de entrega, recogida o envío a domicilio                                                                                                                                              |
| `store_id`         | cadena             | no        | La tienda cuyo catálogo y precios se devuelven                                                                                                                                               |
| `output`           | arreglo de cadenas | no        | Formatos a devolver: `Markdown`, `HTML`, `json`, `screenshot`. por defecto `["html"]`. `json` devuelve los campos analizados. `screenshot` requiere `run_js: true`                           |
| `json`             | objeto             | no        | Extracción personalizada: `{"prompt": string}` o `{"schema": object}`, nunca ambos. Anula el analizador integrado                                                                            |
| `location`         | cadena             | no        | Código de país de dos letras para obtener, por ejemplo `DE`                                                                                                                                  |
| `device`           | cadena             | no        | `escritorio` (predeterminado) o `móvil`                                                                                                                                                      |
| `run_js`           | booleano           | no        | Ejecuta el JavaScript de la página antes de capturar. Más lento — use un tiempo de espera del cliente de 120 segundos o más                                                                  |
| `callback_url`     | cadena             | no        | URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con `400`                                                                                        |
| `storage`          | objeto             | no        | Entrega el resultado a un bucket en lugar de la respuesta: `{"type": string, "url": string}`. `type` es `s3`, `s3_gzip`, `s3_compatible`, `gcs`, o `tos`. Solo asíncrono. `url` no se valida |

#### `POST /v1/scrape/kingsoopers/product`

Devuelve el precio, el stock y los detalles de un producto de King Soopers.

**Modos:** sincrónico · asincrónico

| Nombre             | Tipo               | Requerido | Descripción                                                                                                                                                                                  |
| ------------------ | ------------------ | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`            | cadena             | sí        | ID del producto                                                                                                                                                                              |
| `delivery_zip`     | cadena             | no        | La entrega al código postal se cotiza para                                                                                                                                                   |
| `fulfillment_type` | cadena             | no        | Filtro de entrega, recogida o envío a domicilio                                                                                                                                              |
| `store_id`         | cadena             | no        | La tienda cuyo catálogo y precios se devuelven                                                                                                                                               |
| `output`           | arreglo de cadenas | no        | Formatos a devolver: `Markdown`, `HTML`, `json`, `screenshot`. por defecto `["html"]`. `json` devuelve los campos analizados. `screenshot` requiere `run_js: true`                           |
| `json`             | objeto             | no        | Extracción personalizada: `{"prompt": string}` o `{"schema": object}`, nunca ambos. Anula el analizador integrado                                                                            |
| `location`         | cadena             | no        | Código de país de dos letras para obtener, por ejemplo `DE`                                                                                                                                  |
| `device`           | cadena             | no        | `escritorio` (predeterminado) o `móvil`                                                                                                                                                      |
| `run_js`           | booleano           | no        | Ejecuta el JavaScript de la página antes de capturar. Más lento — use un tiempo de espera del cliente de 120 segundos o más                                                                  |
| `callback_url`     | cadena             | no        | URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con `400`                                                                                        |
| `storage`          | objeto             | no        | Entrega el resultado a un bucket en lugar de la respuesta: `{"type": string, "url": string}`. `type` es `s3`, `s3_gzip`, `s3_compatible`, `gcs`, o `tos`. Solo asíncrono. `url` no se valida |

#### `POST /v1/scrape/kingsoopers/search`

Devuelve resultados de búsqueda de King Soopers para una palabra clave.

**Modos:** sincrónico · asincrónico

| Nombre             | Tipo               | Requerido | Descripción                                                                                                                                                                                  |
| ------------------ | ------------------ | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`            | cadena             | sí        | Palabra clave de búsqueda                                                                                                                                                                    |
| `brand`            | cadena             | no        | Restringe los resultados a una marca                                                                                                                                                         |
| `delivery_zip`     | cadena             | no        | La entrega al código postal se cotiza para                                                                                                                                                   |
| `fulfillment_type` | cadena             | no        | Filtro de entrega, recogida o envío a domicilio                                                                                                                                              |
| `price_range`      | cadena             | no        | Filtro de banda de precios                                                                                                                                                                   |
| `store_id`         | cadena             | no        | La tienda cuyo catálogo y precios se devuelven                                                                                                                                               |
| `output`           | arreglo de cadenas | no        | Formatos a devolver: `Markdown`, `HTML`, `json`, `screenshot`. por defecto `["html"]`. `json` devuelve los campos analizados. `screenshot` requiere `run_js: true`                           |
| `json`             | objeto             | no        | Extracción personalizada: `{"prompt": string}` o `{"schema": object}`, nunca ambos. Anula el analizador integrado                                                                            |
| `location`         | cadena             | no        | Código de país de dos letras para obtener, por ejemplo `DE`                                                                                                                                  |
| `device`           | cadena             | no        | `escritorio` (predeterminado) o `móvil`                                                                                                                                                      |
| `run_js`           | booleano           | no        | Ejecuta el JavaScript de la página antes de capturar. Más lento — use un tiempo de espera del cliente de 120 segundos o más                                                                  |
| `callback_url`     | cadena             | no        | URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con `400`                                                                                        |
| `storage`          | objeto             | no        | Entrega el resultado a un bucket en lugar de la respuesta: `{"type": string, "url": string}`. `type` es `s3`, `s3_gzip`, `s3_compatible`, `gcs`, o `tos`. Solo asíncrono. `url` no se valida |

***

### Kroger

#### `POST /v1/scrape/kroger`

Devuelve los campos analizados de una página de Kroger a partir de una URL que proporciones.

**Modos:** sincrónico · asincrónico

| Nombre             | Tipo               | Requerido | Descripción                                                                                                                                                                                  |
| ------------------ | ------------------ | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `url`              | cadena             | sí        | Una URL de producto o búsqueda de Kroger                                                                                                                                                     |
| `delivery_zip`     | cadena             | no        | La entrega al código postal se cotiza para                                                                                                                                                   |
| `fulfillment_type` | cadena             | no        | Filtro de entrega, recogida o envío a domicilio                                                                                                                                              |
| `store_id`         | cadena             | no        | La tienda cuyo catálogo y precios se devuelven                                                                                                                                               |
| `output`           | arreglo de cadenas | no        | Formatos a devolver: `Markdown`, `HTML`, `json`, `screenshot`. por defecto `["html"]`. `json` devuelve los campos analizados. `screenshot` requiere `run_js: true`                           |
| `json`             | objeto             | no        | Extracción personalizada: `{"prompt": string}` o `{"schema": object}`, nunca ambos. Anula el analizador integrado                                                                            |
| `location`         | cadena             | no        | Código de país de dos letras para obtener, por ejemplo `DE`                                                                                                                                  |
| `device`           | cadena             | no        | `escritorio` (predeterminado) o `móvil`                                                                                                                                                      |
| `run_js`           | booleano           | no        | Ejecuta el JavaScript de la página antes de capturar. Más lento — use un tiempo de espera del cliente de 120 segundos o más                                                                  |
| `callback_url`     | cadena             | no        | URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con `400`                                                                                        |
| `storage`          | objeto             | no        | Entrega el resultado a un bucket en lugar de la respuesta: `{"type": string, "url": string}`. `type` es `s3`, `s3_gzip`, `s3_compatible`, `gcs`, o `tos`. Solo asíncrono. `url` no se valida |

#### `POST /v1/scrape/kroger/product`

Devuelve el precio, el stock y los detalles de un producto de Kroger.

**Modos:** sincrónico · asincrónico

| Nombre             | Tipo               | Requerido | Descripción                                                                                                                                                                                  |
| ------------------ | ------------------ | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`            | cadena             | sí        | ID del producto                                                                                                                                                                              |
| `delivery_zip`     | cadena             | no        | La entrega al código postal se cotiza para                                                                                                                                                   |
| `fulfillment_type` | cadena             | no        | Filtro de entrega, recogida o envío a domicilio                                                                                                                                              |
| `store_id`         | cadena             | no        | La tienda cuyo catálogo y precios se devuelven                                                                                                                                               |
| `output`           | arreglo de cadenas | no        | Formatos a devolver: `Markdown`, `HTML`, `json`, `screenshot`. por defecto `["html"]`. `json` devuelve los campos analizados. `screenshot` requiere `run_js: true`                           |
| `json`             | objeto             | no        | Extracción personalizada: `{"prompt": string}` o `{"schema": object}`, nunca ambos. Anula el analizador integrado                                                                            |
| `location`         | cadena             | no        | Código de país de dos letras para obtener, por ejemplo `DE`                                                                                                                                  |
| `device`           | cadena             | no        | `escritorio` (predeterminado) o `móvil`                                                                                                                                                      |
| `run_js`           | booleano           | no        | Ejecuta el JavaScript de la página antes de capturar. Más lento — use un tiempo de espera del cliente de 120 segundos o más                                                                  |
| `callback_url`     | cadena             | no        | URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con `400`                                                                                        |
| `storage`          | objeto             | no        | Entrega el resultado a un bucket en lugar de la respuesta: `{"type": string, "url": string}`. `type` es `s3`, `s3_gzip`, `s3_compatible`, `gcs`, o `tos`. Solo asíncrono. `url` no se valida |

#### `POST /v1/scrape/kroger/search`

Devuelve resultados de búsqueda de Kroger para una palabra clave.

**Modos:** sincrónico · asincrónico

| Nombre             | Tipo               | Requerido | Descripción                                                                                                                                                                                  |
| ------------------ | ------------------ | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`            | cadena             | sí        | Palabra clave de búsqueda                                                                                                                                                                    |
| `brand`            | cadena             | no        | Restringe los resultados a una marca                                                                                                                                                         |
| `delivery_zip`     | cadena             | no        | La entrega al código postal se cotiza para                                                                                                                                                   |
| `fulfillment_type` | cadena             | no        | Filtro de entrega, recogida o envío a domicilio                                                                                                                                              |
| `price_range`      | cadena             | no        | Filtro de banda de precios                                                                                                                                                                   |
| `store_id`         | cadena             | no        | La tienda cuyo catálogo y precios se devuelven                                                                                                                                               |
| `output`           | arreglo de cadenas | no        | Formatos a devolver: `Markdown`, `HTML`, `json`, `screenshot`. por defecto `["html"]`. `json` devuelve los campos analizados. `screenshot` requiere `run_js: true`                           |
| `json`             | objeto             | no        | Extracción personalizada: `{"prompt": string}` o `{"schema": object}`, nunca ambos. Anula el analizador integrado                                                                            |
| `location`         | cadena             | no        | Código de país de dos letras para obtener, por ejemplo `DE`                                                                                                                                  |
| `device`           | cadena             | no        | `escritorio` (predeterminado) o `móvil`                                                                                                                                                      |
| `run_js`           | booleano           | no        | Ejecuta el JavaScript de la página antes de capturar. Más lento — use un tiempo de espera del cliente de 120 segundos o más                                                                  |
| `callback_url`     | cadena             | no        | URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con `400`                                                                                        |
| `storage`          | objeto             | no        | Entrega el resultado a un bucket en lugar de la respuesta: `{"type": string, "url": string}`. `type` es `s3`, `s3_gzip`, `s3_compatible`, `gcs`, o `tos`. Solo asíncrono. `url` no se valida |

***

### Lazada

#### `POST /v1/scrape/lazada`

Devuelve los campos analizados de una página de Lazada a partir de una URL que proporciones.

**Modos:** sincrónico · asincrónico

| Nombre         | Tipo               | Requerido | Descripción                                                                                                                                                                                  |
| -------------- | ------------------ | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `url`          | cadena             | sí        | Una URL de producto o búsqueda de Lazada                                                                                                                                                     |
| `start_page`   | entero             | no        | Primera página de resultados                                                                                                                                                                 |
| `output`       | arreglo de cadenas | no        | Formatos a devolver: `Markdown`, `HTML`, `json`, `screenshot`. por defecto `["html"]`. `json` devuelve los campos analizados. `screenshot` requiere `run_js: true`                           |
| `json`         | objeto             | no        | Extracción personalizada: `{"prompt": string}` o `{"schema": object}`, nunca ambos. Anula el analizador integrado                                                                            |
| `location`     | cadena             | no        | Código de país de dos letras para obtener, por ejemplo `DE`                                                                                                                                  |
| `device`       | cadena             | no        | `escritorio` (predeterminado) o `móvil`                                                                                                                                                      |
| `run_js`       | booleano           | no        | Ejecuta el JavaScript de la página antes de capturar. Más lento — use un tiempo de espera del cliente de 120 segundos o más                                                                  |
| `callback_url` | cadena             | no        | URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con `400`                                                                                        |
| `storage`      | objeto             | no        | Entrega el resultado a un bucket en lugar de la respuesta: `{"type": string, "url": string}`. `type` es `s3`, `s3_gzip`, `s3_compatible`, `gcs`, o `tos`. Solo asíncrono. `url` no se valida |

#### `POST /v1/scrape/lazada/product`

Devuelve el precio, el stock y los detalles de un producto de Lazada.

**Modos:** sincrónico · asincrónico

| Nombre         | Tipo               | Requerido | Descripción                                                                                                                                                                                  |
| -------------- | ------------------ | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`        | cadena             | sí        | ID del producto                                                                                                                                                                              |
| `domain`       | cadena             | no        | TLD de la tienda                                                                                                                                                                             |
| `output`       | arreglo de cadenas | no        | Formatos a devolver: `Markdown`, `HTML`, `json`, `screenshot`. por defecto `["html"]`. `json` devuelve los campos analizados. `screenshot` requiere `run_js: true`                           |
| `json`         | objeto             | no        | Extracción personalizada: `{"prompt": string}` o `{"schema": object}`, nunca ambos. Anula el analizador integrado                                                                            |
| `location`     | cadena             | no        | Código de país de dos letras para obtener, por ejemplo `DE`                                                                                                                                  |
| `device`       | cadena             | no        | `escritorio` (predeterminado) o `móvil`                                                                                                                                                      |
| `run_js`       | booleano           | no        | Ejecuta el JavaScript de la página antes de capturar. Más lento — use un tiempo de espera del cliente de 120 segundos o más                                                                  |
| `callback_url` | cadena             | no        | URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con `400`                                                                                        |
| `storage`      | objeto             | no        | Entrega el resultado a un bucket en lugar de la respuesta: `{"type": string, "url": string}`. `type` es `s3`, `s3_gzip`, `s3_compatible`, `gcs`, o `tos`. Solo asíncrono. `url` no se valida |

#### `POST /v1/scrape/lazada/search`

Devuelve resultados de búsqueda de Lazada para una palabra clave.

**Modos:** sincrónico · asincrónico

| Nombre         | Tipo               | Requerido | Descripción                                                                                                                                                                                  |
| -------------- | ------------------ | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`        | cadena             | sí        | Palabra clave de búsqueda                                                                                                                                                                    |
| `domain`       | cadena             | no        | TLD de la tienda                                                                                                                                                                             |
| `start_page`   | entero             | no        | Primera página de resultados                                                                                                                                                                 |
| `output`       | arreglo de cadenas | no        | Formatos a devolver: `Markdown`, `HTML`, `json`, `screenshot`. por defecto `["html"]`. `json` devuelve los campos analizados. `screenshot` requiere `run_js: true`                           |
| `json`         | objeto             | no        | Extracción personalizada: `{"prompt": string}` o `{"schema": object}`, nunca ambos. Anula el analizador integrado                                                                            |
| `location`     | cadena             | no        | Código de país de dos letras para obtener, por ejemplo `DE`                                                                                                                                  |
| `device`       | cadena             | no        | `escritorio` (predeterminado) o `móvil`                                                                                                                                                      |
| `run_js`       | booleano           | no        | Ejecuta el JavaScript de la página antes de capturar. Más lento — use un tiempo de espera del cliente de 120 segundos o más                                                                  |
| `callback_url` | cadena             | no        | URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con `400`                                                                                        |
| `storage`      | objeto             | no        | Entrega el resultado a un bucket en lugar de la respuesta: `{"type": string, "url": string}`. `type` es `s3`, `s3_gzip`, `s3_compatible`, `gcs`, o `tos`. Solo asíncrono. `url` no se valida |

***

### Lowe's

#### `POST /v1/scrape/lowes`

Devuelve los campos analizados de una página de Lowe's a partir de una URL que proporciones.

**Modos:** sincrónico · asincrónico

| Nombre         | Tipo               | Requerido | Descripción                                                                                                                                                                                  |
| -------------- | ------------------ | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `url`          | cadena             | sí        | Una URL de producto o búsqueda de Lowe's                                                                                                                                                     |
| `delivery_zip` | cadena             | no        | La entrega al código postal se cotiza para                                                                                                                                                   |
| `store_id`     | cadena             | no        | La tienda cuyo catálogo y precios se devuelven                                                                                                                                               |
| `output`       | arreglo de cadenas | no        | Formatos a devolver: `Markdown`, `HTML`, `json`, `screenshot`. por defecto `["html"]`. `json` devuelve los campos analizados. `screenshot` requiere `run_js: true`                           |
| `json`         | objeto             | no        | Extracción personalizada: `{"prompt": string}` o `{"schema": object}`, nunca ambos. Anula el analizador integrado                                                                            |
| `location`     | cadena             | no        | Código de país de dos letras para obtener, por ejemplo `DE`                                                                                                                                  |
| `device`       | cadena             | no        | `escritorio` (predeterminado) o `móvil`                                                                                                                                                      |
| `run_js`       | booleano           | no        | Ejecuta el JavaScript de la página antes de capturar. Más lento — use un tiempo de espera del cliente de 120 segundos o más                                                                  |
| `callback_url` | cadena             | no        | URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con `400`                                                                                        |
| `storage`      | objeto             | no        | Entrega el resultado a un bucket en lugar de la respuesta: `{"type": string, "url": string}`. `type` es `s3`, `s3_gzip`, `s3_compatible`, `gcs`, o `tos`. Solo asíncrono. `url` no se valida |

#### `POST /v1/scrape/lowes/product`

Devuelve el precio, el stock y los detalles de un producto de Lowe's.

**Modos:** sincrónico · asincrónico

| Nombre         | Tipo               | Requerido | Descripción                                                                                                                                                                                  |
| -------------- | ------------------ | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`        | cadena             | sí        | ID del producto                                                                                                                                                                              |
| `delivery_zip` | cadena             | no        | La entrega al código postal se cotiza para                                                                                                                                                   |
| `store_id`     | cadena             | no        | La tienda cuyo catálogo y precios se devuelven                                                                                                                                               |
| `output`       | arreglo de cadenas | no        | Formatos a devolver: `Markdown`, `HTML`, `json`, `screenshot`. por defecto `["html"]`. `json` devuelve los campos analizados. `screenshot` requiere `run_js: true`                           |
| `json`         | objeto             | no        | Extracción personalizada: `{"prompt": string}` o `{"schema": object}`, nunca ambos. Anula el analizador integrado                                                                            |
| `location`     | cadena             | no        | Código de país de dos letras para obtener, por ejemplo `DE`                                                                                                                                  |
| `device`       | cadena             | no        | `escritorio` (predeterminado) o `móvil`                                                                                                                                                      |
| `run_js`       | booleano           | no        | Ejecuta el JavaScript de la página antes de capturar. Más lento — use un tiempo de espera del cliente de 120 segundos o más                                                                  |
| `callback_url` | cadena             | no        | URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con `400`                                                                                        |
| `storage`      | objeto             | no        | Entrega el resultado a un bucket en lugar de la respuesta: `{"type": string, "url": string}`. `type` es `s3`, `s3_gzip`, `s3_compatible`, `gcs`, o `tos`. Solo asíncrono. `url` no se valida |

#### `POST /v1/scrape/lowes/search`

Devuelve resultados de búsqueda de Lowe's para una palabra clave.

**Modos:** sincrónico · asincrónico

| Nombre                    | Tipo               | Requerido | Descripción                                                                                                                                                                                  |
| ------------------------- | ------------------ | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`                   | cadena             | sí        | Palabra clave de búsqueda                                                                                                                                                                    |
| `delivery_today_tomorrow` | booleano           | no        | Solo artículos que pueden entregarse hoy o mañana                                                                                                                                            |
| `delivery_zip`            | cadena             | no        | La entrega al código postal se cotiza para                                                                                                                                                   |
| `domain`                  | cadena             | no        | TLD de la tienda                                                                                                                                                                             |
| `free_delivery`           | booleano           | no        | Solo artículos elegibles para entrega gratuita                                                                                                                                               |
| `pickup_today`            | booleano           | no        | Solo artículos disponibles para recogida hoy                                                                                                                                                 |
| `store_id`                | cadena             | no        | La tienda cuyo catálogo y precios se devuelven                                                                                                                                               |
| `output`                  | arreglo de cadenas | no        | Formatos a devolver: `Markdown`, `HTML`, `json`, `screenshot`. por defecto `["html"]`. `json` devuelve los campos analizados. `screenshot` requiere `run_js: true`                           |
| `json`                    | objeto             | no        | Extracción personalizada: `{"prompt": string}` o `{"schema": object}`, nunca ambos. Anula el analizador integrado                                                                            |
| `location`                | cadena             | no        | Código de país de dos letras para obtener, por ejemplo `DE`                                                                                                                                  |
| `device`                  | cadena             | no        | `escritorio` (predeterminado) o `móvil`                                                                                                                                                      |
| `run_js`                  | booleano           | no        | Ejecuta el JavaScript de la página antes de capturar. Más lento — use un tiempo de espera del cliente de 120 segundos o más                                                                  |
| `callback_url`            | cadena             | no        | URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con `400`                                                                                        |
| `storage`                 | objeto             | no        | Entrega el resultado a un bucket en lugar de la respuesta: `{"type": string, "url": string}`. `type` es `s3`, `s3_gzip`, `s3_compatible`, `gcs`, o `tos`. Solo asíncrono. `url` no se valida |

`pickup_today` es un filtro de disponibilidad: cambia qué productos se devuelven, no solo cómo se muestran.

***

### Magazine Luiza

#### `POST /v1/scrape/magazineluiza`

Devuelve los campos analizados de una página de Magazine Luiza a partir de una URL que proporciones.

**Modos:** sincrónico · asincrónico

| Nombre         | Tipo               | Requerido | Descripción                                                                                                                                                                                  |
| -------------- | ------------------ | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `url`          | cadena             | sí        | Una URL de producto o búsqueda de Magazine Luiza                                                                                                                                             |
| `output`       | arreglo de cadenas | no        | Formatos a devolver: `Markdown`, `HTML`, `json`, `screenshot`. por defecto `["html"]`. `json` devuelve los campos analizados. `screenshot` requiere `run_js: true`                           |
| `json`         | objeto             | no        | Extracción personalizada: `{"prompt": string}` o `{"schema": object}`, nunca ambos. Anula el analizador integrado                                                                            |
| `location`     | cadena             | no        | Código de país de dos letras para obtener, por ejemplo `DE`                                                                                                                                  |
| `device`       | cadena             | no        | `escritorio` (predeterminado) o `móvil`                                                                                                                                                      |
| `run_js`       | booleano           | no        | Ejecuta el JavaScript de la página antes de capturar. Más lento — use un tiempo de espera del cliente de 120 segundos o más                                                                  |
| `callback_url` | cadena             | no        | URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con `400`                                                                                        |
| `storage`      | objeto             | no        | Entrega el resultado a un bucket en lugar de la respuesta: `{"type": string, "url": string}`. `type` es `s3`, `s3_gzip`, `s3_compatible`, `gcs`, o `tos`. Solo asíncrono. `url` no se valida |

#### `POST /v1/scrape/magazineluiza/product`

Devuelve el precio, el stock y los detalles de un producto de Magazine Luiza.

**Modos:** sincrónico · asincrónico

| Nombre         | Tipo               | Requerido | Descripción                                                                                                                                                                                  |
| -------------- | ------------------ | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`        | cadena             | sí        | ID del producto                                                                                                                                                                              |
| `domain`       | cadena             | no        | TLD de la tienda                                                                                                                                                                             |
| `output`       | arreglo de cadenas | no        | Formatos a devolver: `Markdown`, `HTML`, `json`, `screenshot`. por defecto `["html"]`. `json` devuelve los campos analizados. `screenshot` requiere `run_js: true`                           |
| `json`         | objeto             | no        | Extracción personalizada: `{"prompt": string}` o `{"schema": object}`, nunca ambos. Anula el analizador integrado                                                                            |
| `location`     | cadena             | no        | Código de país de dos letras para obtener, por ejemplo `DE`                                                                                                                                  |
| `device`       | cadena             | no        | `escritorio` (predeterminado) o `móvil`                                                                                                                                                      |
| `run_js`       | booleano           | no        | Ejecuta el JavaScript de la página antes de capturar. Más lento — use un tiempo de espera del cliente de 120 segundos o más                                                                  |
| `callback_url` | cadena             | no        | URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con `400`                                                                                        |
| `storage`      | objeto             | no        | Entrega el resultado a un bucket en lugar de la respuesta: `{"type": string, "url": string}`. `type` es `s3`, `s3_gzip`, `s3_compatible`, `gcs`, o `tos`. Solo asíncrono. `url` no se valida |

#### `POST /v1/scrape/magazineluiza/search`

Devuelve resultados de búsqueda de Magazine Luiza para una palabra clave.

**Modos:** sincrónico · asincrónico

| Nombre         | Tipo               | Requerido | Descripción                                                                                                                                                                                  |
| -------------- | ------------------ | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`        | cadena             | sí        | Palabra clave de búsqueda                                                                                                                                                                    |
| `domain`       | cadena             | no        | TLD de la tienda                                                                                                                                                                             |
| `start_page`   | entero             | no        | Primera página de resultados                                                                                                                                                                 |
| `output`       | arreglo de cadenas | no        | Formatos a devolver: `Markdown`, `HTML`, `json`, `screenshot`. por defecto `["html"]`. `json` devuelve los campos analizados. `screenshot` requiere `run_js: true`                           |
| `json`         | objeto             | no        | Extracción personalizada: `{"prompt": string}` o `{"schema": object}`, nunca ambos. Anula el analizador integrado                                                                            |
| `location`     | cadena             | no        | Código de país de dos letras para obtener, por ejemplo `DE`                                                                                                                                  |
| `device`       | cadena             | no        | `escritorio` (predeterminado) o `móvil`                                                                                                                                                      |
| `run_js`       | booleano           | no        | Ejecuta el JavaScript de la página antes de capturar. Más lento — use un tiempo de espera del cliente de 120 segundos o más                                                                  |
| `callback_url` | cadena             | no        | URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con `400`                                                                                        |
| `storage`      | objeto             | no        | Entrega el resultado a un bucket en lugar de la respuesta: `{"type": string, "url": string}`. `type` es `s3`, `s3_gzip`, `s3_compatible`, `gcs`, o `tos`. Solo asíncrono. `url` no se valida |

***

### Mariano's

#### `POST /v1/scrape/marianos`

Devuelve los campos analizados de una página de Mariano's a partir de una URL que proporciones.

**Modos:** sincrónico · asincrónico

| Nombre             | Tipo               | Requerido | Descripción                                                                                                                                                                                  |
| ------------------ | ------------------ | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `url`              | cadena             | sí        | Una URL de producto o búsqueda de Mariano's                                                                                                                                                  |
| `delivery_zip`     | cadena             | no        | La entrega al código postal se cotiza para                                                                                                                                                   |
| `fulfillment_type` | cadena             | no        | Filtro de entrega, recogida o envío a domicilio                                                                                                                                              |
| `store_id`         | cadena             | no        | La tienda cuyo catálogo y precios se devuelven                                                                                                                                               |
| `output`           | arreglo de cadenas | no        | Formatos a devolver: `Markdown`, `HTML`, `json`, `screenshot`. por defecto `["html"]`. `json` devuelve los campos analizados. `screenshot` requiere `run_js: true`                           |
| `json`             | objeto             | no        | Extracción personalizada: `{"prompt": string}` o `{"schema": object}`, nunca ambos. Anula el analizador integrado                                                                            |
| `location`         | cadena             | no        | Código de país de dos letras para obtener, por ejemplo `DE`                                                                                                                                  |
| `device`           | cadena             | no        | `escritorio` (predeterminado) o `móvil`                                                                                                                                                      |
| `run_js`           | booleano           | no        | Ejecuta el JavaScript de la página antes de capturar. Más lento — use un tiempo de espera del cliente de 120 segundos o más                                                                  |
| `callback_url`     | cadena             | no        | URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con `400`                                                                                        |
| `storage`          | objeto             | no        | Entrega el resultado a un bucket en lugar de la respuesta: `{"type": string, "url": string}`. `type` es `s3`, `s3_gzip`, `s3_compatible`, `gcs`, o `tos`. Solo asíncrono. `url` no se valida |

#### `POST /v1/scrape/marianos/product`

Devuelve el precio, el stock y los detalles de un producto de Mariano's.

**Modos:** sincrónico · asincrónico

| Nombre             | Tipo               | Requerido | Descripción                                                                                                                                                                                  |
| ------------------ | ------------------ | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`            | cadena             | sí        | ID del producto                                                                                                                                                                              |
| `delivery_zip`     | cadena             | no        | La entrega al código postal se cotiza para                                                                                                                                                   |
| `fulfillment_type` | cadena             | no        | Filtro de entrega, recogida o envío a domicilio                                                                                                                                              |
| `store_id`         | cadena             | no        | La tienda cuyo catálogo y precios se devuelven                                                                                                                                               |
| `output`           | arreglo de cadenas | no        | Formatos a devolver: `Markdown`, `HTML`, `json`, `screenshot`. por defecto `["html"]`. `json` devuelve los campos analizados. `screenshot` requiere `run_js: true`                           |
| `json`             | objeto             | no        | Extracción personalizada: `{"prompt": string}` o `{"schema": object}`, nunca ambos. Anula el analizador integrado                                                                            |
| `location`         | cadena             | no        | Código de país de dos letras para obtener, por ejemplo `DE`                                                                                                                                  |
| `device`           | cadena             | no        | `escritorio` (predeterminado) o `móvil`                                                                                                                                                      |
| `run_js`           | booleano           | no        | Ejecuta el JavaScript de la página antes de capturar. Más lento — use un tiempo de espera del cliente de 120 segundos o más                                                                  |
| `callback_url`     | cadena             | no        | URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con `400`                                                                                        |
| `storage`          | objeto             | no        | Entrega el resultado a un bucket en lugar de la respuesta: `{"type": string, "url": string}`. `type` es `s3`, `s3_gzip`, `s3_compatible`, `gcs`, o `tos`. Solo asíncrono. `url` no se valida |

#### `POST /v1/scrape/marianos/search`

Devuelve resultados de búsqueda de Mariano's para una palabra clave.

**Modos:** sincrónico · asincrónico

| Nombre             | Tipo               | Requerido | Descripción                                                                                                                                                                                  |
| ------------------ | ------------------ | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`            | cadena             | sí        | Palabra clave de búsqueda                                                                                                                                                                    |
| `brand`            | cadena             | no        | Restringe los resultados a una marca                                                                                                                                                         |
| `delivery_zip`     | cadena             | no        | La entrega al código postal se cotiza para                                                                                                                                                   |
| `fulfillment_type` | cadena             | no        | Filtro de entrega, recogida o envío a domicilio                                                                                                                                              |
| `price_range`      | cadena             | no        | Filtro de banda de precios                                                                                                                                                                   |
| `store_id`         | cadena             | no        | La tienda cuyo catálogo y precios se devuelven                                                                                                                                               |
| `output`           | arreglo de cadenas | no        | Formatos a devolver: `Markdown`, `HTML`, `json`, `screenshot`. por defecto `["html"]`. `json` devuelve los campos analizados. `screenshot` requiere `run_js: true`                           |
| `json`             | objeto             | no        | Extracción personalizada: `{"prompt": string}` o `{"schema": object}`, nunca ambos. Anula el analizador integrado                                                                            |
| `location`         | cadena             | no        | Código de país de dos letras para obtener, por ejemplo `DE`                                                                                                                                  |
| `device`           | cadena             | no        | `escritorio` (predeterminado) o `móvil`                                                                                                                                                      |
| `run_js`           | booleano           | no        | Ejecuta el JavaScript de la página antes de capturar. Más lento — use un tiempo de espera del cliente de 120 segundos o más                                                                  |
| `callback_url`     | cadena             | no        | URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con `400`                                                                                        |
| `storage`          | objeto             | no        | Entrega el resultado a un bucket en lugar de la respuesta: `{"type": string, "url": string}`. `type` es `s3`, `s3_gzip`, `s3_compatible`, `gcs`, o `tos`. Solo asíncrono. `url` no se valida |

***

### MediaMarkt

#### `POST /v1/scrape/mediamarkt`

Devuelve los campos analizados de una página de MediaMarkt a partir de una URL que proporciones.

**Modos:** sincrónico · asincrónico

| Nombre         | Tipo               | Requerido | Descripción                                                                                                                                                                                  |
| -------------- | ------------------ | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `url`          | cadena             | sí        | Una URL de producto o búsqueda de MediaMarkt                                                                                                                                                 |
| `output`       | arreglo de cadenas | no        | Formatos a devolver: `Markdown`, `HTML`, `json`, `screenshot`. por defecto `["html"]`. `json` devuelve los campos analizados. `screenshot` requiere `run_js: true`                           |
| `json`         | objeto             | no        | Extracción personalizada: `{"prompt": string}` o `{"schema": object}`, nunca ambos. Anula el analizador integrado                                                                            |
| `location`     | cadena             | no        | Código de país de dos letras para obtener, por ejemplo `DE`                                                                                                                                  |
| `device`       | cadena             | no        | `escritorio` (predeterminado) o `móvil`                                                                                                                                                      |
| `run_js`       | booleano           | no        | Ejecuta el JavaScript de la página antes de capturar. Más lento — use un tiempo de espera del cliente de 120 segundos o más                                                                  |
| `callback_url` | cadena             | no        | URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con `400`                                                                                        |
| `storage`      | objeto             | no        | Entrega el resultado a un bucket en lugar de la respuesta: `{"type": string, "url": string}`. `type` es `s3`, `s3_gzip`, `s3_compatible`, `gcs`, o `tos`. Solo asíncrono. `url` no se valida |

#### `POST /v1/scrape/mediamarkt/product`

Devuelve el precio, el stock y los detalles de un producto de MediaMarkt.

**Modos:** sincrónico · asincrónico

| Nombre         | Tipo               | Requerido | Descripción                                                                                                                                                                                  |
| -------------- | ------------------ | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`        | cadena             | sí        | ID del producto                                                                                                                                                                              |
| `domain`       | cadena             | no        | TLD de la tienda                                                                                                                                                                             |
| `output`       | arreglo de cadenas | no        | Formatos a devolver: `Markdown`, `HTML`, `json`, `screenshot`. por defecto `["html"]`. `json` devuelve los campos analizados. `screenshot` requiere `run_js: true`                           |
| `json`         | objeto             | no        | Extracción personalizada: `{"prompt": string}` o `{"schema": object}`, nunca ambos. Anula el analizador integrado                                                                            |
| `location`     | cadena             | no        | Código de país de dos letras para obtener, por ejemplo `DE`                                                                                                                                  |
| `device`       | cadena             | no        | `escritorio` (predeterminado) o `móvil`                                                                                                                                                      |
| `run_js`       | booleano           | no        | Ejecuta el JavaScript de la página antes de capturar. Más lento — use un tiempo de espera del cliente de 120 segundos o más                                                                  |
| `callback_url` | cadena             | no        | URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con `400`                                                                                        |
| `storage`      | objeto             | no        | Entrega el resultado a un bucket en lugar de la respuesta: `{"type": string, "url": string}`. `type` es `s3`, `s3_gzip`, `s3_compatible`, `gcs`, o `tos`. Solo asíncrono. `url` no se valida |

#### `POST /v1/scrape/mediamarkt/search`

Devuelve resultados de búsqueda de MediaMarkt para una palabra clave.

**Modos:** sincrónico · asincrónico

| Nombre         | Tipo               | Requerido | Descripción                                                                                                                                                                                  |
| -------------- | ------------------ | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`        | cadena             | sí        | Palabra clave de búsqueda                                                                                                                                                                    |
| `domain`       | cadena             | no        | TLD de la tienda                                                                                                                                                                             |
| `start_page`   | entero             | no        | Primera página de resultados                                                                                                                                                                 |
| `output`       | arreglo de cadenas | no        | Formatos a devolver: `Markdown`, `HTML`, `json`, `screenshot`. por defecto `["html"]`. `json` devuelve los campos analizados. `screenshot` requiere `run_js: true`                           |
| `json`         | objeto             | no        | Extracción personalizada: `{"prompt": string}` o `{"schema": object}`, nunca ambos. Anula el analizador integrado                                                                            |
| `location`     | cadena             | no        | Código de país de dos letras para obtener, por ejemplo `DE`                                                                                                                                  |
| `device`       | cadena             | no        | `escritorio` (predeterminado) o `móvil`                                                                                                                                                      |
| `run_js`       | booleano           | no        | Ejecuta el JavaScript de la página antes de capturar. Más lento — use un tiempo de espera del cliente de 120 segundos o más                                                                  |
| `callback_url` | cadena             | no        | URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con `400`                                                                                        |
| `storage`      | objeto             | no        | Entrega el resultado a un bucket en lugar de la respuesta: `{"type": string, "url": string}`. `type` es `s3`, `s3_gzip`, `s3_compatible`, `gcs`, o `tos`. Solo asíncrono. `url` no se valida |

***

### Menards

#### `POST /v1/scrape/menards`

Devuelve los campos analizados de una página de Menards a partir de una URL que proporciones.

**Modos:** sincrónico · asincrónico

| Nombre         | Tipo               | Requerido | Descripción                                                                                                                                                                                  |
| -------------- | ------------------ | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `url`          | cadena             | sí        | Una URL de producto o búsqueda de Menards                                                                                                                                                    |
| `store_id`     | cadena             | no        | La tienda cuyo catálogo y precios se devuelven                                                                                                                                               |
| `output`       | arreglo de cadenas | no        | Formatos a devolver: `Markdown`, `HTML`, `json`, `screenshot`. por defecto `["html"]`. `json` devuelve los campos analizados. `screenshot` requiere `run_js: true`                           |
| `json`         | objeto             | no        | Extracción personalizada: `{"prompt": string}` o `{"schema": object}`, nunca ambos. Anula el analizador integrado                                                                            |
| `location`     | cadena             | no        | Código de país de dos letras para obtener, por ejemplo `DE`                                                                                                                                  |
| `device`       | cadena             | no        | `escritorio` (predeterminado) o `móvil`                                                                                                                                                      |
| `run_js`       | booleano           | no        | Ejecuta el JavaScript de la página antes de capturar. Más lento — use un tiempo de espera del cliente de 120 segundos o más                                                                  |
| `callback_url` | cadena             | no        | URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con `400`                                                                                        |
| `storage`      | objeto             | no        | Entrega el resultado a un bucket en lugar de la respuesta: `{"type": string, "url": string}`. `type` es `s3`, `s3_gzip`, `s3_compatible`, `gcs`, o `tos`. Solo asíncrono. `url` no se valida |

#### `POST /v1/scrape/menards/product`

Devuelve el precio, el stock y los detalles de un producto de Menards.

**Modos:** sincrónico · asincrónico

| Nombre         | Tipo               | Requerido | Descripción                                                                                                                                                                                  |
| -------------- | ------------------ | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`        | cadena             | sí        | ID del producto                                                                                                                                                                              |
| `domain`       | cadena             | no        | TLD de la tienda                                                                                                                                                                             |
| `store_id`     | cadena             | no        | La tienda cuyo catálogo y precios se devuelven                                                                                                                                               |
| `output`       | arreglo de cadenas | no        | Formatos a devolver: `Markdown`, `HTML`, `json`, `screenshot`. por defecto `["html"]`. `json` devuelve los campos analizados. `screenshot` requiere `run_js: true`                           |
| `json`         | objeto             | no        | Extracción personalizada: `{"prompt": string}` o `{"schema": object}`, nunca ambos. Anula el analizador integrado                                                                            |
| `location`     | cadena             | no        | Código de país de dos letras para obtener, por ejemplo `DE`                                                                                                                                  |
| `device`       | cadena             | no        | `escritorio` (predeterminado) o `móvil`                                                                                                                                                      |
| `run_js`       | booleano           | no        | Ejecuta el JavaScript de la página antes de capturar. Más lento — use un tiempo de espera del cliente de 120 segundos o más                                                                  |
| `callback_url` | cadena             | no        | URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con `400`                                                                                        |
| `storage`      | objeto             | no        | Entrega el resultado a un bucket en lugar de la respuesta: `{"type": string, "url": string}`. `type` es `s3`, `s3_gzip`, `s3_compatible`, `gcs`, o `tos`. Solo asíncrono. `url` no se valida |

#### `POST /v1/scrape/menards/search`

Devuelve resultados de búsqueda de Menards para una palabra clave.

**Modos:** sincrónico · asincrónico

| Nombre                     | Tipo               | Requerido | Descripción                                                                                                                                                                                  |
| -------------------------- | ------------------ | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`                    | cadena             | sí        | Palabra clave de búsqueda                                                                                                                                                                    |
| `delivery_eligible`        | booleano           | no        | Solo artículos elegibles para entrega                                                                                                                                                        |
| `domain`                   | cadena             | no        | TLD de la tienda                                                                                                                                                                             |
| `fulfillment_center`       | cadena             | no        | La ubicación de cumplimiento o almacén con la que se evalúa la solicitud                                                                                                                     |
| `in_stock_today`           | booleano           | no        | Solo artículos en stock para disponibilidad el mismo día                                                                                                                                     |
| `pickup_at_store_eligible` | booleano           | no        | Solo artículos elegibles para recogida en tienda                                                                                                                                             |
| `start_page`               | entero             | no        | Primera página de resultados                                                                                                                                                                 |
| `store_id`                 | cadena             | no        | La tienda cuyo catálogo y precios se devuelven                                                                                                                                               |
| `output`                   | arreglo de cadenas | no        | Formatos a devolver: `Markdown`, `HTML`, `json`, `screenshot`. por defecto `["html"]`. `json` devuelve los campos analizados. `screenshot` requiere `run_js: true`                           |
| `json`                     | objeto             | no        | Extracción personalizada: `{"prompt": string}` o `{"schema": object}`, nunca ambos. Anula el analizador integrado                                                                            |
| `location`                 | cadena             | no        | Código de país de dos letras para obtener, por ejemplo `DE`                                                                                                                                  |
| `device`                   | cadena             | no        | `escritorio` (predeterminado) o `móvil`                                                                                                                                                      |
| `run_js`                   | booleano           | no        | Ejecuta el JavaScript de la página antes de capturar. Más lento — use un tiempo de espera del cliente de 120 segundos o más                                                                  |
| `callback_url`             | cadena             | no        | URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con `400`                                                                                        |
| `storage`                  | objeto             | no        | Entrega el resultado a un bucket en lugar de la respuesta: `{"type": string, "url": string}`. `type` es `s3`, `s3_gzip`, `s3_compatible`, `gcs`, o `tos`. Solo asíncrono. `url` no se valida |

`in_stock_today` es un filtro de disponibilidad: cambia qué productos se devuelven, no solo cómo se muestran.

***

### Mercado Libre

#### `POST /v1/scrape/mercadolibre`

Devuelve los campos analizados de una página de Mercado Libre a partir de una URL que proporciones.

**Modos:** sincrónico · asincrónico

| Nombre         | Tipo               | Requerido | Descripción                                                                                                                                                                                  |
| -------------- | ------------------ | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `url`          | cadena             | sí        | Una URL de producto o búsqueda de Mercado Libre                                                                                                                                              |
| `output`       | arreglo de cadenas | no        | Formatos a devolver: `Markdown`, `HTML`, `json`, `screenshot`. por defecto `["html"]`. `json` devuelve los campos analizados. `screenshot` requiere `run_js: true`                           |
| `json`         | objeto             | no        | Extracción personalizada: `{"prompt": string}` o `{"schema": object}`, nunca ambos. Anula el analizador integrado                                                                            |
| `location`     | cadena             | no        | Código de país de dos letras para obtener, por ejemplo `DE`                                                                                                                                  |
| `device`       | cadena             | no        | `escritorio` (predeterminado) o `móvil`                                                                                                                                                      |
| `run_js`       | booleano           | no        | Ejecuta el JavaScript de la página antes de capturar. Más lento — use un tiempo de espera del cliente de 120 segundos o más                                                                  |
| `callback_url` | cadena             | no        | URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con `400`                                                                                        |
| `storage`      | objeto             | no        | Entrega el resultado a un bucket en lugar de la respuesta: `{"type": string, "url": string}`. `type` es `s3`, `s3_gzip`, `s3_compatible`, `gcs`, o `tos`. Solo asíncrono. `url` no se valida |

#### `POST /v1/scrape/mercadolibre/product`

Devuelve el precio, el stock y los detalles de un producto de Mercado Libre.

**Modos:** sincrónico · asincrónico

| Nombre         | Tipo               | Requerido | Descripción                                                                                                                                                                                  |
| -------------- | ------------------ | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`        | cadena             | sí        | ID del producto                                                                                                                                                                              |
| `domain`       | cadena             | no        | TLD de la tienda                                                                                                                                                                             |
| `output`       | arreglo de cadenas | no        | Formatos a devolver: `Markdown`, `HTML`, `json`, `screenshot`. por defecto `["html"]`. `json` devuelve los campos analizados. `screenshot` requiere `run_js: true`                           |
| `json`         | objeto             | no        | Extracción personalizada: `{"prompt": string}` o `{"schema": object}`, nunca ambos. Anula el analizador integrado                                                                            |
| `location`     | cadena             | no        | Código de país de dos letras para obtener, por ejemplo `DE`                                                                                                                                  |
| `device`       | cadena             | no        | `escritorio` (predeterminado) o `móvil`                                                                                                                                                      |
| `run_js`       | booleano           | no        | Ejecuta el JavaScript de la página antes de capturar. Más lento — use un tiempo de espera del cliente de 120 segundos o más                                                                  |
| `callback_url` | cadena             | no        | URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con `400`                                                                                        |
| `storage`      | objeto             | no        | Entrega el resultado a un bucket en lugar de la respuesta: `{"type": string, "url": string}`. `type` es `s3`, `s3_gzip`, `s3_compatible`, `gcs`, o `tos`. Solo asíncrono. `url` no se valida |

#### `POST /v1/scrape/mercadolibre/search`

Devuelve resultados de búsqueda de Mercado Libre para una palabra clave.

**Modos:** sincrónico · asincrónico

| Nombre         | Tipo               | Requerido | Descripción                                                                                                                                                                                  |
| -------------- | ------------------ | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`        | cadena             | sí        | Palabra clave de búsqueda                                                                                                                                                                    |
| `domain`       | cadena             | no        | TLD de la tienda                                                                                                                                                                             |
| `output`       | arreglo de cadenas | no        | Formatos a devolver: `Markdown`, `HTML`, `json`, `screenshot`. por defecto `["html"]`. `json` devuelve los campos analizados. `screenshot` requiere `run_js: true`                           |
| `json`         | objeto             | no        | Extracción personalizada: `{"prompt": string}` o `{"schema": object}`, nunca ambos. Anula el analizador integrado                                                                            |
| `location`     | cadena             | no        | Código de país de dos letras para obtener, por ejemplo `DE`                                                                                                                                  |
| `device`       | cadena             | no        | `escritorio` (predeterminado) o `móvil`                                                                                                                                                      |
| `run_js`       | booleano           | no        | Ejecuta el JavaScript de la página antes de capturar. Más lento — use un tiempo de espera del cliente de 120 segundos o más                                                                  |
| `callback_url` | cadena             | no        | URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con `400`                                                                                        |
| `storage`      | objeto             | no        | Entrega el resultado a un bucket en lugar de la respuesta: `{"type": string, "url": string}`. `type` es `s3`, `s3_gzip`, `s3_compatible`, `gcs`, o `tos`. Solo asíncrono. `url` no se valida |

***

### Mercado Livre

#### `POST /v1/scrape/mercadolivre/product`

Devuelve el precio, el stock y los detalles de un producto de Mercado Livre.

**Modos:** sincrónico · asincrónico

| Nombre         | Tipo               | Requerido | Descripción                                                                                                                                                                                  |
| -------------- | ------------------ | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`        | cadena             | sí        | ID del producto                                                                                                                                                                              |
| `domain`       | cadena             | no        | TLD de la tienda                                                                                                                                                                             |
| `output`       | arreglo de cadenas | no        | Formatos a devolver: `Markdown`, `HTML`, `json`, `screenshot`. por defecto `["html"]`. `json` devuelve los campos analizados. `screenshot` requiere `run_js: true`                           |
| `json`         | objeto             | no        | Extracción personalizada: `{"prompt": string}` o `{"schema": object}`, nunca ambos. Anula el analizador integrado                                                                            |
| `location`     | cadena             | no        | Código de país de dos letras para obtener, por ejemplo `DE`                                                                                                                                  |
| `device`       | cadena             | no        | `escritorio` (predeterminado) o `móvil`                                                                                                                                                      |
| `run_js`       | booleano           | no        | Ejecuta el JavaScript de la página antes de capturar. Más lento — use un tiempo de espera del cliente de 120 segundos o más                                                                  |
| `callback_url` | cadena             | no        | URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con `400`                                                                                        |
| `storage`      | objeto             | no        | Entrega el resultado a un bucket en lugar de la respuesta: `{"type": string, "url": string}`. `type` es `s3`, `s3_gzip`, `s3_compatible`, `gcs`, o `tos`. Solo asíncrono. `url` no se valida |

#### `POST /v1/scrape/mercadolivre/search`

Devuelve resultados de búsqueda de Mercado Livre para una palabra clave.

**Modos:** sincrónico · asincrónico

| Nombre         | Tipo               | Requerido | Descripción                                                                                                                                                                                  |
| -------------- | ------------------ | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`        | cadena             | sí        | Palabra clave de búsqueda                                                                                                                                                                    |
| `domain`       | cadena             | no        | TLD de la tienda                                                                                                                                                                             |
| `output`       | arreglo de cadenas | no        | Formatos a devolver: `Markdown`, `HTML`, `json`, `screenshot`. por defecto `["html"]`. `json` devuelve los campos analizados. `screenshot` requiere `run_js: true`                           |
| `json`         | objeto             | no        | Extracción personalizada: `{"prompt": string}` o `{"schema": object}`, nunca ambos. Anula el analizador integrado                                                                            |
| `location`     | cadena             | no        | Código de país de dos letras para obtener, por ejemplo `DE`                                                                                                                                  |
| `device`       | cadena             | no        | `escritorio` (predeterminado) o `móvil`                                                                                                                                                      |
| `run_js`       | booleano           | no        | Ejecuta el JavaScript de la página antes de capturar. Más lento — use un tiempo de espera del cliente de 120 segundos o más                                                                  |
| `callback_url` | cadena             | no        | URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con `400`                                                                                        |
| `storage`      | objeto             | no        | Entrega el resultado a un bucket en lugar de la respuesta: `{"type": string, "url": string}`. `type` es `s3`, `s3_gzip`, `s3_compatible`, `gcs`, o `tos`. Solo asíncrono. `url` no se valida |

***

### Metro Market

#### `POST /v1/scrape/metromarket`

Devuelve los campos analizados de una página de Metro Market a partir de una URL que proporciones.

**Modos:** sincrónico · asincrónico

| Nombre             | Tipo               | Requerido | Descripción                                                                                                                                                                                  |
| ------------------ | ------------------ | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `url`              | cadena             | sí        | Una URL de producto o búsqueda de Metro Market                                                                                                                                               |
| `delivery_zip`     | cadena             | no        | La entrega al código postal se cotiza para                                                                                                                                                   |
| `fulfillment_type` | cadena             | no        | Filtro de entrega, recogida o envío a domicilio                                                                                                                                              |
| `store_id`         | cadena             | no        | La tienda cuyo catálogo y precios se devuelven                                                                                                                                               |
| `output`           | arreglo de cadenas | no        | Formatos a devolver: `Markdown`, `HTML`, `json`, `screenshot`. por defecto `["html"]`. `json` devuelve los campos analizados. `screenshot` requiere `run_js: true`                           |
| `json`             | objeto             | no        | Extracción personalizada: `{"prompt": string}` o `{"schema": object}`, nunca ambos. Anula el analizador integrado                                                                            |
| `location`         | cadena             | no        | Código de país de dos letras para obtener, por ejemplo `DE`                                                                                                                                  |
| `device`           | cadena             | no        | `escritorio` (predeterminado) o `móvil`                                                                                                                                                      |
| `run_js`           | booleano           | no        | Ejecuta el JavaScript de la página antes de capturar. Más lento — use un tiempo de espera del cliente de 120 segundos o más                                                                  |
| `callback_url`     | cadena             | no        | URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con `400`                                                                                        |
| `storage`          | objeto             | no        | Entrega el resultado a un bucket en lugar de la respuesta: `{"type": string, "url": string}`. `type` es `s3`, `s3_gzip`, `s3_compatible`, `gcs`, o `tos`. Solo asíncrono. `url` no se valida |

#### `POST /v1/scrape/metromarket/product`

Devuelve el precio, el stock y los detalles de un producto de Metro Market.

**Modos:** sincrónico · asincrónico

| Nombre             | Tipo               | Requerido | Descripción                                                                                                                                                                                  |
| ------------------ | ------------------ | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`            | cadena             | sí        | ID del producto                                                                                                                                                                              |
| `delivery_zip`     | cadena             | no        | La entrega al código postal se cotiza para                                                                                                                                                   |
| `fulfillment_type` | cadena             | no        | Filtro de entrega, recogida o envío a domicilio                                                                                                                                              |
| `store_id`         | cadena             | no        | La tienda cuyo catálogo y precios se devuelven                                                                                                                                               |
| `output`           | arreglo de cadenas | no        | Formatos a devolver: `Markdown`, `HTML`, `json`, `screenshot`. por defecto `["html"]`. `json` devuelve los campos analizados. `screenshot` requiere `run_js: true`                           |
| `json`             | objeto             | no        | Extracción personalizada: `{"prompt": string}` o `{"schema": object}`, nunca ambos. Anula el analizador integrado                                                                            |
| `location`         | cadena             | no        | Código de país de dos letras para obtener, por ejemplo `DE`                                                                                                                                  |
| `device`           | cadena             | no        | `escritorio` (predeterminado) o `móvil`                                                                                                                                                      |
| `run_js`           | booleano           | no        | Ejecuta el JavaScript de la página antes de capturar. Más lento — use un tiempo de espera del cliente de 120 segundos o más                                                                  |
| `callback_url`     | cadena             | no        | URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con `400`                                                                                        |
| `storage`          | objeto             | no        | Entrega el resultado a un bucket en lugar de la respuesta: `{"type": string, "url": string}`. `type` es `s3`, `s3_gzip`, `s3_compatible`, `gcs`, o `tos`. Solo asíncrono. `url` no se valida |

#### `POST /v1/scrape/metromarket/search`

Devuelve resultados de búsqueda de Metro Market para una palabra clave.

**Modos:** sincrónico · asincrónico

| Nombre             | Tipo               | Requerido | Descripción                                                                                                                                                                                  |
| ------------------ | ------------------ | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`            | cadena             | sí        | Palabra clave de búsqueda                                                                                                                                                                    |
| `brand`            | cadena             | no        | Restringe los resultados a una marca                                                                                                                                                         |
| `delivery_zip`     | cadena             | no        | La entrega al código postal se cotiza para                                                                                                                                                   |
| `fulfillment_type` | cadena             | no        | Filtro de entrega, recogida o envío a domicilio                                                                                                                                              |
| `price_range`      | cadena             | no        | Filtro de banda de precios                                                                                                                                                                   |
| `store_id`         | cadena             | no        | La tienda cuyo catálogo y precios se devuelven                                                                                                                                               |
| `output`           | arreglo de cadenas | no        | Formatos a devolver: `Markdown`, `HTML`, `json`, `screenshot`. por defecto `["html"]`. `json` devuelve los campos analizados. `screenshot` requiere `run_js: true`                           |
| `json`             | objeto             | no        | Extracción personalizada: `{"prompt": string}` o `{"schema": object}`, nunca ambos. Anula el analizador integrado                                                                            |
| `location`         | cadena             | no        | Código de país de dos letras para obtener, por ejemplo `DE`                                                                                                                                  |
| `device`           | cadena             | no        | `escritorio` (predeterminado) o `móvil`                                                                                                                                                      |
| `run_js`           | booleano           | no        | Ejecuta el JavaScript de la página antes de capturar. Más lento — use un tiempo de espera del cliente de 120 segundos o más                                                                  |
| `callback_url`     | cadena             | no        | URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con `400`                                                                                        |
| `storage`          | objeto             | no        | Entrega el resultado a un bucket en lugar de la respuesta: `{"type": string, "url": string}`. `type` es `s3`, `s3_gzip`, `s3_compatible`, `gcs`, o `tos`. Solo asíncrono. `url` no se valida |

***

### Neobits

#### `POST /v1/scrape/neobits/search`

Devuelve resultados de búsqueda de Neobits para una palabra clave.

**Modos:** sincrónico · asincrónico

| Nombre         | Tipo               | Requerido | Descripción                                                                                                                                                                                  |
| -------------- | ------------------ | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`        | cadena             | sí        | Palabra clave de búsqueda                                                                                                                                                                    |
| `domain`       | cadena             | no        | TLD de la tienda                                                                                                                                                                             |
| `output`       | arreglo de cadenas | no        | Formatos a devolver: `Markdown`, `HTML`, `json`, `screenshot`. por defecto `["html"]`. `json` devuelve los campos analizados. `screenshot` requiere `run_js: true`                           |
| `json`         | objeto             | no        | Extracción personalizada: `{"prompt": string}` o `{"schema": object}`, nunca ambos. Anula el analizador integrado                                                                            |
| `location`     | cadena             | no        | Código de país de dos letras para obtener, por ejemplo `DE`                                                                                                                                  |
| `device`       | cadena             | no        | `escritorio` (predeterminado) o `móvil`                                                                                                                                                      |
| `run_js`       | booleano           | no        | Ejecuta el JavaScript de la página antes de capturar. Más lento — use un tiempo de espera del cliente de 120 segundos o más                                                                  |
| `callback_url` | cadena             | no        | URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con `400`                                                                                        |
| `storage`      | objeto             | no        | Entrega el resultado a un bucket en lugar de la respuesta: `{"type": string, "url": string}`. `type` es `s3`, `s3_gzip`, `s3_compatible`, `gcs`, o `tos`. Solo asíncrono. `url` no se valida |

***

### Petco

#### `POST /v1/scrape/petco`

Devuelve los campos analizados de una página de Petco a partir de una URL que proporciones.

**Modos:** sincrónico · asincrónico

| Nombre         | Tipo               | Requerido | Descripción                                                                                                                                                                                  |
| -------------- | ------------------ | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `url`          | cadena             | sí        | Una URL de producto o búsqueda de Petco                                                                                                                                                      |
| `store_id`     | cadena             | no        | La tienda cuyo catálogo y precios se devuelven                                                                                                                                               |
| `output`       | arreglo de cadenas | no        | Formatos a devolver: `Markdown`, `HTML`, `json`, `screenshot`. por defecto `["html"]`. `json` devuelve los campos analizados. `screenshot` requiere `run_js: true`                           |
| `json`         | objeto             | no        | Extracción personalizada: `{"prompt": string}` o `{"schema": object}`, nunca ambos. Anula el analizador integrado                                                                            |
| `location`     | cadena             | no        | Código de país de dos letras para obtener, por ejemplo `DE`                                                                                                                                  |
| `device`       | cadena             | no        | `escritorio` (predeterminado) o `móvil`                                                                                                                                                      |
| `run_js`       | booleano           | no        | Ejecuta el JavaScript de la página antes de capturar. Más lento — use un tiempo de espera del cliente de 120 segundos o más                                                                  |
| `callback_url` | cadena             | no        | URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con `400`                                                                                        |
| `storage`      | objeto             | no        | Entrega el resultado a un bucket en lugar de la respuesta: `{"type": string, "url": string}`. `type` es `s3`, `s3_gzip`, `s3_compatible`, `gcs`, o `tos`. Solo asíncrono. `url` no se valida |

#### `POST /v1/scrape/petco/search`

Devuelve resultados de búsqueda de Petco para una palabra clave.

**Modos:** sincrónico · asincrónico

| Nombre             | Tipo               | Requerido | Descripción                                                                                                                                                                                  |
| ------------------ | ------------------ | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`            | cadena             | sí        | Palabra clave de búsqueda                                                                                                                                                                    |
| `domain`           | cadena             | no        | TLD de la tienda                                                                                                                                                                             |
| `fulfillment_type` | cadena             | no        | Filtro de entrega, recogida o envío a domicilio                                                                                                                                              |
| `start_page`       | entero             | no        | Primera página de resultados                                                                                                                                                                 |
| `store_id`         | cadena             | no        | La tienda cuyo catálogo y precios se devuelven                                                                                                                                               |
| `output`           | arreglo de cadenas | no        | Formatos a devolver: `Markdown`, `HTML`, `json`, `screenshot`. por defecto `["html"]`. `json` devuelve los campos analizados. `screenshot` requiere `run_js: true`                           |
| `json`             | objeto             | no        | Extracción personalizada: `{"prompt": string}` o `{"schema": object}`, nunca ambos. Anula el analizador integrado                                                                            |
| `location`         | cadena             | no        | Código de país de dos letras para obtener, por ejemplo `DE`                                                                                                                                  |
| `device`           | cadena             | no        | `escritorio` (predeterminado) o `móvil`                                                                                                                                                      |
| `run_js`           | booleano           | no        | Ejecuta el JavaScript de la página antes de capturar. Más lento — use un tiempo de espera del cliente de 120 segundos o más                                                                  |
| `callback_url`     | cadena             | no        | URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con `400`                                                                                        |
| `storage`          | objeto             | no        | Entrega el resultado a un bucket en lugar de la respuesta: `{"type": string, "url": string}`. `type` es `s3`, `s3_gzip`, `s3_compatible`, `gcs`, o `tos`. Solo asíncrono. `url` no se valida |

***

### Pick 'n Save

#### `POST /v1/scrape/picknsave`

Devuelve los campos analizados de una página de Pick 'n Save a partir de una URL que proporciones.

**Modos:** sincrónico · asincrónico

| Nombre             | Tipo               | Requerido | Descripción                                                                                                                                                                                  |
| ------------------ | ------------------ | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `url`              | cadena             | sí        | Una URL de producto o búsqueda de Pick 'n Save                                                                                                                                               |
| `delivery_zip`     | cadena             | no        | La entrega al código postal se cotiza para                                                                                                                                                   |
| `fulfillment_type` | cadena             | no        | Filtro de entrega, recogida o envío a domicilio                                                                                                                                              |
| `store_id`         | cadena             | no        | La tienda cuyo catálogo y precios se devuelven                                                                                                                                               |
| `output`           | arreglo de cadenas | no        | Formatos a devolver: `Markdown`, `HTML`, `json`, `screenshot`. por defecto `["html"]`. `json` devuelve los campos analizados. `screenshot` requiere `run_js: true`                           |
| `json`             | objeto             | no        | Extracción personalizada: `{"prompt": string}` o `{"schema": object}`, nunca ambos. Anula el analizador integrado                                                                            |
| `location`         | cadena             | no        | Código de país de dos letras para obtener, por ejemplo `DE`                                                                                                                                  |
| `device`           | cadena             | no        | `escritorio` (predeterminado) o `móvil`                                                                                                                                                      |
| `run_js`           | booleano           | no        | Ejecuta el JavaScript de la página antes de capturar. Más lento — use un tiempo de espera del cliente de 120 segundos o más                                                                  |
| `callback_url`     | cadena             | no        | URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con `400`                                                                                        |
| `storage`          | objeto             | no        | Entrega el resultado a un bucket en lugar de la respuesta: `{"type": string, "url": string}`. `type` es `s3`, `s3_gzip`, `s3_compatible`, `gcs`, o `tos`. Solo asíncrono. `url` no se valida |

#### `POST /v1/scrape/picknsave/product`

Devuelve el precio, el stock y los detalles de un producto de Pick 'n Save.

**Modos:** sincrónico · asincrónico

| Nombre             | Tipo               | Requerido | Descripción                                                                                                                                                                                  |
| ------------------ | ------------------ | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`            | cadena             | sí        | ID del producto                                                                                                                                                                              |
| `delivery_zip`     | cadena             | no        | La entrega al código postal se cotiza para                                                                                                                                                   |
| `fulfillment_type` | cadena             | no        | Filtro de entrega, recogida o envío a domicilio                                                                                                                                              |
| `store_id`         | cadena             | no        | La tienda cuyo catálogo y precios se devuelven                                                                                                                                               |
| `output`           | arreglo de cadenas | no        | Formatos a devolver: `Markdown`, `HTML`, `json`, `screenshot`. por defecto `["html"]`. `json` devuelve los campos analizados. `screenshot` requiere `run_js: true`                           |
| `json`             | objeto             | no        | Extracción personalizada: `{"prompt": string}` o `{"schema": object}`, nunca ambos. Anula el analizador integrado                                                                            |
| `location`         | cadena             | no        | Código de país de dos letras para obtener, por ejemplo `DE`                                                                                                                                  |
| `device`           | cadena             | no        | `escritorio` (predeterminado) o `móvil`                                                                                                                                                      |
| `run_js`           | booleano           | no        | Ejecuta el JavaScript de la página antes de capturar. Más lento — use un tiempo de espera del cliente de 120 segundos o más                                                                  |
| `callback_url`     | cadena             | no        | URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con `400`                                                                                        |
| `storage`          | objeto             | no        | Entrega el resultado a un bucket en lugar de la respuesta: `{"type": string, "url": string}`. `type` es `s3`, `s3_gzip`, `s3_compatible`, `gcs`, o `tos`. Solo asíncrono. `url` no se valida |

#### `POST /v1/scrape/picknsave/search`

Devuelve resultados de búsqueda de Pick 'n Save para una palabra clave.

**Modos:** sincrónico · asincrónico

| Nombre             | Tipo               | Requerido | Descripción                                                                                                                                                                                  |
| ------------------ | ------------------ | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`            | cadena             | sí        | Palabra clave de búsqueda                                                                                                                                                                    |
| `brand`            | cadena             | no        | Restringe los resultados a una marca                                                                                                                                                         |
| `delivery_zip`     | cadena             | no        | La entrega al código postal se cotiza para                                                                                                                                                   |
| `fulfillment_type` | cadena             | no        | Filtro de entrega, recogida o envío a domicilio                                                                                                                                              |
| `price_range`      | cadena             | no        | Filtro de banda de precios                                                                                                                                                                   |
| `store_id`         | cadena             | no        | La tienda cuyo catálogo y precios se devuelven                                                                                                                                               |
| `output`           | arreglo de cadenas | no        | Formatos a devolver: `Markdown`, `HTML`, `json`, `screenshot`. por defecto `["html"]`. `json` devuelve los campos analizados. `screenshot` requiere `run_js: true`                           |
| `json`             | objeto             | no        | Extracción personalizada: `{"prompt": string}` o `{"schema": object}`, nunca ambos. Anula el analizador integrado                                                                            |
| `location`         | cadena             | no        | Código de país de dos letras para obtener, por ejemplo `DE`                                                                                                                                  |
| `device`           | cadena             | no        | `escritorio` (predeterminado) o `móvil`                                                                                                                                                      |
| `run_js`           | booleano           | no        | Ejecuta el JavaScript de la página antes de capturar. Más lento — use un tiempo de espera del cliente de 120 segundos o más                                                                  |
| `callback_url`     | cadena             | no        | URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con `400`                                                                                        |
| `storage`          | objeto             | no        | Entrega el resultado a un bucket en lugar de la respuesta: `{"type": string, "url": string}`. `type` es `s3`, `s3_gzip`, `s3_compatible`, `gcs`, o `tos`. Solo asíncrono. `url` no se valida |

***

### Publix

#### `POST /v1/scrape/publix`

Devuelve los campos analizados de una página de Publix a partir de una URL que proporciones.

**Modos:** sincrónico · asincrónico

| Nombre         | Tipo               | Requerido | Descripción                                                                                                                                                                                  |
| -------------- | ------------------ | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `url`          | cadena             | sí        | Una URL de producto o búsqueda de Publix                                                                                                                                                     |
| `store_id`     | cadena             | no        | La tienda cuyo catálogo y precios se devuelven                                                                                                                                               |
| `output`       | arreglo de cadenas | no        | Formatos a devolver: `Markdown`, `HTML`, `json`, `screenshot`. por defecto `["html"]`. `json` devuelve los campos analizados. `screenshot` requiere `run_js: true`                           |
| `json`         | objeto             | no        | Extracción personalizada: `{"prompt": string}` o `{"schema": object}`, nunca ambos. Anula el analizador integrado                                                                            |
| `location`     | cadena             | no        | Código de país de dos letras para obtener, por ejemplo `DE`                                                                                                                                  |
| `device`       | cadena             | no        | `escritorio` (predeterminado) o `móvil`                                                                                                                                                      |
| `run_js`       | booleano           | no        | Ejecuta el JavaScript de la página antes de capturar. Más lento — use un tiempo de espera del cliente de 120 segundos o más                                                                  |
| `callback_url` | cadena             | no        | URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con `400`                                                                                        |
| `storage`      | objeto             | no        | Entrega el resultado a un bucket en lugar de la respuesta: `{"type": string, "url": string}`. `type` es `s3`, `s3_gzip`, `s3_compatible`, `gcs`, o `tos`. Solo asíncrono. `url` no se valida |

#### `POST /v1/scrape/publix/product`

Devuelve el precio, el stock y los detalles de un producto de Publix.

**Modos:** sincrónico · asincrónico

| Nombre         | Tipo               | Requerido | Descripción                                                                                                                                                                                  |
| -------------- | ------------------ | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`        | cadena             | sí        | ID del producto                                                                                                                                                                              |
| `store_id`     | cadena             | no        | La tienda cuyo catálogo y precios se devuelven                                                                                                                                               |
| `output`       | arreglo de cadenas | no        | Formatos a devolver: `Markdown`, `HTML`, `json`, `screenshot`. por defecto `["html"]`. `json` devuelve los campos analizados. `screenshot` requiere `run_js: true`                           |
| `json`         | objeto             | no        | Extracción personalizada: `{"prompt": string}` o `{"schema": object}`, nunca ambos. Anula el analizador integrado                                                                            |
| `location`     | cadena             | no        | Código de país de dos letras para obtener, por ejemplo `DE`                                                                                                                                  |
| `device`       | cadena             | no        | `escritorio` (predeterminado) o `móvil`                                                                                                                                                      |
| `run_js`       | booleano           | no        | Ejecuta el JavaScript de la página antes de capturar. Más lento — use un tiempo de espera del cliente de 120 segundos o más                                                                  |
| `callback_url` | cadena             | no        | URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con `400`                                                                                        |
| `storage`      | objeto             | no        | Entrega el resultado a un bucket en lugar de la respuesta: `{"type": string, "url": string}`. `type` es `s3`, `s3_gzip`, `s3_compatible`, `gcs`, o `tos`. Solo asíncrono. `url` no se valida |

#### `POST /v1/scrape/publix/search`

Devuelve resultados de búsqueda de Publix para una palabra clave.

**Modos:** sincrónico · asincrónico

| Nombre         | Tipo               | Requerido | Descripción                                                                                                                                                                                  |
| -------------- | ------------------ | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`        | cadena             | sí        | Palabra clave de búsqueda                                                                                                                                                                    |
| `store_id`     | cadena             | no        | La tienda cuyo catálogo y precios se devuelven                                                                                                                                               |
| `output`       | arreglo de cadenas | no        | Formatos a devolver: `Markdown`, `HTML`, `json`, `screenshot`. por defecto `["html"]`. `json` devuelve los campos analizados. `screenshot` requiere `run_js: true`                           |
| `json`         | objeto             | no        | Extracción personalizada: `{"prompt": string}` o `{"schema": object}`, nunca ambos. Anula el analizador integrado                                                                            |
| `location`     | cadena             | no        | Código de país de dos letras para obtener, por ejemplo `DE`                                                                                                                                  |
| `device`       | cadena             | no        | `escritorio` (predeterminado) o `móvil`                                                                                                                                                      |
| `run_js`       | booleano           | no        | Ejecuta el JavaScript de la página antes de capturar. Más lento — use un tiempo de espera del cliente de 120 segundos o más                                                                  |
| `callback_url` | cadena             | no        | URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con `400`                                                                                        |
| `storage`      | objeto             | no        | Entrega el resultado a un bucket en lugar de la respuesta: `{"type": string, "url": string}`. `type` es `s3`, `s3_gzip`, `s3_compatible`, `gcs`, o `tos`. Solo asíncrono. `url` no se valida |

***

### QFC

#### `POST /v1/scrape/qfc`

Devuelve los campos analizados de una página de QFC a partir de una URL que proporciones.

**Modos:** sincrónico · asincrónico

| Nombre             | Tipo               | Requerido | Descripción                                                                                                                                                                                  |
| ------------------ | ------------------ | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `url`              | cadena             | sí        | Una URL de producto o búsqueda de QFC                                                                                                                                                        |
| `delivery_zip`     | cadena             | no        | La entrega al código postal se cotiza para                                                                                                                                                   |
| `fulfillment_type` | cadena             | no        | Filtro de entrega, recogida o envío a domicilio                                                                                                                                              |
| `store_id`         | cadena             | no        | La tienda cuyo catálogo y precios se devuelven                                                                                                                                               |
| `output`           | arreglo de cadenas | no        | Formatos a devolver: `Markdown`, `HTML`, `json`, `screenshot`. por defecto `["html"]`. `json` devuelve los campos analizados. `screenshot` requiere `run_js: true`                           |
| `json`             | objeto             | no        | Extracción personalizada: `{"prompt": string}` o `{"schema": object}`, nunca ambos. Anula el analizador integrado                                                                            |
| `location`         | cadena             | no        | Código de país de dos letras para obtener, por ejemplo `DE`                                                                                                                                  |
| `device`           | cadena             | no        | `escritorio` (predeterminado) o `móvil`                                                                                                                                                      |
| `run_js`           | booleano           | no        | Ejecuta el JavaScript de la página antes de capturar. Más lento — use un tiempo de espera del cliente de 120 segundos o más                                                                  |
| `callback_url`     | cadena             | no        | URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con `400`                                                                                        |
| `storage`          | objeto             | no        | Entrega el resultado a un bucket en lugar de la respuesta: `{"type": string, "url": string}`. `type` es `s3`, `s3_gzip`, `s3_compatible`, `gcs`, o `tos`. Solo asíncrono. `url` no se valida |

#### `POST /v1/scrape/qfc/product`

Devuelve el precio, el stock y los detalles de un producto de QFC.

**Modos:** sincrónico · asincrónico

| Nombre             | Tipo               | Requerido | Descripción                                                                                                                                                                                  |
| ------------------ | ------------------ | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`            | cadena             | sí        | ID del producto                                                                                                                                                                              |
| `delivery_zip`     | cadena             | no        | La entrega al código postal se cotiza para                                                                                                                                                   |
| `fulfillment_type` | cadena             | no        | Filtro de entrega, recogida o envío a domicilio                                                                                                                                              |
| `store_id`         | cadena             | no        | La tienda cuyo catálogo y precios se devuelven                                                                                                                                               |
| `output`           | arreglo de cadenas | no        | Formatos a devolver: `Markdown`, `HTML`, `json`, `screenshot`. por defecto `["html"]`. `json` devuelve los campos analizados. `screenshot` requiere `run_js: true`                           |
| `json`             | objeto             | no        | Extracción personalizada: `{"prompt": string}` o `{"schema": object}`, nunca ambos. Anula el analizador integrado                                                                            |
| `location`         | cadena             | no        | Código de país de dos letras para obtener, por ejemplo `DE`                                                                                                                                  |
| `device`           | cadena             | no        | `escritorio` (predeterminado) o `móvil`                                                                                                                                                      |
| `run_js`           | booleano           | no        | Ejecuta el JavaScript de la página antes de capturar. Más lento — use un tiempo de espera del cliente de 120 segundos o más                                                                  |
| `callback_url`     | cadena             | no        | URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con `400`                                                                                        |
| `storage`          | objeto             | no        | Entrega el resultado a un bucket en lugar de la respuesta: `{"type": string, "url": string}`. `type` es `s3`, `s3_gzip`, `s3_compatible`, `gcs`, o `tos`. Solo asíncrono. `url` no se valida |

#### `POST /v1/scrape/qfc/search`

Devuelve resultados de búsqueda de QFC para una palabra clave.

**Modos:** sincrónico · asincrónico

| Nombre             | Tipo               | Requerido | Descripción                                                                                                                                                                                  |
| ------------------ | ------------------ | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`            | cadena             | sí        | Palabra clave de búsqueda                                                                                                                                                                    |
| `brand`            | cadena             | no        | Restringe los resultados a una marca                                                                                                                                                         |
| `delivery_zip`     | cadena             | no        | La entrega al código postal se cotiza para                                                                                                                                                   |
| `fulfillment_type` | cadena             | no        | Filtro de entrega, recogida o envío a domicilio                                                                                                                                              |
| `price_range`      | cadena             | no        | Filtro de banda de precios                                                                                                                                                                   |
| `store_id`         | cadena             | no        | La tienda cuyo catálogo y precios se devuelven                                                                                                                                               |
| `output`           | arreglo de cadenas | no        | Formatos a devolver: `Markdown`, `HTML`, `json`, `screenshot`. por defecto `["html"]`. `json` devuelve los campos analizados. `screenshot` requiere `run_js: true`                           |
| `json`             | objeto             | no        | Extracción personalizada: `{"prompt": string}` o `{"schema": object}`, nunca ambos. Anula el analizador integrado                                                                            |
| `location`         | cadena             | no        | Código de país de dos letras para obtener, por ejemplo `DE`                                                                                                                                  |
| `device`           | cadena             | no        | `escritorio` (predeterminado) o `móvil`                                                                                                                                                      |
| `run_js`           | booleano           | no        | Ejecuta el JavaScript de la página antes de capturar. Más lento — use un tiempo de espera del cliente de 120 segundos o más                                                                  |
| `callback_url`     | cadena             | no        | URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con `400`                                                                                        |
| `storage`          | objeto             | no        | Entrega el resultado a un bucket en lugar de la respuesta: `{"type": string, "url": string}`. `type` es `s3`, `s3_gzip`, `s3_compatible`, `gcs`, o `tos`. Solo asíncrono. `url` no se valida |

***

### Rakuten

#### `POST /v1/scrape/rakuten`

Devuelve los campos analizados de una página de Rakuten a partir de una URL que proporciones.

**Modos:** sincrónico · asincrónico

| Nombre         | Tipo               | Requerido | Descripción                                                                                                                                                                                  |
| -------------- | ------------------ | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `url`          | cadena             | sí        | Una URL de producto o búsqueda de Rakuten                                                                                                                                                    |
| `output`       | arreglo de cadenas | no        | Formatos a devolver: `Markdown`, `HTML`, `json`, `screenshot`. por defecto `["html"]`. `json` devuelve los campos analizados. `screenshot` requiere `run_js: true`                           |
| `json`         | objeto             | no        | Extracción personalizada: `{"prompt": string}` o `{"schema": object}`, nunca ambos. Anula el analizador integrado                                                                            |
| `location`     | cadena             | no        | Código de país de dos letras para obtener, por ejemplo `DE`                                                                                                                                  |
| `device`       | cadena             | no        | `escritorio` (predeterminado) o `móvil`                                                                                                                                                      |
| `run_js`       | booleano           | no        | Ejecuta el JavaScript de la página antes de capturar. Más lento — use un tiempo de espera del cliente de 120 segundos o más                                                                  |
| `callback_url` | cadena             | no        | URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con `400`                                                                                        |
| `storage`      | objeto             | no        | Entrega el resultado a un bucket en lugar de la respuesta: `{"type": string, "url": string}`. `type` es `s3`, `s3_gzip`, `s3_compatible`, `gcs`, o `tos`. Solo asíncrono. `url` no se valida |

#### `POST /v1/scrape/rakuten/search`

Devuelve resultados de búsqueda de Rakuten para una palabra clave.

**Modos:** sincrónico · asincrónico

| Nombre         | Tipo               | Requerido | Descripción                                                                                                                                                                                  |
| -------------- | ------------------ | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`        | cadena             | sí        | Palabra clave de búsqueda                                                                                                                                                                    |
| `domain`       | cadena             | no        | TLD de la tienda                                                                                                                                                                             |
| `output`       | arreglo de cadenas | no        | Formatos a devolver: `Markdown`, `HTML`, `json`, `screenshot`. por defecto `["html"]`. `json` devuelve los campos analizados. `screenshot` requiere `run_js: true`                           |
| `json`         | objeto             | no        | Extracción personalizada: `{"prompt": string}` o `{"schema": object}`, nunca ambos. Anula el analizador integrado                                                                            |
| `location`     | cadena             | no        | Código de país de dos letras para obtener, por ejemplo `DE`                                                                                                                                  |
| `device`       | cadena             | no        | `escritorio` (predeterminado) o `móvil`                                                                                                                                                      |
| `run_js`       | booleano           | no        | Ejecuta el JavaScript de la página antes de capturar. Más lento — use un tiempo de espera del cliente de 120 segundos o más                                                                  |
| `callback_url` | cadena             | no        | URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con `400`                                                                                        |
| `storage`      | objeto             | no        | Entrega el resultado a un bucket en lugar de la respuesta: `{"type": string, "url": string}`. `type` es `s3`, `s3_gzip`, `s3_compatible`, `gcs`, o `tos`. Solo asíncrono. `url` no se valida |

***

### Ralphs

#### `POST /v1/scrape/ralphs`

Devuelve los campos analizados de una página de Ralphs a partir de una URL que proporciones.

**Modos:** sincrónico · asincrónico

| Nombre             | Tipo               | Requerido | Descripción                                                                                                                                                                                  |
| ------------------ | ------------------ | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `url`              | cadena             | sí        | Una URL de producto o búsqueda de Ralphs                                                                                                                                                     |
| `delivery_zip`     | cadena             | no        | La entrega al código postal se cotiza para                                                                                                                                                   |
| `fulfillment_type` | cadena             | no        | Filtro de entrega, recogida o envío a domicilio                                                                                                                                              |
| `store_id`         | cadena             | no        | La tienda cuyo catálogo y precios se devuelven                                                                                                                                               |
| `output`           | arreglo de cadenas | no        | Formatos a devolver: `Markdown`, `HTML`, `json`, `screenshot`. por defecto `["html"]`. `json` devuelve los campos analizados. `screenshot` requiere `run_js: true`                           |
| `json`             | objeto             | no        | Extracción personalizada: `{"prompt": string}` o `{"schema": object}`, nunca ambos. Anula el analizador integrado                                                                            |
| `location`         | cadena             | no        | Código de país de dos letras para obtener, por ejemplo `DE`                                                                                                                                  |
| `device`           | cadena             | no        | `escritorio` (predeterminado) o `móvil`                                                                                                                                                      |
| `run_js`           | booleano           | no        | Ejecuta el JavaScript de la página antes de capturar. Más lento — use un tiempo de espera del cliente de 120 segundos o más                                                                  |
| `callback_url`     | cadena             | no        | URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con `400`                                                                                        |
| `storage`          | objeto             | no        | Entrega el resultado a un bucket en lugar de la respuesta: `{"type": string, "url": string}`. `type` es `s3`, `s3_gzip`, `s3_compatible`, `gcs`, o `tos`. Solo asíncrono. `url` no se valida |

#### `POST /v1/scrape/ralphs/product`

Devuelve el precio, el stock y los detalles de un producto de Ralphs.

**Modos:** sincrónico · asincrónico

| Nombre             | Tipo               | Requerido | Descripción                                                                                                                                                                                  |
| ------------------ | ------------------ | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`            | cadena             | sí        | ID del producto                                                                                                                                                                              |
| `delivery_zip`     | cadena             | no        | La entrega al código postal se cotiza para                                                                                                                                                   |
| `fulfillment_type` | cadena             | no        | Filtro de entrega, recogida o envío a domicilio                                                                                                                                              |
| `store_id`         | cadena             | no        | La tienda cuyo catálogo y precios se devuelven                                                                                                                                               |
| `output`           | arreglo de cadenas | no        | Formatos a devolver: `Markdown`, `HTML`, `json`, `screenshot`. por defecto `["html"]`. `json` devuelve los campos analizados. `screenshot` requiere `run_js: true`                           |
| `json`             | objeto             | no        | Extracción personalizada: `{"prompt": string}` o `{"schema": object}`, nunca ambos. Anula el analizador integrado                                                                            |
| `location`         | cadena             | no        | Código de país de dos letras para obtener, por ejemplo `DE`                                                                                                                                  |
| `device`           | cadena             | no        | `escritorio` (predeterminado) o `móvil`                                                                                                                                                      |
| `run_js`           | booleano           | no        | Ejecuta el JavaScript de la página antes de capturar. Más lento — use un tiempo de espera del cliente de 120 segundos o más                                                                  |
| `callback_url`     | cadena             | no        | URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con `400`                                                                                        |
| `storage`          | objeto             | no        | Entrega el resultado a un bucket en lugar de la respuesta: `{"type": string, "url": string}`. `type` es `s3`, `s3_gzip`, `s3_compatible`, `gcs`, o `tos`. Solo asíncrono. `url` no se valida |

#### `POST /v1/scrape/ralphs/search`

Devuelve resultados de búsqueda de Ralphs para una palabra clave.

**Modos:** sincrónico · asincrónico

| Nombre             | Tipo               | Requerido | Descripción                                                                                                                                                                                  |
| ------------------ | ------------------ | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`            | cadena             | sí        | Palabra clave de búsqueda                                                                                                                                                                    |
| `brand`            | cadena             | no        | Restringe los resultados a una marca                                                                                                                                                         |
| `delivery_zip`     | cadena             | no        | La entrega al código postal se cotiza para                                                                                                                                                   |
| `fulfillment_type` | cadena             | no        | Filtro de entrega, recogida o envío a domicilio                                                                                                                                              |
| `price_range`      | cadena             | no        | Filtro de banda de precios                                                                                                                                                                   |
| `store_id`         | cadena             | no        | La tienda cuyo catálogo y precios se devuelven                                                                                                                                               |
| `output`           | arreglo de cadenas | no        | Formatos a devolver: `Markdown`, `HTML`, `json`, `screenshot`. por defecto `["html"]`. `json` devuelve los campos analizados. `screenshot` requiere `run_js: true`                           |
| `json`             | objeto             | no        | Extracción personalizada: `{"prompt": string}` o `{"schema": object}`, nunca ambos. Anula el analizador integrado                                                                            |
| `location`         | cadena             | no        | Código de país de dos letras para obtener, por ejemplo `DE`                                                                                                                                  |
| `device`           | cadena             | no        | `escritorio` (predeterminado) o `móvil`                                                                                                                                                      |
| `run_js`           | booleano           | no        | Ejecuta el JavaScript de la página antes de capturar. Más lento — use un tiempo de espera del cliente de 120 segundos o más                                                                  |
| `callback_url`     | cadena             | no        | URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con `400`                                                                                        |
| `storage`          | objeto             | no        | Entrega el resultado a un bucket en lugar de la respuesta: `{"type": string, "url": string}`. `type` es `s3`, `s3_gzip`, `s3_compatible`, `gcs`, o `tos`. Solo asíncrono. `url` no se valida |

***

### Safeway

#### `POST /v1/scrape/safeway/product`

Devuelve el precio, el stock y los detalles de un producto de Safeway.

**Modos:** sincrónico · asincrónico

| Nombre         | Tipo               | Requerido | Descripción                                                                                                                                                                                  |
| -------------- | ------------------ | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`        | cadena             | sí        | ID del producto                                                                                                                                                                              |
| `zip_code`     | cadena             | no        | La entrega al código postal se cotiza para                                                                                                                                                   |
| `output`       | arreglo de cadenas | no        | Formatos a devolver: `Markdown`, `HTML`, `json`, `screenshot`. por defecto `["html"]`. `json` devuelve los campos analizados. `screenshot` requiere `run_js: true`                           |
| `json`         | objeto             | no        | Extracción personalizada: `{"prompt": string}` o `{"schema": object}`, nunca ambos. Anula el analizador integrado                                                                            |
| `location`     | cadena             | no        | Código de país de dos letras para obtener, por ejemplo `DE`                                                                                                                                  |
| `device`       | cadena             | no        | `escritorio` (predeterminado) o `móvil`                                                                                                                                                      |
| `run_js`       | booleano           | no        | Ejecuta el JavaScript de la página antes de capturar. Más lento — use un tiempo de espera del cliente de 120 segundos o más                                                                  |
| `callback_url` | cadena             | no        | URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con `400`                                                                                        |
| `storage`      | objeto             | no        | Entrega el resultado a un bucket en lugar de la respuesta: `{"type": string, "url": string}`. `type` es `s3`, `s3_gzip`, `s3_compatible`, `gcs`, o `tos`. Solo asíncrono. `url` no se valida |

#### `POST /v1/scrape/safeway/search`

Devuelve resultados de búsqueda de Safeway para una palabra clave.

**Modos:** sincrónico · asincrónico

| Nombre         | Tipo               | Requerido | Descripción                                                                                                                                                                                  |
| -------------- | ------------------ | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`        | cadena             | sí        | Palabra clave de búsqueda                                                                                                                                                                    |
| `zip_code`     | cadena             | no        | La entrega al código postal se cotiza para                                                                                                                                                   |
| `output`       | arreglo de cadenas | no        | Formatos a devolver: `Markdown`, `HTML`, `json`, `screenshot`. por defecto `["html"]`. `json` devuelve los campos analizados. `screenshot` requiere `run_js: true`                           |
| `json`         | objeto             | no        | Extracción personalizada: `{"prompt": string}` o `{"schema": object}`, nunca ambos. Anula el analizador integrado                                                                            |
| `location`     | cadena             | no        | Código de país de dos letras para obtener, por ejemplo `DE`                                                                                                                                  |
| `device`       | cadena             | no        | `escritorio` (predeterminado) o `móvil`                                                                                                                                                      |
| `run_js`       | booleano           | no        | Ejecuta el JavaScript de la página antes de capturar. Más lento — use un tiempo de espera del cliente de 120 segundos o más                                                                  |
| `callback_url` | cadena             | no        | URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con `400`                                                                                        |
| `storage`      | objeto             | no        | Entrega el resultado a un bucket en lugar de la respuesta: `{"type": string, "url": string}`. `type` es `s3`, `s3_gzip`, `s3_compatible`, `gcs`, o `tos`. Solo asíncrono. `url` no se valida |

#### `POST /v1/scrape/safeway/category`

Devuelve los productos en una categoría de Safeway.

**Modos:** sincrónico · asincrónico

| Nombre         | Tipo               | Requerido | Descripción                                                                                                                                                                                  |
| -------------- | ------------------ | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`        | cadena             | sí        | Categoría                                                                                                                                                                                    |
| `zip_code`     | cadena             | no        | La entrega al código postal se cotiza para                                                                                                                                                   |
| `zip_code_url` | cadena             | no        | Código postal con formato para incluirse en la URL de la categoría                                                                                                                           |
| `output`       | arreglo de cadenas | no        | Formatos a devolver: `Markdown`, `HTML`, `json`, `screenshot`. por defecto `["html"]`. `json` devuelve los campos analizados. `screenshot` requiere `run_js: true`                           |
| `json`         | objeto             | no        | Extracción personalizada: `{"prompt": string}` o `{"schema": object}`, nunca ambos. Anula el analizador integrado                                                                            |
| `location`     | cadena             | no        | Código de país de dos letras para obtener, por ejemplo `DE`                                                                                                                                  |
| `device`       | cadena             | no        | `escritorio` (predeterminado) o `móvil`                                                                                                                                                      |
| `run_js`       | booleano           | no        | Ejecuta el JavaScript de la página antes de capturar. Más lento — use un tiempo de espera del cliente de 120 segundos o más                                                                  |
| `callback_url` | cadena             | no        | URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con `400`                                                                                        |
| `storage`      | objeto             | no        | Entrega el resultado a un bucket en lugar de la respuesta: `{"type": string, "url": string}`. `type` es `s3`, `s3_gzip`, `s3_compatible`, `gcs`, o `tos`. Solo asíncrono. `url` no se valida |

***

### Smith's

#### `POST /v1/scrape/smithsfoodanddrug`

Devuelve los campos analizados de una página de Smith's a partir de una URL que proporciones.

**Modos:** sincrónico · asincrónico

| Nombre             | Tipo               | Requerido | Descripción                                                                                                                                                                                  |
| ------------------ | ------------------ | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `url`              | cadena             | sí        | Una URL de producto o búsqueda de Smith's                                                                                                                                                    |
| `delivery_zip`     | cadena             | no        | La entrega al código postal se cotiza para                                                                                                                                                   |
| `fulfillment_type` | cadena             | no        | Filtro de entrega, recogida o envío a domicilio                                                                                                                                              |
| `store_id`         | cadena             | no        | La tienda cuyo catálogo y precios se devuelven                                                                                                                                               |
| `output`           | arreglo de cadenas | no        | Formatos a devolver: `Markdown`, `HTML`, `json`, `screenshot`. por defecto `["html"]`. `json` devuelve los campos analizados. `screenshot` requiere `run_js: true`                           |
| `json`             | objeto             | no        | Extracción personalizada: `{"prompt": string}` o `{"schema": object}`, nunca ambos. Anula el analizador integrado                                                                            |
| `location`         | cadena             | no        | Código de país de dos letras para obtener, por ejemplo `DE`                                                                                                                                  |
| `device`           | cadena             | no        | `escritorio` (predeterminado) o `móvil`                                                                                                                                                      |
| `run_js`           | booleano           | no        | Ejecuta el JavaScript de la página antes de capturar. Más lento — use un tiempo de espera del cliente de 120 segundos o más                                                                  |
| `callback_url`     | cadena             | no        | URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con `400`                                                                                        |
| `storage`          | objeto             | no        | Entrega el resultado a un bucket en lugar de la respuesta: `{"type": string, "url": string}`. `type` es `s3`, `s3_gzip`, `s3_compatible`, `gcs`, o `tos`. Solo asíncrono. `url` no se valida |

#### `POST /v1/scrape/smithsfoodanddrug/product`

Devuelve el precio, el stock y los detalles de un producto de Smith's.

**Modos:** sincrónico · asincrónico

| Nombre             | Tipo               | Requerido | Descripción                                                                                                                                                                                  |
| ------------------ | ------------------ | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`            | cadena             | sí        | ID del producto                                                                                                                                                                              |
| `delivery_zip`     | cadena             | no        | La entrega al código postal se cotiza para                                                                                                                                                   |
| `fulfillment_type` | cadena             | no        | Filtro de entrega, recogida o envío a domicilio                                                                                                                                              |
| `store_id`         | cadena             | no        | La tienda cuyo catálogo y precios se devuelven                                                                                                                                               |
| `output`           | arreglo de cadenas | no        | Formatos a devolver: `Markdown`, `HTML`, `json`, `screenshot`. por defecto `["html"]`. `json` devuelve los campos analizados. `screenshot` requiere `run_js: true`                           |
| `json`             | objeto             | no        | Extracción personalizada: `{"prompt": string}` o `{"schema": object}`, nunca ambos. Anula el analizador integrado                                                                            |
| `location`         | cadena             | no        | Código de país de dos letras para obtener, por ejemplo `DE`                                                                                                                                  |
| `device`           | cadena             | no        | `escritorio` (predeterminado) o `móvil`                                                                                                                                                      |
| `run_js`           | booleano           | no        | Ejecuta el JavaScript de la página antes de capturar. Más lento — use un tiempo de espera del cliente de 120 segundos o más                                                                  |
| `callback_url`     | cadena             | no        | URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con `400`                                                                                        |
| `storage`          | objeto             | no        | Entrega el resultado a un bucket en lugar de la respuesta: `{"type": string, "url": string}`. `type` es `s3`, `s3_gzip`, `s3_compatible`, `gcs`, o `tos`. Solo asíncrono. `url` no se valida |

#### `POST /v1/scrape/smithsfoodanddrug/search`

Devuelve resultados de búsqueda de Smith's para una palabra clave.

**Modos:** sincrónico · asincrónico

| Nombre             | Tipo               | Requerido | Descripción                                                                                                                                                                                  |
| ------------------ | ------------------ | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`            | cadena             | sí        | Palabra clave de búsqueda                                                                                                                                                                    |
| `brand`            | cadena             | no        | Restringe los resultados a una marca                                                                                                                                                         |
| `delivery_zip`     | cadena             | no        | La entrega al código postal se cotiza para                                                                                                                                                   |
| `fulfillment_type` | cadena             | no        | Filtro de entrega, recogida o envío a domicilio                                                                                                                                              |
| `price_range`      | cadena             | no        | Filtro de banda de precios                                                                                                                                                                   |
| `store_id`         | cadena             | no        | La tienda cuyo catálogo y precios se devuelven                                                                                                                                               |
| `output`           | arreglo de cadenas | no        | Formatos a devolver: `Markdown`, `HTML`, `json`, `screenshot`. por defecto `["html"]`. `json` devuelve los campos analizados. `screenshot` requiere `run_js: true`                           |
| `json`             | objeto             | no        | Extracción personalizada: `{"prompt": string}` o `{"schema": object}`, nunca ambos. Anula el analizador integrado                                                                            |
| `location`         | cadena             | no        | Código de país de dos letras para obtener, por ejemplo `DE`                                                                                                                                  |
| `device`           | cadena             | no        | `escritorio` (predeterminado) o `móvil`                                                                                                                                                      |
| `run_js`           | booleano           | no        | Ejecuta el JavaScript de la página antes de capturar. Más lento — use un tiempo de espera del cliente de 120 segundos o más                                                                  |
| `callback_url`     | cadena             | no        | URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con `400`                                                                                        |
| `storage`          | objeto             | no        | Entrega el resultado a un bucket en lugar de la respuesta: `{"type": string, "url": string}`. `type` es `s3`, `s3_gzip`, `s3_compatible`, `gcs`, o `tos`. Solo asíncrono. `url` no se valida |

***

### Target

#### `POST /v1/scrape/target`

Devuelve los campos analizados de una página de Target a partir de una URL que proporciones.

**Modos:** sincrónico · asincrónico

| Nombre             | Tipo               | Requerido | Descripción                                                                                                                                                                                  |
| ------------------ | ------------------ | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `url`              | cadena             | sí        | Una URL de producto o búsqueda de Target                                                                                                                                                     |
| `delivery_zip`     | cadena             | no        | La entrega al código postal se cotiza para                                                                                                                                                   |
| `fulfillment_type` | cadena             | no        | Filtro de entrega, recogida o envío a domicilio                                                                                                                                              |
| `store_id`         | cadena             | no        | La tienda cuyo catálogo y precios se devuelven                                                                                                                                               |
| `output`           | arreglo de cadenas | no        | Formatos a devolver: `Markdown`, `HTML`, `json`, `screenshot`. por defecto `["html"]`. `json` devuelve los campos analizados. `screenshot` requiere `run_js: true`                           |
| `json`             | objeto             | no        | Extracción personalizada: `{"prompt": string}` o `{"schema": object}`, nunca ambos. Anula el analizador integrado                                                                            |
| `location`         | cadena             | no        | Código de país de dos letras para obtener, por ejemplo `DE`                                                                                                                                  |
| `device`           | cadena             | no        | `escritorio` (predeterminado) o `móvil`                                                                                                                                                      |
| `run_js`           | booleano           | no        | Ejecuta el JavaScript de la página antes de capturar. Más lento — use un tiempo de espera del cliente de 120 segundos o más                                                                  |
| `callback_url`     | cadena             | no        | URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con `400`                                                                                        |
| `storage`          | objeto             | no        | Entrega el resultado a un bucket en lugar de la respuesta: `{"type": string, "url": string}`. `type` es `s3`, `s3_gzip`, `s3_compatible`, `gcs`, o `tos`. Solo asíncrono. `url` no se valida |

#### `POST /v1/scrape/target/category`

Devuelve los productos en una categoría de Target.

**Modos:** sincrónico · asincrónico

| Nombre             | Tipo               | Requerido | Descripción                                                                                                                                                                                  |
| ------------------ | ------------------ | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`            | cadena             | sí        | Categoría                                                                                                                                                                                    |
| `delivery_zip`     | cadena             | no        | La entrega al código postal se cotiza para                                                                                                                                                   |
| `fulfillment_type` | cadena             | no        | Filtro de entrega, recogida o envío a domicilio                                                                                                                                              |
| `store_id`         | cadena             | no        | La tienda cuyo catálogo y precios se devuelven                                                                                                                                               |
| `output`           | arreglo de cadenas | no        | Formatos a devolver: `Markdown`, `HTML`, `json`, `screenshot`. por defecto `["html"]`. `json` devuelve los campos analizados. `screenshot` requiere `run_js: true`                           |
| `json`             | objeto             | no        | Extracción personalizada: `{"prompt": string}` o `{"schema": object}`, nunca ambos. Anula el analizador integrado                                                                            |
| `location`         | cadena             | no        | Código de país de dos letras para obtener, por ejemplo `DE`                                                                                                                                  |
| `device`           | cadena             | no        | `escritorio` (predeterminado) o `móvil`                                                                                                                                                      |
| `run_js`           | booleano           | no        | Ejecuta el JavaScript de la página antes de capturar. Más lento — use un tiempo de espera del cliente de 120 segundos o más                                                                  |
| `callback_url`     | cadena             | no        | URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con `400`                                                                                        |
| `storage`          | objeto             | no        | Entrega el resultado a un bucket en lugar de la respuesta: `{"type": string, "url": string}`. `type` es `s3`, `s3_gzip`, `s3_compatible`, `gcs`, o `tos`. Solo asíncrono. `url` no se valida |

#### `POST /v1/scrape/target/product`

Devuelve el precio, el stock y los detalles de un producto de Target.

**Modos:** sincrónico · asincrónico

| Nombre             | Tipo               | Requerido | Descripción                                                                                                                                                                                  |
| ------------------ | ------------------ | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`            | cadena             | sí        | ID del producto                                                                                                                                                                              |
| `delivery_zip`     | cadena             | no        | La entrega al código postal se cotiza para                                                                                                                                                   |
| `fulfillment_type` | cadena             | no        | Filtro de entrega, recogida o envío a domicilio                                                                                                                                              |
| `store_id`         | cadena             | no        | La tienda cuyo catálogo y precios se devuelven                                                                                                                                               |
| `output`           | arreglo de cadenas | no        | Formatos a devolver: `Markdown`, `HTML`, `json`, `screenshot`. por defecto `["html"]`. `json` devuelve los campos analizados. `screenshot` requiere `run_js: true`                           |
| `json`             | objeto             | no        | Extracción personalizada: `{"prompt": string}` o `{"schema": object}`, nunca ambos. Anula el analizador integrado                                                                            |
| `location`         | cadena             | no        | Código de país de dos letras para obtener, por ejemplo `DE`                                                                                                                                  |
| `device`           | cadena             | no        | `escritorio` (predeterminado) o `móvil`                                                                                                                                                      |
| `run_js`           | booleano           | no        | Ejecuta el JavaScript de la página antes de capturar. Más lento — use un tiempo de espera del cliente de 120 segundos o más                                                                  |
| `callback_url`     | cadena             | no        | URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con `400`                                                                                        |
| `storage`          | objeto             | no        | Entrega el resultado a un bucket en lugar de la respuesta: `{"type": string, "url": string}`. `type` es `s3`, `s3_gzip`, `s3_compatible`, `gcs`, o `tos`. Solo asíncrono. `url` no se valida |

#### `POST /v1/scrape/target/search`

Devuelve resultados de búsqueda de Target para una palabra clave.

**Modos:** sincrónico · asincrónico

| Nombre             | Tipo               | Requerido | Descripción                                                                                                                                                                                  |
| ------------------ | ------------------ | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`            | cadena             | sí        | Palabra clave de búsqueda                                                                                                                                                                    |
| `delivery_zip`     | cadena             | no        | La entrega al código postal se cotiza para                                                                                                                                                   |
| `fulfillment_type` | cadena             | no        | Filtro de entrega, recogida o envío a domicilio                                                                                                                                              |
| `store_id`         | cadena             | no        | La tienda cuyo catálogo y precios se devuelven                                                                                                                                               |
| `output`           | arreglo de cadenas | no        | Formatos a devolver: `Markdown`, `HTML`, `json`, `screenshot`. por defecto `["html"]`. `json` devuelve los campos analizados. `screenshot` requiere `run_js: true`                           |
| `json`             | objeto             | no        | Extracción personalizada: `{"prompt": string}` o `{"schema": object}`, nunca ambos. Anula el analizador integrado                                                                            |
| `location`         | cadena             | no        | Código de país de dos letras para obtener, por ejemplo `DE`                                                                                                                                  |
| `device`           | cadena             | no        | `escritorio` (predeterminado) o `móvil`                                                                                                                                                      |
| `run_js`           | booleano           | no        | Ejecuta el JavaScript de la página antes de capturar. Más lento — use un tiempo de espera del cliente de 120 segundos o más                                                                  |
| `callback_url`     | cadena             | no        | URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con `400`                                                                                        |
| `storage`          | objeto             | no        | Entrega el resultado a un bucket en lugar de la respuesta: `{"type": string, "url": string}`. `type` es `s3`, `s3_gzip`, `s3_compatible`, `gcs`, o `tos`. Solo asíncrono. `url` no se valida |

***

### TikTok Shop

#### `POST /v1/scrape/tiktok`

Devuelve los campos analizados de una página de TikTok Shop a partir de una URL que proporciones.

**Modos:** sincrónico · asincrónico

| Nombre         | Tipo               | Requerido | Descripción                                                                                                                                                                                  |
| -------------- | ------------------ | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `url`          | cadena             | sí        | Una URL de producto o búsqueda de TikTok Shop                                                                                                                                                |
| `output`       | arreglo de cadenas | no        | Formatos a devolver: `Markdown`, `HTML`, `json`, `screenshot`. por defecto `["html"]`. `json` devuelve los campos analizados. `screenshot` requiere `run_js: true`                           |
| `json`         | objeto             | no        | Extracción personalizada: `{"prompt": string}` o `{"schema": object}`, nunca ambos. Anula el analizador integrado                                                                            |
| `location`     | cadena             | no        | Código de país de dos letras para obtener, por ejemplo `DE`                                                                                                                                  |
| `device`       | cadena             | no        | `escritorio` (predeterminado) o `móvil`                                                                                                                                                      |
| `run_js`       | booleano           | no        | Ejecuta el JavaScript de la página antes de capturar. Más lento — use un tiempo de espera del cliente de 120 segundos o más                                                                  |
| `callback_url` | cadena             | no        | URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con `400`                                                                                        |
| `storage`      | objeto             | no        | Entrega el resultado a un bucket en lugar de la respuesta: `{"type": string, "url": string}`. `type` es `s3`, `s3_gzip`, `s3_compatible`, `gcs`, o `tos`. Solo asíncrono. `url` no se valida |

#### `POST /v1/scrape/tiktok/shop/product`

Devuelve el precio, el stock y los detalles de un producto de TikTok Shop.

**Modos:** sincrónico · asincrónico

| Nombre         | Tipo               | Requerido | Descripción                                                                                                                                                                                  |
| -------------- | ------------------ | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`        | cadena             | sí        | ID del producto                                                                                                                                                                              |
| `country`      | cadena             | no        | Marketplace nacional a consultar                                                                                                                                                             |
| `uuid`         | cadena             | no        | Identifica un anuncio de producto específico cuando `query` por sí solo es ambiguo                                                                                                           |
| `output`       | arreglo de cadenas | no        | Formatos a devolver: `Markdown`, `HTML`, `json`, `screenshot`. por defecto `["html"]`. `json` devuelve los campos analizados. `screenshot` requiere `run_js: true`                           |
| `json`         | objeto             | no        | Extracción personalizada: `{"prompt": string}` o `{"schema": object}`, nunca ambos. Anula el analizador integrado                                                                            |
| `location`     | cadena             | no        | Código de país de dos letras para obtener, por ejemplo `DE`                                                                                                                                  |
| `device`       | cadena             | no        | `escritorio` (predeterminado) o `móvil`                                                                                                                                                      |
| `run_js`       | booleano           | no        | Ejecuta el JavaScript de la página antes de capturar. Más lento — use un tiempo de espera del cliente de 120 segundos o más                                                                  |
| `callback_url` | cadena             | no        | URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con `400`                                                                                        |
| `storage`      | objeto             | no        | Entrega el resultado a un bucket en lugar de la respuesta: `{"type": string, "url": string}`. `type` es `s3`, `s3_gzip`, `s3_compatible`, `gcs`, o `tos`. Solo asíncrono. `url` no se valida |

#### `POST /v1/scrape/tiktok/shop/search`

Devuelve resultados de búsqueda de TikTok Shop para una palabra clave.

**Modos:** sincrónico · asincrónico

| Nombre         | Tipo               | Requerido | Descripción                                                                                                                                                                                  |
| -------------- | ------------------ | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`        | cadena             | sí        | Palabra clave de búsqueda                                                                                                                                                                    |
| `country`      | cadena             | no        | Marketplace nacional a consultar                                                                                                                                                             |
| `output`       | arreglo de cadenas | no        | Formatos a devolver: `Markdown`, `HTML`, `json`, `screenshot`. por defecto `["html"]`. `json` devuelve los campos analizados. `screenshot` requiere `run_js: true`                           |
| `json`         | objeto             | no        | Extracción personalizada: `{"prompt": string}` o `{"schema": object}`, nunca ambos. Anula el analizador integrado                                                                            |
| `location`     | cadena             | no        | Código de país de dos letras para obtener, por ejemplo `DE`                                                                                                                                  |
| `device`       | cadena             | no        | `escritorio` (predeterminado) o `móvil`                                                                                                                                                      |
| `run_js`       | booleano           | no        | Ejecuta el JavaScript de la página antes de capturar. Más lento — use un tiempo de espera del cliente de 120 segundos o más                                                                  |
| `callback_url` | cadena             | no        | URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con `400`                                                                                        |
| `storage`      | objeto             | no        | Entrega el resultado a un bucket en lugar de la respuesta: `{"type": string, "url": string}`. `type` es `s3`, `s3_gzip`, `s3_compatible`, `gcs`, o `tos`. Solo asíncrono. `url` no se valida |

TikTok Shop es un marketplace nacional, así que toma `country` en lugar de `store_id`.

***

### Walmart

#### `POST /v1/scrape/walmart`

Devuelve los campos analizados de una página de Walmart a partir de una URL que proporciones.

**Modos:** sincrónico · asincrónico

| Nombre             | Tipo               | Requerido | Descripción                                                                                                                                                                                  |
| ------------------ | ------------------ | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `url`              | cadena             | sí        | Una URL de producto o búsqueda de Walmart                                                                                                                                                    |
| `fulfillment_type` | cadena             | no        | Filtro de entrega, recogida o envío a domicilio                                                                                                                                              |
| `store_id`         | cadena             | no        | La tienda cuyo catálogo y precios se devuelven                                                                                                                                               |
| `output`           | arreglo de cadenas | no        | Formatos a devolver: `Markdown`, `HTML`, `json`, `screenshot`. por defecto `["html"]`. `json` devuelve los campos analizados. `screenshot` requiere `run_js: true`                           |
| `json`             | objeto             | no        | Extracción personalizada: `{"prompt": string}` o `{"schema": object}`, nunca ambos. Anula el analizador integrado                                                                            |
| `location`         | cadena             | no        | Código de país de dos letras para obtener, por ejemplo `DE`                                                                                                                                  |
| `device`           | cadena             | no        | `escritorio` (predeterminado) o `móvil`                                                                                                                                                      |
| `run_js`           | booleano           | no        | Ejecuta el JavaScript de la página antes de capturar. Más lento — use un tiempo de espera del cliente de 120 segundos o más                                                                  |
| `callback_url`     | cadena             | no        | URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con `400`                                                                                        |
| `storage`          | objeto             | no        | Entrega el resultado a un bucket en lugar de la respuesta: `{"type": string, "url": string}`. `type` es `s3`, `s3_gzip`, `s3_compatible`, `gcs`, o `tos`. Solo asíncrono. `url` no se valida |

#### `POST /v1/scrape/walmart/product`

Devuelve el precio, el stock y los detalles de un producto de Walmart.

**Modos:** sincrónico · asincrónico

| Nombre             | Tipo               | Requerido | Descripción                                                                                                                                                                                  |
| ------------------ | ------------------ | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`            | cadena             | sí        | ID del producto                                                                                                                                                                              |
| `domain`           | cadena             | no        | TLD de la tienda                                                                                                                                                                             |
| `fulfillment_type` | cadena             | no        | Filtro de entrega, recogida o envío a domicilio                                                                                                                                              |
| `store_id`         | cadena             | no        | La tienda cuyo catálogo y precios se devuelven                                                                                                                                               |
| `output`           | arreglo de cadenas | no        | Formatos a devolver: `Markdown`, `HTML`, `json`, `screenshot`. por defecto `["html"]`. `json` devuelve los campos analizados. `screenshot` requiere `run_js: true`                           |
| `json`             | objeto             | no        | Extracción personalizada: `{"prompt": string}` o `{"schema": object}`, nunca ambos. Anula el analizador integrado                                                                            |
| `location`         | cadena             | no        | Código de país de dos letras para obtener, por ejemplo `DE`                                                                                                                                  |
| `device`           | cadena             | no        | `escritorio` (predeterminado) o `móvil`                                                                                                                                                      |
| `run_js`           | booleano           | no        | Ejecuta el JavaScript de la página antes de capturar. Más lento — use un tiempo de espera del cliente de 120 segundos o más                                                                  |
| `callback_url`     | cadena             | no        | URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con `400`                                                                                        |
| `storage`          | objeto             | no        | Entrega el resultado a un bucket en lugar de la respuesta: `{"type": string, "url": string}`. `type` es `s3`, `s3_gzip`, `s3_compatible`, `gcs`, o `tos`. Solo asíncrono. `url` no se valida |

#### `POST /v1/scrape/walmart/search`

Devuelve resultados de búsqueda de Walmart para una palabra clave.

**Modos:** sincrónico · asincrónico

| Nombre              | Tipo               | Requerido | Descripción                                                                                                                                                                                  |
| ------------------- | ------------------ | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`             | cadena             | sí        | Palabra clave de búsqueda                                                                                                                                                                    |
| `domain`            | cadena             | no        | TLD de la tienda                                                                                                                                                                             |
| `fulfillment_speed` | cadena             | no        | Velocidad de entrega exprés o estándar                                                                                                                                                       |
| `fulfillment_type`  | cadena             | no        | Filtro de entrega, recogida o envío a domicilio                                                                                                                                              |
| `max_price`         | entero             | no        | Precio máximo a incluir, en la moneda del marketplace                                                                                                                                        |
| `min_price`         | entero             | no        | Precio mínimo a incluir, en la moneda del marketplace                                                                                                                                        |
| `sort_by`           | cadena             | no        | La clave de ordenación propia de Walmart, pasada literalmente                                                                                                                                |
| `start_page`        | entero             | no        | Primera página de resultados                                                                                                                                                                 |
| `store_id`          | cadena             | no        | La tienda cuyo catálogo y precios se devuelven                                                                                                                                               |
| `output`            | arreglo de cadenas | no        | Formatos a devolver: `Markdown`, `HTML`, `json`, `screenshot`. por defecto `["html"]`. `json` devuelve los campos analizados. `screenshot` requiere `run_js: true`                           |
| `json`              | objeto             | no        | Extracción personalizada: `{"prompt": string}` o `{"schema": object}`, nunca ambos. Anula el analizador integrado                                                                            |
| `location`          | cadena             | no        | Código de país de dos letras para obtener, por ejemplo `DE`                                                                                                                                  |
| `device`            | cadena             | no        | `escritorio` (predeterminado) o `móvil`                                                                                                                                                      |
| `run_js`            | booleano           | no        | Ejecuta el JavaScript de la página antes de capturar. Más lento — use un tiempo de espera del cliente de 120 segundos o más                                                                  |
| `callback_url`      | cadena             | no        | URL de webhook para el trabajo finalizado. Solo asíncrono. Las URL mal formadas se rechazan con `400`                                                                                        |
| `storage`           | objeto             | no        | Entrega el resultado a un bucket en lugar de la respuesta: `{"type": string, "url": string}`. `type` es `s3`, `s3_gzip`, `s3_compatible`, `gcs`, o `tos`. Solo asíncrono. `url` no se valida |

`fulfillment_speed` cambia tanto el conjunto de artículos como el precio cotizado.


---

# 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/api-reference/es/scrapers-dedicados/scrapers-de-comercio.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.
