> 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/pt-br/scrapers-dedicados/scrapers-de-comercio.md).

# Scrapers de comércio

Referência para endpoints de scraper de comércio da Web API: Amazon, Walmart, Target, os banners da Kroger e outros. Parâmetros e modos de entrega de cada endpoint.

Use a barra de busca da tabela para encontrar um scraper de comércio dedicado e clique em um alvo para ir para seus endpoints.

<table><thead><tr><th width="170.5">Raspador</th><th>Endpoints</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`

Retorna campos analisados de uma página do Alibaba a partir de uma URL que você fornecer.

**Modos:** `sync`, `async`

<table><thead><tr><th width="144.5">Nome</th><th width="92.5">Tipo</th><th width="88">Obrigatório</th><th>Descrição</th></tr></thead><tbody><tr><td><code>url</code></td><td>string</td><td>sim</td><td>Uma URL de produto ou de busca do Alibaba</td></tr><tr><td><code>output</code></td><td>array de strings</td><td>não</td><td>Formatos a retornar: <code>markdown</code>, <code>html</code>, <code>json</code>, <code>screenshot</code>. Padrão <code>["html"]</code>. <code>json</code> retorna campos analisados. <code>screenshot</code> requer <code>run_js: true</code></td></tr><tr><td><code>json</code></td><td>objeto</td><td>não</td><td>Extração personalizada: <code>{"prompt": string}</code> ou <code>{"schema": object}</code>, nunca ambos. Substitui o parser embutido</td></tr><tr><td><code>location</code></td><td>string</td><td>não</td><td>Código de país de duas letras para buscar, por exemplo <code>DE</code></td></tr><tr><td><code>device</code></td><td>string</td><td>não</td><td><code>desktop</code> (padrão) ou <code>mobile</code></td></tr><tr><td><code>run_js</code></td><td>booleano</td><td>não</td><td>Executa o JavaScript da página antes da captura. Mais lento. Use um timeout do cliente de 150 segundos ou mais</td></tr><tr><td><code>callback_url</code></td><td>string</td><td>não</td><td>URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com <code>400</code></td></tr><tr><td><code>storage</code></td><td>objeto</td><td>não</td><td>Entrega o resultado em um bucket em vez da resposta: <code>{"type": string, "url": string}</code>. <code>tipo</code> é <code>s3</code>, <code>s3_gzip</code>, <code>s3_compatible</code>, <code>gcs</code>, ou <code>tos</code>. Somente assíncrono. <code>url</code> não é validado</td></tr></tbody></table>

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

Retorna o preço, o estoque e os detalhes de um produto do Alibaba.

**Modos:** `sync`, `async`

<table><thead><tr><th width="143">Nome</th><th width="89">Tipo</th><th width="84">Obrigatório</th><th>Descrição</th></tr></thead><tbody><tr><td><code>query</code></td><td>string</td><td>sim</td><td>ID do produto</td></tr><tr><td><code>domain</code></td><td>string</td><td>não</td><td>TLD da loja</td></tr><tr><td><code>output</code></td><td>array de strings</td><td>não</td><td>Formatos a retornar: <code>markdown</code>, <code>html</code>, <code>json</code>, <code>screenshot</code>. Padrão <code>["html"]</code>. <code>json</code> retorna campos analisados. <code>screenshot</code> requer <code>run_js: true</code></td></tr><tr><td><code>json</code></td><td>objeto</td><td>não</td><td>Extração personalizada: <code>{"prompt": string}</code> ou <code>{"schema": object}</code>, nunca ambos. Substitui o parser embutido</td></tr><tr><td><code>location</code></td><td>string</td><td>não</td><td>Código de país de duas letras para buscar, por exemplo <code>DE</code></td></tr><tr><td><code>device</code></td><td>string</td><td>não</td><td><code>desktop</code> (padrão) ou <code>mobile</code></td></tr><tr><td><code>run_js</code></td><td>booleano</td><td>não</td><td>Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 150 segundos ou mais</td></tr><tr><td><code>callback_url</code></td><td>string</td><td>não</td><td>URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com <code>400</code></td></tr><tr><td><code>storage</code></td><td>objeto</td><td>não</td><td>Entrega o resultado em um bucket em vez da resposta: <code>{"type": string, "url": string}</code>. <code>tipo</code> é <code>s3</code>, <code>s3_gzip</code>, <code>s3_compatible</code>, <code>gcs</code>, ou <code>tos</code>. Somente assíncrono. <code>url</code> não é validado</td></tr></tbody></table>

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

Retorna resultados de busca do Alibaba para uma palavra-chave.

**Modos:** `sync`, `async`

<table><thead><tr><th width="132">Nome</th><th width="95">Tipo</th><th width="93">Obrigatório</th><th>Descrição</th></tr></thead><tbody><tr><td><code>query</code></td><td>string</td><td>sim</td><td>Palavra-chave de busca</td></tr><tr><td><code>domain</code></td><td>string</td><td>não</td><td>TLD da loja</td></tr><tr><td><code>start_page</code></td><td>inteiro</td><td>não</td><td>Primeira página de resultados</td></tr><tr><td><code>output</code></td><td>array de strings</td><td>não</td><td>Formatos a retornar: <code>markdown</code>, <code>html</code>, <code>json</code>, <code>screenshot</code>. Padrão <code>["html"]</code>. <code>json</code> retorna campos analisados. <code>screenshot</code> requer <code>run_js: true</code></td></tr><tr><td><code>json</code></td><td>objeto</td><td>não</td><td>Extração personalizada: <code>{"prompt": string}</code> ou <code>{"schema": object}</code>, nunca ambos. Substitui o parser embutido</td></tr><tr><td><code>location</code></td><td>string</td><td>não</td><td>Código de país de duas letras para buscar, por exemplo <code>DE</code></td></tr><tr><td><code>device</code></td><td>string</td><td>não</td><td><code>desktop</code> (padrão) ou <code>mobile</code></td></tr><tr><td><code>run_js</code></td><td>booleano</td><td>não</td><td>Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 150 segundos ou mais</td></tr><tr><td><code>callback_url</code></td><td>string</td><td>não</td><td>URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com <code>400</code></td></tr><tr><td><code>storage</code></td><td>objeto</td><td>não</td><td>Entrega o resultado em um bucket em vez da resposta: <code>{"type": string, "url": string}</code>. <code>tipo</code> é <code>s3</code>, <code>s3_gzip</code>, <code>s3_compatible</code>, <code>gcs</code>, ou <code>tos</code>. Somente assíncrono. <code>url</code> não é validado</td></tr></tbody></table>

### AliExpress

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

Retorna campos analisados de uma página do AliExpress a partir de uma URL que você fornecer.

**Modos:** `sync`, `async`

<table><thead><tr><th width="138">Nome</th><th width="95">Tipo</th><th width="89">Obrigatório</th><th>Descrição</th></tr></thead><tbody><tr><td><code>url</code></td><td>string</td><td>sim</td><td>Uma URL de produto ou de busca do AliExpress</td></tr><tr><td><code>output</code></td><td>array de strings</td><td>não</td><td>Formatos a retornar: <code>markdown</code>, <code>html</code>, <code>json</code>, <code>screenshot</code>. Padrão <code>["html"]</code>. <code>json</code> retorna campos analisados. <code>screenshot</code> requer <code>run_js: true</code></td></tr><tr><td><code>json</code></td><td>objeto</td><td>não</td><td>Extração personalizada: <code>{"prompt": string}</code> ou <code>{"schema": object}</code>, nunca ambos. Substitui o parser embutido</td></tr><tr><td><code>location</code></td><td>string</td><td>não</td><td>Código de país de duas letras para buscar, por exemplo <code>DE</code></td></tr><tr><td><code>device</code></td><td>string</td><td>não</td><td><code>desktop</code> (padrão) ou <code>mobile</code></td></tr><tr><td><code>run_js</code></td><td>booleano</td><td>não</td><td>Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 150 segundos ou mais</td></tr><tr><td><code>callback_url</code></td><td>string</td><td>não</td><td>URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com <code>400</code></td></tr><tr><td><code>storage</code></td><td>objeto</td><td>não</td><td>Entrega o resultado em um bucket em vez da resposta: <code>{"type": string, "url": string}</code>. <code>tipo</code> é <code>s3</code>, <code>s3_gzip</code>, <code>s3_compatible</code>, <code>gcs</code>, ou <code>tos</code>. Somente assíncrono. <code>url</code> não é validado</td></tr></tbody></table>

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

Retorna o preço, o estoque e os detalhes de um produto do AliExpress.

**Modos:** `sync`, `async`

<table><thead><tr><th width="134">Nome</th><th width="90">Tipo</th><th width="85">Obrigatório</th><th>Descrição</th></tr></thead><tbody><tr><td><code>query</code></td><td>string</td><td>sim</td><td>ID do produto</td></tr><tr><td><code>domain</code></td><td>string</td><td>não</td><td>TLD da loja</td></tr><tr><td><code>subdomain</code></td><td>string</td><td>não</td><td>Subdomínio regional da loja</td></tr><tr><td><code>output</code></td><td>array de strings</td><td>não</td><td>Formatos a retornar: <code>markdown</code>, <code>html</code>, <code>json</code>, <code>screenshot</code>. Padrão <code>["html"]</code>. <code>json</code> retorna campos analisados. <code>screenshot</code> requer <code>run_js: true</code></td></tr><tr><td><code>json</code></td><td>objeto</td><td>não</td><td>Extração personalizada: <code>{"prompt": string}</code> ou <code>{"schema": object}</code>, nunca ambos. Substitui o parser embutido</td></tr><tr><td><code>location</code></td><td>string</td><td>não</td><td>Código de país de duas letras para buscar, por exemplo <code>DE</code></td></tr><tr><td><code>device</code></td><td>string</td><td>não</td><td><code>desktop</code> (padrão) ou <code>mobile</code></td></tr><tr><td><code>run_js</code></td><td>booleano</td><td>não</td><td>Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 150 segundos ou mais</td></tr><tr><td><code>callback_url</code></td><td>string</td><td>não</td><td>URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com <code>400</code></td></tr><tr><td><code>storage</code></td><td>objeto</td><td>não</td><td>Entrega o resultado em um bucket em vez da resposta: <code>{"type": string, "url": string}</code>. <code>tipo</code> é <code>s3</code>, <code>s3_gzip</code>, <code>s3_compatible</code>, <code>gcs</code>, ou <code>tos</code>. Somente assíncrono. <code>url</code> não é validado</td></tr></tbody></table>

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

Retorna resultados de busca do AliExpress para uma palavra-chave.

**Modos:** `sync`, `async`

<table><thead><tr><th width="136">Nome</th><th width="95">Tipo</th><th width="86">Obrigatório</th><th>Descrição</th></tr></thead><tbody><tr><td><code>query</code></td><td>string</td><td>sim</td><td>Palavra-chave de busca</td></tr><tr><td><code>domain</code></td><td>string</td><td>não</td><td>TLD da loja</td></tr><tr><td><code>start_page</code></td><td>inteiro</td><td>não</td><td>Primeira página de resultados</td></tr><tr><td><code>output</code></td><td>array de strings</td><td>não</td><td>Formatos a retornar: <code>markdown</code>, <code>html</code>, <code>json</code>, <code>screenshot</code>. Padrão <code>["html"]</code>. <code>json</code> retorna campos analisados. <code>screenshot</code> requer <code>run_js: true</code></td></tr><tr><td><code>json</code></td><td>objeto</td><td>não</td><td>Extração personalizada: <code>{"prompt": string}</code> ou <code>{"schema": object}</code>, nunca ambos. Substitui o parser embutido</td></tr><tr><td><code>location</code></td><td>string</td><td>não</td><td>Código de país de duas letras para buscar, por exemplo <code>DE</code></td></tr><tr><td><code>device</code></td><td>string</td><td>não</td><td><code>desktop</code> (padrão) ou <code>mobile</code></td></tr><tr><td><code>run_js</code></td><td>booleano</td><td>não</td><td>Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 150 segundos ou mais</td></tr><tr><td><code>callback_url</code></td><td>string</td><td>não</td><td>URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com <code>400</code></td></tr><tr><td><code>storage</code></td><td>objeto</td><td>não</td><td>Entrega o resultado em um bucket em vez da resposta: <code>{"type": string, "url": string}</code>. <code>tipo</code> é <code>s3</code>, <code>s3_gzip</code>, <code>s3_compatible</code>, <code>gcs</code>, ou <code>tos</code>. Somente assíncrono. <code>url</code> não é validado</td></tr></tbody></table>

### Allegro

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

Retorna o preço, o estoque e os detalhes de um produto do Allegro.

**Modos:** `sync`, `async`

<table><thead><tr><th width="139">Nome</th><th width="92">Tipo</th><th width="83">Obrigatório</th><th>Descrição</th></tr></thead><tbody><tr><td><code>query</code></td><td>string</td><td>sim</td><td>ID do produto</td></tr><tr><td><code>output</code></td><td>array de strings</td><td>não</td><td>Formatos a retornar: <code>markdown</code>, <code>html</code>, <code>json</code>, <code>screenshot</code>. Padrão <code>["html"]</code>. <code>json</code> retorna campos analisados. <code>screenshot</code> requer <code>run_js: true</code></td></tr><tr><td><code>json</code></td><td>objeto</td><td>não</td><td>Extração personalizada: <code>{"prompt": string}</code> ou <code>{"schema": object}</code>, nunca ambos. Substitui o parser embutido</td></tr><tr><td><code>location</code></td><td>string</td><td>não</td><td>Código de país de duas letras para buscar, por exemplo <code>DE</code></td></tr><tr><td><code>device</code></td><td>string</td><td>não</td><td><code>desktop</code> (padrão) ou <code>mobile</code></td></tr><tr><td><code>run_js</code></td><td>booleano</td><td>não</td><td>Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 150 segundos ou mais</td></tr><tr><td><code>callback_url</code></td><td>string</td><td>não</td><td>URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com <code>400</code></td></tr><tr><td><code>storage</code></td><td>objeto</td><td>não</td><td>Entrega o resultado em um bucket em vez da resposta: <code>{"type": string, "url": string}</code>. <code>tipo</code> é <code>s3</code>, <code>s3_gzip</code>, <code>s3_compatible</code>, <code>gcs</code>, ou <code>tos</code>. Somente assíncrono. <code>url</code> não é validado</td></tr></tbody></table>

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

Retorna resultados de busca do Allegro para uma palavra-chave.

**Modos:** `sync`, `async`

<table><thead><tr><th width="139">Nome</th><th width="87">Tipo</th><th width="82">Obrigatório</th><th>Descrição</th></tr></thead><tbody><tr><td><code>query</code></td><td>string</td><td>sim</td><td>Palavra-chave de busca</td></tr><tr><td><code>delivery_time</code></td><td>string</td><td>não</td><td>Filtro de janela de velocidade de entrega</td></tr><tr><td><code>domain</code></td><td>string</td><td>não</td><td>TLD da loja</td></tr><tr><td><code>shipping_from</code></td><td>string</td><td>não</td><td>País ou região de onde o item é enviado</td></tr><tr><td><code>start_page</code></td><td>inteiro</td><td>não</td><td>Primeira página de resultados</td></tr><tr><td><code>store_city</code></td><td>string</td><td>não</td><td>Cidade do vendedor</td></tr><tr><td><code>store_region</code></td><td>string</td><td>não</td><td>Região do vendedor</td></tr><tr><td><code>output</code></td><td>array de strings</td><td>não</td><td>Formatos a retornar: <code>markdown</code>, <code>html</code>, <code>json</code>, <code>screenshot</code>. Padrão <code>["html"]</code>. <code>json</code> retorna campos analisados. <code>screenshot</code> requer <code>run_js: true</code></td></tr><tr><td><code>json</code></td><td>objeto</td><td>não</td><td>Extração personalizada: <code>{"prompt": string}</code> ou <code>{"schema": object}</code>, nunca ambos. Substitui o parser embutido</td></tr><tr><td><code>location</code></td><td>string</td><td>não</td><td>Código de país de duas letras para buscar, por exemplo <code>DE</code></td></tr><tr><td><code>device</code></td><td>string</td><td>não</td><td><code>desktop</code> (padrão) ou <code>mobile</code></td></tr><tr><td><code>run_js</code></td><td>booleano</td><td>não</td><td>Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 150 segundos ou mais</td></tr><tr><td><code>callback_url</code></td><td>string</td><td>não</td><td>URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com <code>400</code></td></tr><tr><td><code>storage</code></td><td>objeto</td><td>não</td><td>Entrega o resultado em um bucket em vez da resposta: <code>{"type": string, "url": string}</code>. <code>tipo</code> é <code>s3</code>, <code>s3_gzip</code>, <code>s3_compatible</code>, <code>gcs</code>, ou <code>tos</code>. Somente assíncrono. <code>url</code> não é validado</td></tr></tbody></table>

### Amazon

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

Retorna campos analisados de uma página da Amazon a partir de uma URL que você fornecer.

**Modos:** `sync`, `async`, `batch`

<table><thead><tr><th width="177">Nome</th><th width="98">Tipo</th><th width="82">Obrigatório</th><th>Descrição</th></tr></thead><tbody><tr><td><code>url</code></td><td>string</td><td>sim</td><td>Uma URL em qualquer marketplace da Amazon. Envie-a sem alterações — os parâmetros da string de consulta selecionam a variante e o preço</td></tr><tr><td><code>autoselect_variant</code></td><td>booleano</td><td>não</td><td>Segue a variante padrão do anúncio em vez de retornar apenas o anúncio pai. Defina quando um ASIN pai não retornar preço</td></tr><tr><td><code>category_id</code></td><td>string</td><td>não</td><td>Restringe a um nó de navegação da Amazon</td></tr><tr><td><code>check_empty_geo</code></td><td>booleano</td><td>não</td><td>Faz a solicitação falhar em vez de retornar conteúdo ignorado <code>location</code></td></tr><tr><td><code>condition</code></td><td>string</td><td>não</td><td>Condição da oferta a retornar, por exemplo, <code>usado</code></td></tr><tr><td><code>currency</code></td><td>string</td><td>não</td><td>Moeda para reportar os preços, por exemplo, <code>EUR</code></td></tr><tr><td><code>locale</code></td><td>string</td><td>não</td><td>Idioma da interface, por exemplo, <code>en_US</code></td></tr><tr><td><code>max_price</code></td><td>inteiro</td><td>não</td><td>Preço máximo a incluir, na moeda do marketplace</td></tr><tr><td><code>merchant_id</code></td><td>string</td><td>não</td><td>Restringe aos itens de um vendedor</td></tr><tr><td><code>min_price</code></td><td>inteiro</td><td>não</td><td>Preço mínimo a incluir, na moeda do marketplace</td></tr><tr><td><code>pages</code></td><td>inteiro</td><td>não</td><td>Páginas consecutivas de onde buscar <code>start_page</code>. Cada página é uma busca e cobrança separadas</td></tr><tr><td><code>refinements</code></td><td>array de strings</td><td>não</td><td>Facetas de filtro da Amazon: marca, avaliação, elegibilidade ao Prime. Encaminhadas literalmente; os valores diferem por marketplace</td></tr><tr><td><code>safe_search</code></td><td>booleano</td><td>não</td><td>Filtro de conteúdo da Amazon</td></tr><tr><td><code>sort_by</code></td><td>string</td><td>não</td><td>Chave de ordenação própria da Amazon, por exemplo, <code>price-asc-rank</code>, <code>review-rank</code>. Encaminhado literalmente; os valores diferem por marketplace</td></tr><tr><td><code>start_page</code></td><td>inteiro</td><td>não</td><td>Primeira página de resultados. Padrão <code>1</code></td></tr><tr><td><code>output</code></td><td>array de strings</td><td>não</td><td>Formatos a retornar: <code>markdown</code>, <code>html</code>, <code>json</code>, <code>screenshot</code>. Padrão <code>["html"]</code>. <code>json</code> retorna campos analisados. <code>screenshot</code> requer <code>run_js: true</code></td></tr><tr><td><code>json</code></td><td>objeto</td><td>não</td><td>Extração personalizada: <code>{"prompt": string}</code> ou <code>{"schema": object}</code>, nunca ambos. Substitui o parser embutido</td></tr><tr><td><code>location</code></td><td>string</td><td>não</td><td>CEP de entrega, por exemplo, <code>10115</code>. Deve pertencer ao marketplace definido por <code>domain</code></td></tr><tr><td><code>device</code></td><td>string</td><td>não</td><td><code>desktop</code> (padrão) ou <code>mobile</code></td></tr><tr><td><code>run_js</code></td><td>booleano</td><td>não</td><td>Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 150 segundos ou mais</td></tr><tr><td><code>callback_url</code></td><td>string</td><td>não</td><td>URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com <code>400</code></td></tr><tr><td><code>storage</code></td><td>objeto</td><td>não</td><td>Entrega o resultado em um bucket em vez da resposta: <code>{"type": string, "url": string}</code>. <code>tipo</code> é <code>s3</code>, <code>s3_gzip</code>, <code>s3_compatible</code>, <code>gcs</code>, ou <code>tos</code>. Somente assíncrono. <code>url</code> não é validado</td></tr></tbody></table>

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

Retorna o ranking de mais vendidos para uma categoria.

**Modos:** `sync`, `async`, `batch`

<table><thead><tr><th width="156">Nome</th><th width="89">Tipo</th><th width="82">Obrigatório</th><th>Descrição</th></tr></thead><tbody><tr><td><code>query</code></td><td>string</td><td>sim</td><td>Categoria</td></tr><tr><td><code>category_id</code></td><td>string</td><td>não</td><td>Restringe a um nó de navegação da Amazon</td></tr><tr><td><code>check_empty_geo</code></td><td>booleano</td><td>não</td><td>Faz a solicitação falhar em vez de retornar conteúdo ignorado <code>location</code></td></tr><tr><td><code>currency</code></td><td>string</td><td>não</td><td>Moeda para reportar os preços, por exemplo, <code>EUR</code></td></tr><tr><td><code>domain</code></td><td>string</td><td>não</td><td>TLD do marketplace: <code>com</code>, <code>de</code>, <code>co.uk</code>, <code>co.jp</code></td></tr><tr><td><code>locale</code></td><td>string</td><td>não</td><td>Idioma da interface, por exemplo, <code>en_US</code></td></tr><tr><td><code>pages</code></td><td>inteiro</td><td>não</td><td>Páginas consecutivas de onde buscar <code>start_page</code>. Cada página é uma busca e cobrança separadas</td></tr><tr><td><code>safe_search</code></td><td>booleano</td><td>não</td><td>Filtro de conteúdo da Amazon</td></tr><tr><td><code>start_page</code></td><td>inteiro</td><td>não</td><td>Primeira página de resultados. Padrão <code>1</code></td></tr><tr><td><code>output</code></td><td>array de strings</td><td>não</td><td>Formatos a retornar: <code>markdown</code>, <code>html</code>, <code>json</code>, <code>screenshot</code>. Padrão <code>["html"]</code>. <code>json</code> retorna campos analisados. <code>screenshot</code> requer <code>run_js: true</code></td></tr><tr><td><code>json</code></td><td>objeto</td><td>não</td><td>Extração personalizada: <code>{"prompt": string}</code> ou <code>{"schema": object}</code>, nunca ambos. Substitui o parser embutido</td></tr><tr><td><code>location</code></td><td>string</td><td>não</td><td>CEP de entrega, por exemplo, <code>10115</code>. Deve pertencer ao marketplace definido por <code>domain</code></td></tr><tr><td><code>device</code></td><td>string</td><td>não</td><td><code>desktop</code> (padrão) ou <code>mobile</code></td></tr><tr><td><code>run_js</code></td><td>booleano</td><td>não</td><td>Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 150 segundos ou mais</td></tr><tr><td><code>callback_url</code></td><td>string</td><td>não</td><td>URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com <code>400</code></td></tr><tr><td><code>storage</code></td><td>objeto</td><td>não</td><td>Entrega o resultado em um bucket em vez da resposta: <code>{"type": string, "url": string}</code>. <code>tipo</code> é <code>s3</code>, <code>s3_gzip</code>, <code>s3_compatible</code>, <code>gcs</code>, ou <code>tos</code>. Somente assíncrono. <code>url</code> não é validado</td></tr></tbody></table>

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

Retorna todas as ofertas de um anúncio: todos os vendedores e condições.

**Modos:** `sync`, `async`, `batch`

<table><thead><tr><th width="155">Nome</th><th width="94">Tipo</th><th width="83">Obrigatório</th><th>Descrição</th></tr></thead><tbody><tr><td><code>query</code></td><td>string</td><td>sim</td><td>ASIN cujas ofertas devem ser retornadas</td></tr><tr><td><code>check_empty_geo</code></td><td>booleano</td><td>não</td><td>Faz a solicitação falhar em vez de retornar conteúdo ignorado <code>location</code></td></tr><tr><td><code>condition</code></td><td>string</td><td>não</td><td>Condição da oferta a retornar, por exemplo, <code>usado</code></td></tr><tr><td><code>currency</code></td><td>string</td><td>não</td><td>Moeda para reportar os preços, por exemplo, <code>EUR</code></td></tr><tr><td><code>domain</code></td><td>string</td><td>não</td><td>TLD do marketplace: <code>com</code>, <code>de</code>, <code>co.uk</code>, <code>co.jp</code></td></tr><tr><td><code>locale</code></td><td>string</td><td>não</td><td>Idioma da interface, por exemplo, <code>en_US</code></td></tr><tr><td><code>pages</code></td><td>inteiro</td><td>não</td><td>Páginas consecutivas de onde buscar <code>start_page</code>. Cada página é uma busca e cobrança separadas</td></tr><tr><td><code>safe_search</code></td><td>booleano</td><td>não</td><td>Filtro de conteúdo da Amazon</td></tr><tr><td><code>start_page</code></td><td>inteiro</td><td>não</td><td>Primeira página de resultados. Padrão <code>1</code></td></tr><tr><td><code>output</code></td><td>array de strings</td><td>não</td><td>Formatos a retornar: <code>markdown</code>, <code>html</code>, <code>json</code>, <code>screenshot</code>. Padrão <code>["html"]</code>. <code>json</code> retorna campos analisados. <code>screenshot</code> requer <code>run_js: true</code></td></tr><tr><td><code>json</code></td><td>objeto</td><td>não</td><td>Extração personalizada: <code>{"prompt": string}</code> ou <code>{"schema": object}</code>, nunca ambos. Substitui o parser embutido</td></tr><tr><td><code>location</code></td><td>string</td><td>não</td><td>CEP de entrega, por exemplo, <code>10115</code>. Deve pertencer ao marketplace definido por <code>domain</code></td></tr><tr><td><code>device</code></td><td>string</td><td>não</td><td><code>desktop</code> (padrão) ou <code>mobile</code></td></tr><tr><td><code>run_js</code></td><td>booleano</td><td>não</td><td>Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 150 segundos ou mais</td></tr><tr><td><code>callback_url</code></td><td>string</td><td>não</td><td>URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com <code>400</code></td></tr><tr><td><code>storage</code></td><td>objeto</td><td>não</td><td>Entrega o resultado em um bucket em vez da resposta: <code>{"type": string, "url": string}</code>. <code>tipo</code> é <code>s3</code>, <code>s3_gzip</code>, <code>s3_compatible</code>, <code>gcs</code>, ou <code>tos</code>. Somente assíncrono. <code>url</code> não é validado</td></tr></tbody></table>

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

Retorna o título, preço, disponibilidade, avaliação, imagens e variantes de um produto da Amazon.

**Modos:** `sync`, `async`, `batch`

<table><thead><tr><th width="183">Nome</th><th width="92">Tipo</th><th width="84">Obrigatório</th><th>Descrição</th></tr></thead><tbody><tr><td><code>query</code></td><td>string</td><td>sim</td><td>ASIN, por exemplo, <code>B0935DN1BN</code>. Não é uma URL nem um título</td></tr><tr><td><code>autoselect_variant</code></td><td>booleano</td><td>não</td><td>Segue a variante padrão do anúncio em vez de retornar apenas o anúncio pai. Defina quando um ASIN pai não retornar preço</td></tr><tr><td><code>check_empty_geo</code></td><td>booleano</td><td>não</td><td>Faz a solicitação falhar em vez de retornar conteúdo ignorado <code>location</code></td></tr><tr><td><code>currency</code></td><td>string</td><td>não</td><td>Moeda para reportar os preços, por exemplo, <code>EUR</code></td></tr><tr><td><code>domain</code></td><td>string</td><td>não</td><td>TLD do marketplace: <code>com</code>, <code>de</code>, <code>co.uk</code>, <code>co.jp</code></td></tr><tr><td><code>locale</code></td><td>string</td><td>não</td><td>Idioma da interface, por exemplo, <code>en_US</code></td></tr><tr><td><code>safe_search</code></td><td>booleano</td><td>não</td><td>Filtro de conteúdo da Amazon</td></tr><tr><td><code>output</code></td><td>array de strings</td><td>não</td><td>Formatos a retornar: <code>markdown</code>, <code>html</code>, <code>json</code>, <code>screenshot</code>. Padrão <code>["html"]</code>. <code>json</code> retorna campos analisados. <code>screenshot</code> requer <code>run_js: true</code></td></tr><tr><td><code>json</code></td><td>objeto</td><td>não</td><td>Extração personalizada: <code>{"prompt": string}</code> ou <code>{"schema": object}</code>, nunca ambos. Substitui o parser embutido</td></tr><tr><td><code>location</code></td><td>string</td><td>não</td><td>CEP de entrega, por exemplo, <code>10115</code>. Deve pertencer ao marketplace definido por <code>domain</code></td></tr><tr><td><code>device</code></td><td>string</td><td>não</td><td><code>desktop</code> (padrão) ou <code>mobile</code></td></tr><tr><td><code>run_js</code></td><td>booleano</td><td>não</td><td>Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 150 segundos ou mais</td></tr><tr><td><code>callback_url</code></td><td>string</td><td>não</td><td>URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com <code>400</code></td></tr><tr><td><code>storage</code></td><td>objeto</td><td>não</td><td>Entrega o resultado em um bucket em vez da resposta: <code>{"type": string, "url": string}</code>. <code>tipo</code> é <code>s3</code>, <code>s3_gzip</code>, <code>s3_compatible</code>, <code>gcs</code>, ou <code>tos</code>. Somente assíncrono. <code>url</code> não é validado</td></tr></tbody></table>

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

Retorna resultados de busca da Amazon, com posicionamentos pagos marcados.

**Modos:** `sync`, `async`, `batch`

<table><thead><tr><th width="156">Nome</th><th width="91">Tipo</th><th width="90">Obrigatório</th><th>Descrição</th></tr></thead><tbody><tr><td><code>query</code></td><td>string</td><td>sim</td><td>Palavra-chave de busca</td></tr><tr><td><code>category_id</code></td><td>string</td><td>não</td><td>Restringe a um nó de navegação da Amazon</td></tr><tr><td><code>check_empty_geo</code></td><td>booleano</td><td>não</td><td>Faz a solicitação falhar em vez de retornar conteúdo ignorado <code>location</code></td></tr><tr><td><code>currency</code></td><td>string</td><td>não</td><td>Moeda para reportar os preços, por exemplo, <code>EUR</code></td></tr><tr><td><code>domain</code></td><td>string</td><td>não</td><td>TLD do marketplace: <code>com</code>, <code>de</code>, <code>co.uk</code>, <code>co.jp</code></td></tr><tr><td><code>locale</code></td><td>string</td><td>não</td><td>Idioma da interface, por exemplo, <code>en_US</code></td></tr><tr><td><code>max_price</code></td><td>inteiro</td><td>não</td><td>Preço máximo a incluir, na moeda do marketplace</td></tr><tr><td><code>merchant_id</code></td><td>string</td><td>não</td><td>Restringe aos itens de um vendedor</td></tr><tr><td><code>min_price</code></td><td>inteiro</td><td>não</td><td>Preço mínimo a incluir, na moeda do marketplace</td></tr><tr><td><code>pages</code></td><td>inteiro</td><td>não</td><td>Páginas consecutivas de onde buscar <code>start_page</code>. Cada página é uma busca e cobrança separadas</td></tr><tr><td><code>refinements</code></td><td>array de strings</td><td>não</td><td>Facetas de filtro da Amazon: marca, avaliação, elegibilidade ao Prime. Encaminhadas literalmente; os valores diferem por marketplace</td></tr><tr><td><code>safe_search</code></td><td>booleano</td><td>não</td><td>Filtro de conteúdo da Amazon</td></tr><tr><td><code>sort_by</code></td><td>string</td><td>não</td><td>Chave de ordenação própria da Amazon, por exemplo, <code>price-asc-rank</code>, <code>review-rank</code>. Encaminhado literalmente; os valores diferem por marketplace</td></tr><tr><td><code>start_page</code></td><td>inteiro</td><td>não</td><td>Primeira página de resultados. Padrão <code>1</code></td></tr><tr><td><code>output</code></td><td>array de strings</td><td>não</td><td>Formatos a retornar: <code>markdown</code>, <code>html</code>, <code>json</code>, <code>screenshot</code>. Padrão <code>["html"]</code>. <code>json</code> retorna campos analisados. <code>screenshot</code> requer <code>run_js: true</code></td></tr><tr><td><code>json</code></td><td>objeto</td><td>não</td><td>Extração personalizada: <code>{"prompt": string}</code> ou <code>{"schema": object}</code>, nunca ambos. Substitui o parser embutido</td></tr><tr><td><code>location</code></td><td>string</td><td>não</td><td>CEP de entrega, por exemplo, <code>10115</code>. Deve pertencer ao marketplace definido por <code>domain</code></td></tr><tr><td><code>device</code></td><td>string</td><td>não</td><td><code>desktop</code> (padrão) ou <code>mobile</code></td></tr><tr><td><code>run_js</code></td><td>booleano</td><td>não</td><td>Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 150 segundos ou mais</td></tr><tr><td><code>callback_url</code></td><td>string</td><td>não</td><td>URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com <code>400</code></td></tr><tr><td><code>storage</code></td><td>objeto</td><td>não</td><td>Entrega o resultado em um bucket em vez da resposta: <code>{"type": string, "url": string}</code>. <code>tipo</code> é <code>s3</code>, <code>s3_gzip</code>, <code>s3_compatible</code>, <code>gcs</code>, ou <code>tos</code>. Somente assíncrono. <code>url</code> não é validado</td></tr></tbody></table>

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

Retorna a vitrine de um vendedor.

**Modos:** `sync`, `async`, `batch`

<table><thead><tr><th width="158">Nome</th><th width="92">Tipo</th><th width="83">Obrigatório</th><th>Descrição</th></tr></thead><tbody><tr><td><code>query</code></td><td>string</td><td>sim</td><td>ID do vendedor</td></tr><tr><td><code>check_empty_geo</code></td><td>booleano</td><td>não</td><td>Faz a solicitação falhar em vez de retornar conteúdo ignorado <code>location</code></td></tr><tr><td><code>currency</code></td><td>string</td><td>não</td><td>Moeda para reportar os preços, por exemplo, <code>EUR</code></td></tr><tr><td><code>domain</code></td><td>string</td><td>não</td><td>TLD do marketplace: <code>com</code>, <code>de</code>, <code>co.uk</code>, <code>co.jp</code></td></tr><tr><td><code>locale</code></td><td>string</td><td>não</td><td>Idioma da interface, por exemplo, <code>en_US</code></td></tr><tr><td><code>safe_search</code></td><td>booleano</td><td>não</td><td>Filtro de conteúdo da Amazon</td></tr><tr><td><code>output</code></td><td>array de strings</td><td>não</td><td>Formatos a retornar: <code>markdown</code>, <code>html</code>, <code>json</code>, <code>screenshot</code>. Padrão <code>["html"]</code>. <code>json</code> retorna campos analisados. <code>screenshot</code> requer <code>run_js: true</code></td></tr><tr><td><code>json</code></td><td>objeto</td><td>não</td><td>Extração personalizada: <code>{"prompt": string}</code> ou <code>{"schema": object}</code>, nunca ambos. Substitui o parser embutido</td></tr><tr><td><code>location</code></td><td>string</td><td>não</td><td>CEP de entrega, por exemplo, <code>10115</code>. Deve pertencer ao marketplace definido por <code>domain</code></td></tr><tr><td><code>device</code></td><td>string</td><td>não</td><td><code>desktop</code> (padrão) ou <code>mobile</code></td></tr><tr><td><code>run_js</code></td><td>booleano</td><td>não</td><td>Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 150 segundos ou mais</td></tr><tr><td><code>callback_url</code></td><td>string</td><td>não</td><td>URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com <code>400</code></td></tr><tr><td><code>storage</code></td><td>objeto</td><td>não</td><td>Entrega o resultado em um bucket em vez da resposta: <code>{"type": string, "url": string}</code>. <code>tipo</code> é <code>s3</code>, <code>s3_gzip</code>, <code>s3_compatible</code>, <code>gcs</code>, ou <code>tos</code>. Somente assíncrono. <code>url</code> não é validado</td></tr></tbody></table>

### Baker's Plus

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

Retorna campos analisados de uma página do Baker's Plus a partir de uma URL que você fornecer.

**Modos:** `sync`, `async`

<table><thead><tr><th width="167">Nome</th><th width="87">Tipo</th><th width="84">Obrigatório</th><th>Descrição</th></tr></thead><tbody><tr><td><code>url</code></td><td>string</td><td>sim</td><td>Uma URL de produto ou de busca do Baker's Plus</td></tr><tr><td><code>delivery_zip</code></td><td>string</td><td>não</td><td>A entrega por CEP é cotada para</td></tr><tr><td><code>fulfillment_type</code></td><td>string</td><td>não</td><td>Filtro de entrega, retirada ou envio para casa</td></tr><tr><td><code>store_id</code></td><td>string</td><td>não</td><td>A loja cujo catálogo e preços são retornados</td></tr><tr><td><code>output</code></td><td>array de strings</td><td>não</td><td>Formatos a retornar: <code>markdown</code>, <code>html</code>, <code>json</code>, <code>screenshot</code>. Padrão <code>["html"]</code>. <code>json</code> retorna campos analisados. <code>screenshot</code> requer <code>run_js: true</code></td></tr><tr><td><code>json</code></td><td>objeto</td><td>não</td><td>Extração personalizada: <code>{"prompt": string}</code> ou <code>{"schema": object}</code>, nunca ambos. Substitui o parser embutido</td></tr><tr><td><code>location</code></td><td>string</td><td>não</td><td>Código de país de duas letras para buscar, por exemplo <code>DE</code></td></tr><tr><td><code>device</code></td><td>string</td><td>não</td><td><code>desktop</code> (padrão) ou <code>mobile</code></td></tr><tr><td><code>run_js</code></td><td>booleano</td><td>não</td><td>Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 150 segundos ou mais</td></tr><tr><td><code>callback_url</code></td><td>string</td><td>não</td><td>URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com <code>400</code></td></tr><tr><td><code>storage</code></td><td>objeto</td><td>não</td><td>Entrega o resultado em um bucket em vez da resposta: <code>{"type": string, "url": string}</code>. <code>tipo</code> é <code>s3</code>, <code>s3_gzip</code>, <code>s3_compatible</code>, <code>gcs</code>, ou <code>tos</code>. Somente assíncrono. <code>url</code> não é validado</td></tr></tbody></table>

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

Retorna o preço, o estoque e os detalhes de um produto do Baker's Plus.

**Modos:** `sync`, `async`

<table><thead><tr><th width="164">Nome</th><th width="87">Tipo</th><th width="83">Obrigatório</th><th>Descrição</th></tr></thead><tbody><tr><td><code>query</code></td><td>string</td><td>sim</td><td>ID do produto</td></tr><tr><td><code>delivery_zip</code></td><td>string</td><td>não</td><td>A entrega por CEP é cotada para</td></tr><tr><td><code>fulfillment_type</code></td><td>string</td><td>não</td><td>Filtro de entrega, retirada ou envio para casa</td></tr><tr><td><code>store_id</code></td><td>string</td><td>não</td><td>A loja cujo catálogo e preços são retornados</td></tr><tr><td><code>output</code></td><td>array de strings</td><td>não</td><td>Formatos a retornar: <code>markdown</code>, <code>html</code>, <code>json</code>, <code>screenshot</code>. Padrão <code>["html"]</code>. <code>json</code> retorna campos analisados. <code>screenshot</code> requer <code>run_js: true</code></td></tr><tr><td><code>json</code></td><td>objeto</td><td>não</td><td>Extração personalizada: <code>{"prompt": string}</code> ou <code>{"schema": object}</code>, nunca ambos. Substitui o parser embutido</td></tr><tr><td><code>location</code></td><td>string</td><td>não</td><td>Código de país de duas letras para buscar, por exemplo <code>DE</code></td></tr><tr><td><code>device</code></td><td>string</td><td>não</td><td><code>desktop</code> (padrão) ou <code>mobile</code></td></tr><tr><td><code>run_js</code></td><td>booleano</td><td>não</td><td>Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 150 segundos ou mais</td></tr><tr><td><code>callback_url</code></td><td>string</td><td>não</td><td>URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com <code>400</code></td></tr><tr><td><code>storage</code></td><td>objeto</td><td>não</td><td>Entrega o resultado em um bucket em vez da resposta: <code>{"type": string, "url": string}</code>. <code>tipo</code> é <code>s3</code>, <code>s3_gzip</code>, <code>s3_compatible</code>, <code>gcs</code>, ou <code>tos</code>. Somente assíncrono. <code>url</code> não é validado</td></tr></tbody></table>

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

Retorna resultados de busca do Baker's Plus para uma palavra-chave.

**Modos:** `sync`, `async`

<table><thead><tr><th width="167">Nome</th><th width="88">Tipo</th><th width="83">Obrigatório</th><th>Descrição</th></tr></thead><tbody><tr><td><code>query</code></td><td>string</td><td>sim</td><td>Palavra-chave de busca</td></tr><tr><td><code>brand</code></td><td>string</td><td>não</td><td>Restringe os resultados a uma marca</td></tr><tr><td><code>delivery_zip</code></td><td>string</td><td>não</td><td>A entrega por CEP é cotada para</td></tr><tr><td><code>fulfillment_type</code></td><td>string</td><td>não</td><td>Filtro de entrega, retirada ou envio para casa</td></tr><tr><td><code>price_range</code></td><td>string</td><td>não</td><td>Filtro de faixa de preço</td></tr><tr><td><code>store_id</code></td><td>string</td><td>não</td><td>A loja cujo catálogo e preços são retornados</td></tr><tr><td><code>output</code></td><td>array de strings</td><td>não</td><td>Formatos a retornar: <code>markdown</code>, <code>html</code>, <code>json</code>, <code>screenshot</code>. Padrão <code>["html"]</code>. <code>json</code> retorna campos analisados. <code>screenshot</code> requer <code>run_js: true</code></td></tr><tr><td><code>json</code></td><td>objeto</td><td>não</td><td>Extração personalizada: <code>{"prompt": string}</code> ou <code>{"schema": object}</code>, nunca ambos. Substitui o parser embutido</td></tr><tr><td><code>location</code></td><td>string</td><td>não</td><td>Código de país de duas letras para buscar, por exemplo <code>DE</code></td></tr><tr><td><code>device</code></td><td>string</td><td>não</td><td><code>desktop</code> (padrão) ou <code>mobile</code></td></tr><tr><td><code>run_js</code></td><td>booleano</td><td>não</td><td>Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 150 segundos ou mais</td></tr><tr><td><code>callback_url</code></td><td>string</td><td>não</td><td>URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com <code>400</code></td></tr><tr><td><code>storage</code></td><td>objeto</td><td>não</td><td>Entrega o resultado em um bucket em vez da resposta: <code>{"type": string, "url": string}</code>. <code>tipo</code> é <code>s3</code>, <code>s3_gzip</code>, <code>s3_compatible</code>, <code>gcs</code>, ou <code>tos</code>. Somente assíncrono. <code>url</code> não é validado</td></tr></tbody></table>

### Bed Bath e Beyond

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

Retorna uma página do Bed Bath & Beyond a partir de uma URL que você fornecer.

**Modos:** `sync`, `async`

<table><thead><tr><th width="133">Nome</th><th width="86">Tipo</th><th width="83">Obrigatório</th><th>Descrição</th></tr></thead><tbody><tr><td><code>url</code></td><td>string</td><td>sim</td><td>Uma URL de produto ou de busca do Bed Bath &#x26; Beyond</td></tr><tr><td><code>output</code></td><td>array de strings</td><td>não</td><td>Formatos a retornar: <code>markdown</code>, <code>html</code>, <code>json</code>, <code>screenshot</code>. Padrão <code>["html"]</code>. <code>json</code> retorna campos analisados. <code>screenshot</code> requer <code>run_js: true</code></td></tr><tr><td><code>json</code></td><td>objeto</td><td>não</td><td>Extração personalizada: <code>{"prompt": string}</code> ou <code>{"schema": object}</code>, nunca ambos.</td></tr><tr><td><code>location</code></td><td>string</td><td>não</td><td>Código de país de duas letras para buscar, por exemplo <code>DE</code></td></tr><tr><td><code>device</code></td><td>string</td><td>não</td><td><code>desktop</code> (padrão) ou <code>mobile</code></td></tr><tr><td><code>run_js</code></td><td>booleano</td><td>não</td><td>Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 150 segundos ou mais</td></tr><tr><td><code>callback_url</code></td><td>string</td><td>não</td><td>URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com <code>400</code></td></tr><tr><td><code>storage</code></td><td>objeto</td><td>não</td><td>Entrega o resultado em um bucket em vez da resposta: <code>{"type": string, "url": string}</code>. <code>tipo</code> é <code>s3</code>, <code>s3_gzip</code>, <code>s3_compatible</code>, <code>gcs</code>, ou <code>tos</code>. Somente assíncrono. <code>url</code> não é validado</td></tr></tbody></table>

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

Retorna o preço, o estoque e os detalhes de um produto do Bed Bath & Beyond.

{% hint style="success" %}
**Para obter dados estruturados em JSON do produto com o parser dedicado**, envie a URL da página do produto (terminando em `/<product_id>/product.html`) para [`POST /v1/scrape`](/api-reference/pt-br/endpoints-principais.md#post-v1-scrape) com `output: ["json"]`. Nenhum `json` prompt ou schema é necessário.
{% endhint %}

**Modos:** `sync`, `async`

<table><thead><tr><th width="133">Nome</th><th width="92">Tipo</th><th width="82">Obrigatório</th><th>Descrição</th></tr></thead><tbody><tr><td><code>query</code></td><td>string</td><td>sim</td><td>ID do produto</td></tr><tr><td><code>domain</code></td><td>string</td><td>não</td><td>TLD da loja</td></tr><tr><td><code>output</code></td><td>array de strings</td><td>não</td><td>Formatos a retornar: <code>markdown</code>, <code>html</code>, <code>json</code>, <code>screenshot</code>. Padrão <code>["html"]</code>. <code>json</code> retorna campos analisados. <code>screenshot</code> requer <code>run_js: true</code></td></tr><tr><td><code>json</code></td><td>objeto</td><td>não</td><td>Extração personalizada: <code>{"prompt": string}</code> ou <code>{"schema": object}</code>, nunca ambos.</td></tr><tr><td><code>location</code></td><td>string</td><td>não</td><td>Código de país de duas letras para buscar, por exemplo <code>DE</code></td></tr><tr><td><code>device</code></td><td>string</td><td>não</td><td><code>desktop</code> (padrão) ou <code>mobile</code></td></tr><tr><td><code>run_js</code></td><td>booleano</td><td>não</td><td>Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 150 segundos ou mais</td></tr><tr><td><code>callback_url</code></td><td>string</td><td>não</td><td>URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com <code>400</code></td></tr><tr><td><code>storage</code></td><td>objeto</td><td>não</td><td>Entrega o resultado em um bucket em vez da resposta: <code>{"type": string, "url": string}</code>. <code>tipo</code> é <code>s3</code>, <code>s3_gzip</code>, <code>s3_compatible</code>, <code>gcs</code>, ou <code>tos</code>. Somente assíncrono. <code>url</code> não é validado</td></tr></tbody></table>

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

Retorna resultados de busca do Bed Bath & Beyond para uma palavra-chave.

**Modos:** `sync`, `async`

<table><thead><tr><th width="135">Nome</th><th width="88">Tipo</th><th width="84">Obrigatório</th><th>Descrição</th></tr></thead><tbody><tr><td><code>query</code></td><td>string</td><td>sim</td><td>Palavra-chave de busca</td></tr><tr><td><code>domain</code></td><td>string</td><td>não</td><td>TLD da loja</td></tr><tr><td><code>start_page</code></td><td>inteiro</td><td>não</td><td>Primeira página de resultados</td></tr><tr><td><code>output</code></td><td>array de strings</td><td>não</td><td>Formatos a retornar: <code>markdown</code>, <code>html</code>, <code>json</code>, <code>screenshot</code>. Padrão <code>["html"]</code>. <code>json</code> retorna campos analisados. <code>screenshot</code> requer <code>run_js: true</code></td></tr><tr><td><code>json</code></td><td>objeto</td><td>não</td><td>Extração personalizada: <code>{"prompt": string}</code> ou <code>{"schema": object}</code>, nunca ambos.</td></tr><tr><td><code>location</code></td><td>string</td><td>não</td><td>Código de país de duas letras para buscar, por exemplo <code>DE</code></td></tr><tr><td><code>device</code></td><td>string</td><td>não</td><td><code>desktop</code> (padrão) ou <code>mobile</code></td></tr><tr><td><code>run_js</code></td><td>booleano</td><td>não</td><td>Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 150 segundos ou mais</td></tr><tr><td><code>callback_url</code></td><td>string</td><td>não</td><td>URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com <code>400</code></td></tr><tr><td><code>storage</code></td><td>objeto</td><td>não</td><td>Entrega o resultado em um bucket em vez da resposta: <code>{"type": string, "url": string}</code>. <code>tipo</code> é <code>s3</code>, <code>s3_gzip</code>, <code>s3_compatible</code>, <code>gcs</code>, ou <code>tos</code>. Somente assíncrono. <code>url</code> não é validado</td></tr></tbody></table>

### Best Buy

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

Retorna campos analisados de uma página do Best Buy a partir de uma URL que você fornecer.

**Modos:** `sync`, `async`

<table><thead><tr><th width="131">Nome</th><th width="91">Tipo</th><th width="85">Obrigatório</th><th>Descrição</th></tr></thead><tbody><tr><td><code>url</code></td><td>string</td><td>sim</td><td>Uma URL de produto ou de busca do Best Buy</td></tr><tr><td><code>delivery_zip</code></td><td>string</td><td>não</td><td>A entrega por CEP é cotada para</td></tr><tr><td><code>store_id</code></td><td>string</td><td>não</td><td>A loja cujo catálogo e preços são retornados</td></tr><tr><td><code>output</code></td><td>array de strings</td><td>não</td><td>Formatos a retornar: <code>markdown</code>, <code>html</code>, <code>json</code>, <code>screenshot</code>. Padrão <code>["html"]</code>. <code>json</code> retorna campos analisados. <code>screenshot</code> requer <code>run_js: true</code></td></tr><tr><td><code>json</code></td><td>objeto</td><td>não</td><td>Extração personalizada: <code>{"prompt": string}</code> ou <code>{"schema": object}</code>, nunca ambos. Substitui o parser embutido</td></tr><tr><td><code>location</code></td><td>string</td><td>não</td><td>Código de país de duas letras para buscar, por exemplo <code>DE</code></td></tr><tr><td><code>device</code></td><td>string</td><td>não</td><td><code>desktop</code> (padrão) ou <code>mobile</code></td></tr><tr><td><code>run_js</code></td><td>booleano</td><td>não</td><td>Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 150 segundos ou mais</td></tr><tr><td><code>callback_url</code></td><td>string</td><td>não</td><td>URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com <code>400</code></td></tr><tr><td><code>storage</code></td><td>objeto</td><td>não</td><td>Entrega o resultado em um bucket em vez da resposta: <code>{"type": string, "url": string}</code>. <code>tipo</code> é <code>s3</code>, <code>s3_gzip</code>, <code>s3_compatible</code>, <code>gcs</code>, ou <code>tos</code>. Somente assíncrono. <code>url</code> não é validado</td></tr></tbody></table>

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

Retorna o preço, o estoque e os detalhes de um produto do Best Buy.

**Modos:** `sync`, `async`

<table><thead><tr><th width="132">Nome</th><th width="90">Tipo</th><th width="85">Obrigatório</th><th>Descrição</th></tr></thead><tbody><tr><td><code>query</code></td><td>string</td><td>sim</td><td>ID do produto</td></tr><tr><td><code>delivery_zip</code></td><td>string</td><td>não</td><td>A entrega por CEP é cotada para</td></tr><tr><td><code>domain</code></td><td>string</td><td>não</td><td>TLD da loja</td></tr><tr><td><code>store_id</code></td><td>string</td><td>não</td><td>A loja cujo catálogo e preços são retornados</td></tr><tr><td><code>output</code></td><td>array de strings</td><td>não</td><td>Formatos a retornar: <code>markdown</code>, <code>html</code>, <code>json</code>, <code>screenshot</code>. Padrão <code>["html"]</code>. <code>json</code> retorna campos analisados. <code>screenshot</code> requer <code>run_js: true</code></td></tr><tr><td><code>json</code></td><td>objeto</td><td>não</td><td>Extração personalizada: <code>{"prompt": string}</code> ou <code>{"schema": object}</code>, nunca ambos. Substitui o parser embutido</td></tr><tr><td><code>location</code></td><td>string</td><td>não</td><td>Código de país de duas letras para buscar, por exemplo <code>DE</code></td></tr><tr><td><code>device</code></td><td>string</td><td>não</td><td><code>desktop</code> (padrão) ou <code>mobile</code></td></tr><tr><td><code>run_js</code></td><td>booleano</td><td>não</td><td>Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 150 segundos ou mais</td></tr><tr><td><code>callback_url</code></td><td>string</td><td>não</td><td>URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com <code>400</code></td></tr><tr><td><code>storage</code></td><td>objeto</td><td>não</td><td>Entrega o resultado em um bucket em vez da resposta: <code>{"type": string, "url": string}</code>. <code>tipo</code> é <code>s3</code>, <code>s3_gzip</code>, <code>s3_compatible</code>, <code>gcs</code>, ou <code>tos</code>. Somente assíncrono. <code>url</code> não é validado</td></tr></tbody></table>

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

Retorna resultados de busca do Best Buy para uma palavra-chave.

**Modos:** `sync`, `async`

<table><thead><tr><th width="165">Nome</th><th width="89">Tipo</th><th width="88">Obrigatório</th><th>Descrição</th></tr></thead><tbody><tr><td><code>query</code></td><td>string</td><td>sim</td><td>Palavra-chave de busca</td></tr><tr><td><code>delivery_zip</code></td><td>string</td><td>não</td><td>A entrega por CEP é cotada para</td></tr><tr><td><code>domain</code></td><td>string</td><td>não</td><td>TLD da loja</td></tr><tr><td><code>fulfillment_type</code></td><td>string</td><td>não</td><td>Filtro de entrega, retirada ou envio para casa</td></tr><tr><td><code>start_page</code></td><td>inteiro</td><td>não</td><td>Primeira página de resultados</td></tr><tr><td><code>store_id</code></td><td>string</td><td>não</td><td>A loja cujo catálogo e preços são retornados</td></tr><tr><td><code>output</code></td><td>array de strings</td><td>não</td><td>Formatos a retornar: <code>markdown</code>, <code>html</code>, <code>json</code>, <code>screenshot</code>. Padrão <code>["html"]</code>. <code>json</code> retorna campos analisados. <code>screenshot</code> requer <code>run_js: true</code></td></tr><tr><td><code>json</code></td><td>objeto</td><td>não</td><td>Extração personalizada: <code>{"prompt": string}</code> ou <code>{"schema": object}</code>, nunca ambos. Substitui o parser embutido</td></tr><tr><td><code>location</code></td><td>string</td><td>não</td><td>Código de país de duas letras para buscar, por exemplo <code>DE</code></td></tr><tr><td><code>device</code></td><td>string</td><td>não</td><td><code>desktop</code> (padrão) ou <code>mobile</code></td></tr><tr><td><code>run_js</code></td><td>booleano</td><td>não</td><td>Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 150 segundos ou mais</td></tr><tr><td><code>callback_url</code></td><td>string</td><td>não</td><td>URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com <code>400</code></td></tr><tr><td><code>storage</code></td><td>objeto</td><td>não</td><td>Entrega o resultado em um bucket em vez da resposta: <code>{"type": string, "url": string}</code>. <code>tipo</code> é <code>s3</code>, <code>s3_gzip</code>, <code>s3_compatible</code>, <code>gcs</code>, ou <code>tos</code>. Somente assíncrono. <code>url</code> não é validado</td></tr></tbody></table>

### Bodega Aurrera

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

Retorna campos analisados de uma página do Bodega Aurrera a partir de uma URL que você fornecer.

**Modos:** `sync`, `async`

<table><thead><tr><th width="137">Nome</th><th width="86">Tipo</th><th width="82">Obrigatório</th><th>Descrição</th></tr></thead><tbody><tr><td><code>url</code></td><td>string</td><td>sim</td><td>Uma URL de produto ou de busca do Bodega Aurrera</td></tr><tr><td><code>delivery_zip</code></td><td>string</td><td>não</td><td>A entrega por CEP é cotada para</td></tr><tr><td><code>store_id</code></td><td>string</td><td>não</td><td>A loja cujo catálogo e preços são retornados</td></tr><tr><td><code>output</code></td><td>array de strings</td><td>não</td><td>Formatos a retornar: <code>markdown</code>, <code>html</code>, <code>json</code>, <code>screenshot</code>. Padrão <code>["html"]</code>. <code>json</code> retorna campos analisados. <code>screenshot</code> requer <code>run_js: true</code></td></tr><tr><td><code>json</code></td><td>objeto</td><td>não</td><td>Extração personalizada: <code>{"prompt": string}</code> ou <code>{"schema": object}</code>, nunca ambos. Substitui o parser embutido</td></tr><tr><td><code>location</code></td><td>string</td><td>não</td><td>Código de país de duas letras para buscar, por exemplo <code>DE</code></td></tr><tr><td><code>device</code></td><td>string</td><td>não</td><td><code>desktop</code> (padrão) ou <code>mobile</code></td></tr><tr><td><code>run_js</code></td><td>booleano</td><td>não</td><td>Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 150 segundos ou mais</td></tr><tr><td><code>callback_url</code></td><td>string</td><td>não</td><td>URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com <code>400</code></td></tr><tr><td><code>storage</code></td><td>objeto</td><td>não</td><td>Entrega o resultado em um bucket em vez da resposta: <code>{"type": string, "url": string}</code>. <code>tipo</code> é <code>s3</code>, <code>s3_gzip</code>, <code>s3_compatible</code>, <code>gcs</code>, ou <code>tos</code>. Somente assíncrono. <code>url</code> não é validado</td></tr></tbody></table>

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

Retorna o preço, o estoque e os detalhes de um produto do Bodega Aurrera.

**Modos:** `sync`, `async`

<table><thead><tr><th width="167">Nome</th><th width="92">Tipo</th><th width="86">Obrigatório</th><th>Descrição</th></tr></thead><tbody><tr><td><code>query</code></td><td>string</td><td>sim</td><td>ID do produto</td></tr><tr><td><code>delivery_zip</code></td><td>string</td><td>não</td><td>A entrega por CEP é cotada para</td></tr><tr><td><code>domain</code></td><td>string</td><td>não</td><td>TLD da loja</td></tr><tr><td><code>fulfillment_type</code></td><td>string</td><td>não</td><td>Filtro de entrega, retirada ou envio para casa</td></tr><tr><td><code>store_id</code></td><td>string</td><td>não</td><td>A loja cujo catálogo e preços são retornados</td></tr><tr><td><code>subdomain</code></td><td>string</td><td>não</td><td>Subdomínio regional da loja</td></tr><tr><td><code>output</code></td><td>array de strings</td><td>não</td><td>Formatos a retornar: <code>markdown</code>, <code>html</code>, <code>json</code>, <code>screenshot</code>. Padrão <code>["html"]</code>. <code>json</code> retorna campos analisados. <code>screenshot</code> requer <code>run_js: true</code></td></tr><tr><td><code>json</code></td><td>objeto</td><td>não</td><td>Extração personalizada: <code>{"prompt": string}</code> ou <code>{"schema": object}</code>, nunca ambos. Substitui o parser embutido</td></tr><tr><td><code>location</code></td><td>string</td><td>não</td><td>Código de país de duas letras para buscar, por exemplo <code>DE</code></td></tr><tr><td><code>device</code></td><td>string</td><td>não</td><td><code>desktop</code> (padrão) ou <code>mobile</code></td></tr><tr><td><code>run_js</code></td><td>booleano</td><td>não</td><td>Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 150 segundos ou mais</td></tr><tr><td><code>callback_url</code></td><td>string</td><td>não</td><td>URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com <code>400</code></td></tr><tr><td><code>storage</code></td><td>objeto</td><td>não</td><td>Entrega o resultado em um bucket em vez da resposta: <code>{"type": string, "url": string}</code>. <code>tipo</code> é <code>s3</code>, <code>s3_gzip</code>, <code>s3_compatible</code>, <code>gcs</code>, ou <code>tos</code>. Somente assíncrono. <code>url</code> não é validado</td></tr></tbody></table>

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

Retorna resultados de busca do Bodega Aurrera para uma palavra-chave.

**Modos:** `sync`, `async`

<table><thead><tr><th width="170">Nome</th><th width="97">Tipo</th><th width="82">Obrigatório</th><th>Descrição</th></tr></thead><tbody><tr><td><code>query</code></td><td>string</td><td>sim</td><td>Palavra-chave de busca</td></tr><tr><td><code>delivery_zip</code></td><td>string</td><td>não</td><td>A entrega por CEP é cotada para</td></tr><tr><td><code>domain</code></td><td>string</td><td>não</td><td>TLD da loja</td></tr><tr><td><code>fulfillment_type</code></td><td>string</td><td>não</td><td>Filtro de entrega, retirada ou envio para casa</td></tr><tr><td><code>store_id</code></td><td>string</td><td>não</td><td>A loja cujo catálogo e preços são retornados</td></tr><tr><td><code>subdomain</code></td><td>string</td><td>não</td><td>Subdomínio regional da loja</td></tr><tr><td><code>output</code></td><td>array de strings</td><td>não</td><td>Formatos a retornar: <code>markdown</code>, <code>html</code>, <code>json</code>, <code>screenshot</code>. Padrão <code>["html"]</code>. <code>json</code> retorna campos analisados. <code>screenshot</code> requer <code>run_js: true</code></td></tr><tr><td><code>json</code></td><td>objeto</td><td>não</td><td>Extração personalizada: <code>{"prompt": string}</code> ou <code>{"schema": object}</code>, nunca ambos. Substitui o parser embutido</td></tr><tr><td><code>location</code></td><td>string</td><td>não</td><td>Código de país de duas letras para buscar, por exemplo <code>DE</code></td></tr><tr><td><code>device</code></td><td>string</td><td>não</td><td><code>desktop</code> (padrão) ou <code>mobile</code></td></tr><tr><td><code>run_js</code></td><td>booleano</td><td>não</td><td>Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 150 segundos ou mais</td></tr><tr><td><code>callback_url</code></td><td>string</td><td>não</td><td>URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com <code>400</code></td></tr><tr><td><code>storage</code></td><td>objeto</td><td>não</td><td>Entrega o resultado em um bucket em vez da resposta: <code>{"type": string, "url": string}</code>. <code>tipo</code> é <code>s3</code>, <code>s3_gzip</code>, <code>s3_compatible</code>, <code>gcs</code>, ou <code>tos</code>. Somente assíncrono. <code>url</code> não é validado</td></tr></tbody></table>

***

### Cdiscount

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

Retorna campos analisados de uma página do Cdiscount a partir de uma URL que você fornecer.

**Modos:** síncrono · assíncrono

<table><thead><tr><th width="134">Nome</th><th width="93">Tipo</th><th width="83">Obrigatório</th><th>Descrição</th></tr></thead><tbody><tr><td><code>url</code></td><td>string</td><td>sim</td><td>Uma URL de produto ou de busca do Cdiscount</td></tr><tr><td><code>output</code></td><td>array de strings</td><td>não</td><td>Formatos a retornar: <code>markdown</code>, <code>html</code>, <code>json</code>, <code>screenshot</code>. Padrão <code>["html"]</code>. <code>json</code> retorna campos analisados. <code>screenshot</code> requer <code>run_js: true</code></td></tr><tr><td><code>json</code></td><td>objeto</td><td>não</td><td>Extração personalizada: <code>{"prompt": string}</code> ou <code>{"schema": object}</code>, nunca ambos. Substitui o parser embutido</td></tr><tr><td><code>location</code></td><td>string</td><td>não</td><td>Código de país de duas letras para buscar, por exemplo <code>DE</code></td></tr><tr><td><code>device</code></td><td>string</td><td>não</td><td><code>desktop</code> (padrão) ou <code>mobile</code></td></tr><tr><td><code>run_js</code></td><td>booleano</td><td>não</td><td>Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 150 segundos ou mais</td></tr><tr><td><code>callback_url</code></td><td>string</td><td>não</td><td>URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com <code>400</code></td></tr><tr><td><code>storage</code></td><td>objeto</td><td>não</td><td>Entrega o resultado em um bucket em vez da resposta: <code>{"type": string, "url": string}</code>. <code>tipo</code> é <code>s3</code>, <code>s3_gzip</code>, <code>s3_compatible</code>, <code>gcs</code>, ou <code>tos</code>. Somente assíncrono. <code>url</code> não é validado</td></tr></tbody></table>

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

Retorna o preço, o estoque e os detalhes de um produto do Cdiscount.

**Modos:** síncrono · assíncrono

<table><thead><tr><th width="133">Nome</th><th width="95">Tipo</th><th width="85">Obrigatório</th><th>Descrição</th></tr></thead><tbody><tr><td><code>query</code></td><td>string</td><td>sim</td><td>ID do produto</td></tr><tr><td><code>domain</code></td><td>string</td><td>não</td><td>TLD da loja</td></tr><tr><td><code>output</code></td><td>array de strings</td><td>não</td><td>Formatos a retornar: <code>markdown</code>, <code>html</code>, <code>json</code>, <code>screenshot</code>. Padrão <code>["html"]</code>. <code>json</code> retorna campos analisados. <code>screenshot</code> requer <code>run_js: true</code></td></tr><tr><td><code>json</code></td><td>objeto</td><td>não</td><td>Extração personalizada: <code>{"prompt": string}</code> ou <code>{"schema": object}</code>, nunca ambos. Substitui o parser embutido</td></tr><tr><td><code>location</code></td><td>string</td><td>não</td><td>Código de país de duas letras para buscar, por exemplo <code>DE</code></td></tr><tr><td><code>device</code></td><td>string</td><td>não</td><td><code>desktop</code> (padrão) ou <code>mobile</code></td></tr><tr><td><code>run_js</code></td><td>booleano</td><td>não</td><td>Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 150 segundos ou mais</td></tr><tr><td><code>callback_url</code></td><td>string</td><td>não</td><td>URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com <code>400</code></td></tr><tr><td><code>storage</code></td><td>objeto</td><td>não</td><td>Entrega o resultado em um bucket em vez da resposta: <code>{"type": string, "url": string}</code>. <code>tipo</code> é <code>s3</code>, <code>s3_gzip</code>, <code>s3_compatible</code>, <code>gcs</code>, ou <code>tos</code>. Somente assíncrono. <code>url</code> não é validado</td></tr></tbody></table>

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

Retorna resultados de busca do Cdiscount para uma palavra-chave.

**Modos:** síncrono · assíncrono

<table><thead><tr><th width="132">Nome</th><th width="86">Tipo</th><th width="88">Obrigatório</th><th>Descrição</th></tr></thead><tbody><tr><td><code>query</code></td><td>string</td><td>sim</td><td>Palavra-chave de busca</td></tr><tr><td><code>domain</code></td><td>string</td><td>não</td><td>TLD da loja</td></tr><tr><td><code>start_page</code></td><td>inteiro</td><td>não</td><td>Primeira página de resultados</td></tr><tr><td><code>output</code></td><td>array de strings</td><td>não</td><td>Formatos a retornar: <code>markdown</code>, <code>html</code>, <code>json</code>, <code>screenshot</code>. Padrão <code>["html"]</code>. <code>json</code> retorna campos analisados. <code>screenshot</code> requer <code>run_js: true</code></td></tr><tr><td><code>json</code></td><td>objeto</td><td>não</td><td>Extração personalizada: <code>{"prompt": string}</code> ou <code>{"schema": object}</code>, nunca ambos. Substitui o parser embutido</td></tr><tr><td><code>location</code></td><td>string</td><td>não</td><td>Código de país de duas letras para buscar, por exemplo <code>DE</code></td></tr><tr><td><code>device</code></td><td>string</td><td>não</td><td><code>desktop</code> (padrão) ou <code>mobile</code></td></tr><tr><td><code>run_js</code></td><td>booleano</td><td>não</td><td>Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 150 segundos ou mais</td></tr><tr><td><code>callback_url</code></td><td>string</td><td>não</td><td>URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com <code>400</code></td></tr><tr><td><code>storage</code></td><td>objeto</td><td>não</td><td>Entrega o resultado em um bucket em vez da resposta: <code>{"type": string, "url": string}</code>. <code>tipo</code> é <code>s3</code>, <code>s3_gzip</code>, <code>s3_compatible</code>, <code>gcs</code>, ou <code>tos</code>. Somente assíncrono. <code>url</code> não é validado</td></tr></tbody></table>

***

### City Market

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

Retorna campos analisados de uma página do City Market a partir de uma URL que você fornecer.

**Modos:** síncrono · assíncrono

| Nome               | Tipo             | Obrigatório | Descrição                                                                                                                                                                                    |
| ------------------ | ---------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `url`              | string           | sim         | Uma URL de produto ou de busca do City Market                                                                                                                                                |
| `delivery_zip`     | string           | não         | A entrega por CEP é cotada para                                                                                                                                                              |
| `fulfillment_type` | string           | não         | Filtro de entrega, retirada ou envio para casa                                                                                                                                               |
| `store_id`         | string           | não         | A loja cujo catálogo e preços são retornados                                                                                                                                                 |
| `output`           | array de strings | não         | Formatos a retornar: `markdown`, `html`, `json`, `screenshot`. Padrão `["html"]`. `json` retorna campos analisados. `screenshot` requer `run_js: true`                                       |
| `json`             | objeto           | não         | Extração personalizada: `{"prompt": string}` ou `{"schema": object}`, nunca ambos. Substitui o parser embutido                                                                               |
| `location`         | string           | não         | Código de país de duas letras para buscar, por exemplo `DE`                                                                                                                                  |
| `device`           | string           | não         | `desktop` (padrão) ou `mobile`                                                                                                                                                               |
| `run_js`           | booleano         | não         | Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 150 segundos ou mais                                                                              |
| `callback_url`     | string           | não         | URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com `400`                                                                                           |
| `storage`          | objeto           | não         | Entrega o resultado em um bucket em vez da resposta: `{"type": string, "url": string}`. `tipo` é `s3`, `s3_gzip`, `s3_compatible`, `gcs`, ou `tos`. Somente assíncrono. `url` não é validado |

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

Retorna o preço, o estoque e os detalhes de um produto do City Market.

**Modos:** síncrono · assíncrono

| Nome               | Tipo             | Obrigatório | Descrição                                                                                                                                                                                    |
| ------------------ | ---------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`            | string           | sim         | ID do produto                                                                                                                                                                                |
| `delivery_zip`     | string           | não         | A entrega por CEP é cotada para                                                                                                                                                              |
| `fulfillment_type` | string           | não         | Filtro de entrega, retirada ou envio para casa                                                                                                                                               |
| `store_id`         | string           | não         | A loja cujo catálogo e preços são retornados                                                                                                                                                 |
| `output`           | array de strings | não         | Formatos a retornar: `markdown`, `html`, `json`, `screenshot`. Padrão `["html"]`. `json` retorna campos analisados. `screenshot` requer `run_js: true`                                       |
| `json`             | objeto           | não         | Extração personalizada: `{"prompt": string}` ou `{"schema": object}`, nunca ambos. Substitui o parser embutido                                                                               |
| `location`         | string           | não         | Código de país de duas letras para buscar, por exemplo `DE`                                                                                                                                  |
| `device`           | string           | não         | `desktop` (padrão) ou `mobile`                                                                                                                                                               |
| `run_js`           | booleano         | não         | Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 150 segundos ou mais                                                                              |
| `callback_url`     | string           | não         | URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com `400`                                                                                           |
| `storage`          | objeto           | não         | Entrega o resultado em um bucket em vez da resposta: `{"type": string, "url": string}`. `tipo` é `s3`, `s3_gzip`, `s3_compatible`, `gcs`, ou `tos`. Somente assíncrono. `url` não é validado |

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

Retorna resultados de busca do City Market para uma palavra-chave.

**Modos:** síncrono · assíncrono

| Nome               | Tipo             | Obrigatório | Descrição                                                                                                                                                                                    |
| ------------------ | ---------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`            | string           | sim         | Palavra-chave de busca                                                                                                                                                                       |
| `brand`            | string           | não         | Restringe os resultados a uma marca                                                                                                                                                          |
| `delivery_zip`     | string           | não         | A entrega por CEP é cotada para                                                                                                                                                              |
| `fulfillment_type` | string           | não         | Filtro de entrega, retirada ou envio para casa                                                                                                                                               |
| `price_range`      | string           | não         | Filtro de faixa de preço                                                                                                                                                                     |
| `store_id`         | string           | não         | A loja cujo catálogo e preços são retornados                                                                                                                                                 |
| `output`           | array de strings | não         | Formatos a retornar: `markdown`, `html`, `json`, `screenshot`. Padrão `["html"]`. `json` retorna campos analisados. `screenshot` requer `run_js: true`                                       |
| `json`             | objeto           | não         | Extração personalizada: `{"prompt": string}` ou `{"schema": object}`, nunca ambos. Substitui o parser embutido                                                                               |
| `location`         | string           | não         | Código de país de duas letras para buscar, por exemplo `DE`                                                                                                                                  |
| `device`           | string           | não         | `desktop` (padrão) ou `mobile`                                                                                                                                                               |
| `run_js`           | booleano         | não         | Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 150 segundos ou mais                                                                              |
| `callback_url`     | string           | não         | URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com `400`                                                                                           |
| `storage`          | objeto           | não         | Entrega o resultado em um bucket em vez da resposta: `{"type": string, "url": string}`. `tipo` é `s3`, `s3_gzip`, `s3_compatible`, `gcs`, ou `tos`. Somente assíncrono. `url` não é validado |

***

### Costco

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

Retorna campos analisados de uma página do Costco a partir de uma URL que você fornecer.

**Modos:** síncrono · assíncrono

| Nome           | Tipo             | Obrigatório | Descrição                                                                                                                                                                                    |
| -------------- | ---------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `url`          | string           | sim         | Uma URL de produto ou de busca do Costco                                                                                                                                                     |
| `output`       | array de strings | não         | Formatos a retornar: `markdown`, `html`, `json`, `screenshot`. Padrão `["html"]`. `json` retorna campos analisados. `screenshot` requer `run_js: true`                                       |
| `json`         | objeto           | não         | Extração personalizada: `{"prompt": string}` ou `{"schema": object}`, nunca ambos. Substitui o parser embutido                                                                               |
| `location`     | string           | não         | Código de país de duas letras para buscar, por exemplo `DE`                                                                                                                                  |
| `device`       | string           | não         | `desktop` (padrão) ou `mobile`                                                                                                                                                               |
| `run_js`       | booleano         | não         | Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 150 segundos ou mais                                                                              |
| `callback_url` | string           | não         | URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com `400`                                                                                           |
| `storage`      | objeto           | não         | Entrega o resultado em um bucket em vez da resposta: `{"type": string, "url": string}`. `tipo` é `s3`, `s3_gzip`, `s3_compatible`, `gcs`, ou `tos`. Somente assíncrono. `url` não é validado |

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

Retorna o preço, o estoque e os detalhes de um produto do Costco.

**Modos:** síncrono · assíncrono

| Nome           | Tipo             | Obrigatório | Descrição                                                                                                                                                                                    |
| -------------- | ---------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`        | string           | sim         | ID do produto                                                                                                                                                                                |
| `domain`       | string           | não         | TLD da loja                                                                                                                                                                                  |
| `output`       | array de strings | não         | Formatos a retornar: `markdown`, `html`, `json`, `screenshot`. Padrão `["html"]`. `json` retorna campos analisados. `screenshot` requer `run_js: true`                                       |
| `json`         | objeto           | não         | Extração personalizada: `{"prompt": string}` ou `{"schema": object}`, nunca ambos. Substitui o parser embutido                                                                               |
| `location`     | string           | não         | Código de país de duas letras para buscar, por exemplo `DE`                                                                                                                                  |
| `device`       | string           | não         | `desktop` (padrão) ou `mobile`                                                                                                                                                               |
| `run_js`       | booleano         | não         | Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 150 segundos ou mais                                                                              |
| `callback_url` | string           | não         | URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com `400`                                                                                           |
| `storage`      | objeto           | não         | Entrega o resultado em um bucket em vez da resposta: `{"type": string, "url": string}`. `tipo` é `s3`, `s3_gzip`, `s3_compatible`, `gcs`, ou `tos`. Somente assíncrono. `url` não é validado |

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

Retorna resultados de busca do Costco para uma palavra-chave.

**Modos:** síncrono · assíncrono

| Nome           | Tipo             | Obrigatório | Descrição                                                                                                                                                                                    |
| -------------- | ---------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`        | string           | sim         | Palavra-chave de busca                                                                                                                                                                       |
| `domain`       | string           | não         | TLD da loja                                                                                                                                                                                  |
| `start_page`   | inteiro          | não         | Primeira página de resultados                                                                                                                                                                |
| `output`       | array de strings | não         | Formatos a retornar: `markdown`, `html`, `json`, `screenshot`. Padrão `["html"]`. `json` retorna campos analisados. `screenshot` requer `run_js: true`                                       |
| `json`         | objeto           | não         | Extração personalizada: `{"prompt": string}` ou `{"schema": object}`, nunca ambos. Substitui o parser embutido                                                                               |
| `location`     | string           | não         | Código de país de duas letras para buscar, por exemplo `DE`                                                                                                                                  |
| `device`       | string           | não         | `desktop` (padrão) ou `mobile`                                                                                                                                                               |
| `run_js`       | booleano         | não         | Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 150 segundos ou mais                                                                              |
| `callback_url` | string           | não         | URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com `400`                                                                                           |
| `storage`      | objeto           | não         | Entrega o resultado em um bucket em vez da resposta: `{"type": string, "url": string}`. `tipo` é `s3`, `s3_gzip`, `s3_compatible`, `gcs`, ou `tos`. Somente assíncrono. `url` não é validado |

***

### Dcard

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

Retorna resultados de busca do Dcard para uma palavra-chave.

**Modos:** síncrono · assíncrono

| Nome           | Tipo             | Obrigatório | Descrição                                                                                                                                                                                    |
| -------------- | ---------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`        | string           | sim         | Palavra-chave de busca                                                                                                                                                                       |
| `domain`       | string           | não         | TLD da loja                                                                                                                                                                                  |
| `output`       | array de strings | não         | Formatos a retornar: `markdown`, `html`, `json`, `screenshot`. Padrão `["html"]`. `json` retorna campos analisados. `screenshot` requer `run_js: true`                                       |
| `json`         | objeto           | não         | Extração personalizada: `{"prompt": string}` ou `{"schema": object}`, nunca ambos. Substitui o parser embutido                                                                               |
| `location`     | string           | não         | Código de país de duas letras para buscar, por exemplo `DE`                                                                                                                                  |
| `device`       | string           | não         | `desktop` (padrão) ou `mobile`                                                                                                                                                               |
| `run_js`       | booleano         | não         | Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 150 segundos ou mais                                                                              |
| `callback_url` | string           | não         | URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com `400`                                                                                           |
| `storage`      | objeto           | não         | Entrega o resultado em um bucket em vez da resposta: `{"type": string, "url": string}`. `tipo` é `s3`, `s3_gzip`, `s3_compatible`, `gcs`, ou `tos`. Somente assíncrono. `url` não é validado |

***

### Dillons

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

Retorna campos analisados de uma página do Dillons a partir de uma URL que você fornecer.

**Modos:** síncrono · assíncrono

| Nome               | Tipo             | Obrigatório | Descrição                                                                                                                                                                                    |
| ------------------ | ---------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `url`              | string           | sim         | Uma URL de produto ou de busca do Dillons                                                                                                                                                    |
| `delivery_zip`     | string           | não         | A entrega por CEP é cotada para                                                                                                                                                              |
| `fulfillment_type` | string           | não         | Filtro de entrega, retirada ou envio para casa                                                                                                                                               |
| `store_id`         | string           | não         | A loja cujo catálogo e preços são retornados                                                                                                                                                 |
| `output`           | array de strings | não         | Formatos a retornar: `markdown`, `html`, `json`, `screenshot`. Padrão `["html"]`. `json` retorna campos analisados. `screenshot` requer `run_js: true`                                       |
| `json`             | objeto           | não         | Extração personalizada: `{"prompt": string}` ou `{"schema": object}`, nunca ambos. Substitui o parser embutido                                                                               |
| `location`         | string           | não         | Código de país de duas letras para buscar, por exemplo `DE`                                                                                                                                  |
| `device`           | string           | não         | `desktop` (padrão) ou `mobile`                                                                                                                                                               |
| `run_js`           | booleano         | não         | Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 150 segundos ou mais                                                                              |
| `callback_url`     | string           | não         | URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com `400`                                                                                           |
| `storage`          | objeto           | não         | Entrega o resultado em um bucket em vez da resposta: `{"type": string, "url": string}`. `tipo` é `s3`, `s3_gzip`, `s3_compatible`, `gcs`, ou `tos`. Somente assíncrono. `url` não é validado |

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

Retorna o preço, o estoque e os detalhes de um produto do Dillons.

**Modos:** síncrono · assíncrono

| Nome               | Tipo             | Obrigatório | Descrição                                                                                                                                                                                    |
| ------------------ | ---------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`            | string           | sim         | ID do produto                                                                                                                                                                                |
| `delivery_zip`     | string           | não         | A entrega por CEP é cotada para                                                                                                                                                              |
| `fulfillment_type` | string           | não         | Filtro de entrega, retirada ou envio para casa                                                                                                                                               |
| `store_id`         | string           | não         | A loja cujo catálogo e preços são retornados                                                                                                                                                 |
| `output`           | array de strings | não         | Formatos a retornar: `markdown`, `html`, `json`, `screenshot`. Padrão `["html"]`. `json` retorna campos analisados. `screenshot` requer `run_js: true`                                       |
| `json`             | objeto           | não         | Extração personalizada: `{"prompt": string}` ou `{"schema": object}`, nunca ambos. Substitui o parser embutido                                                                               |
| `location`         | string           | não         | Código de país de duas letras para buscar, por exemplo `DE`                                                                                                                                  |
| `device`           | string           | não         | `desktop` (padrão) ou `mobile`                                                                                                                                                               |
| `run_js`           | booleano         | não         | Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 150 segundos ou mais                                                                              |
| `callback_url`     | string           | não         | URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com `400`                                                                                           |
| `storage`          | objeto           | não         | Entrega o resultado em um bucket em vez da resposta: `{"type": string, "url": string}`. `tipo` é `s3`, `s3_gzip`, `s3_compatible`, `gcs`, ou `tos`. Somente assíncrono. `url` não é validado |

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

Retorna resultados de busca do Dillons para uma palavra-chave.

**Modos:** síncrono · assíncrono

| Nome               | Tipo             | Obrigatório | Descrição                                                                                                                                                                                    |
| ------------------ | ---------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`            | string           | sim         | Palavra-chave de busca                                                                                                                                                                       |
| `brand`            | string           | não         | Restringe os resultados a uma marca                                                                                                                                                          |
| `delivery_zip`     | string           | não         | A entrega por CEP é cotada para                                                                                                                                                              |
| `fulfillment_type` | string           | não         | Filtro de entrega, retirada ou envio para casa                                                                                                                                               |
| `price_range`      | string           | não         | Filtro de faixa de preço                                                                                                                                                                     |
| `store_id`         | string           | não         | A loja cujo catálogo e preços são retornados                                                                                                                                                 |
| `output`           | array de strings | não         | Formatos a retornar: `markdown`, `html`, `json`, `screenshot`. Padrão `["html"]`. `json` retorna campos analisados. `screenshot` requer `run_js: true`                                       |
| `json`             | objeto           | não         | Extração personalizada: `{"prompt": string}` ou `{"schema": object}`, nunca ambos. Substitui o parser embutido                                                                               |
| `location`         | string           | não         | Código de país de duas letras para buscar, por exemplo `DE`                                                                                                                                  |
| `device`           | string           | não         | `desktop` (padrão) ou `mobile`                                                                                                                                                               |
| `run_js`           | booleano         | não         | Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 150 segundos ou mais                                                                              |
| `callback_url`     | string           | não         | URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com `400`                                                                                           |
| `storage`          | objeto           | não         | Entrega o resultado em um bucket em vez da resposta: `{"type": string, "url": string}`. `tipo` é `s3`, `s3_gzip`, `s3_compatible`, `gcs`, ou `tos`. Somente assíncrono. `url` não é validado |

***

### eBay

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

Retorna campos analisados de uma página do eBay a partir de uma URL que você fornecer.

**Modos:** síncrono · assíncrono

| Nome           | Tipo             | Obrigatório | Descrição                                                                                                                                                                                    |
| -------------- | ---------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `url`          | string           | sim         | Uma URL de produto ou de busca do eBay                                                                                                                                                       |
| `output`       | array de strings | não         | Formatos a retornar: `markdown`, `html`, `json`, `screenshot`. Padrão `["html"]`. `json` retorna campos analisados. `screenshot` requer `run_js: true`                                       |
| `json`         | objeto           | não         | Extração personalizada: `{"prompt": string}` ou `{"schema": object}`, nunca ambos. Substitui o parser embutido                                                                               |
| `location`     | string           | não         | Código de país de duas letras para buscar, por exemplo `DE`                                                                                                                                  |
| `device`       | string           | não         | `desktop` (padrão) ou `mobile`                                                                                                                                                               |
| `run_js`       | booleano         | não         | Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 150 segundos ou mais                                                                              |
| `callback_url` | string           | não         | URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com `400`                                                                                           |
| `storage`      | objeto           | não         | Entrega o resultado em um bucket em vez da resposta: `{"type": string, "url": string}`. `tipo` é `s3`, `s3_gzip`, `s3_compatible`, `gcs`, ou `tos`. Somente assíncrono. `url` não é validado |

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

Retorna o preço, o estoque e os detalhes de um produto do eBay.

**Modos:** síncrono · assíncrono

| Nome           | Tipo             | Obrigatório | Descrição                                                                                                                                                                                    |
| -------------- | ---------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`        | string           | sim         | ID do produto                                                                                                                                                                                |
| `domain`       | string           | não         | TLD da loja                                                                                                                                                                                  |
| `output`       | array de strings | não         | Formatos a retornar: `markdown`, `html`, `json`, `screenshot`. Padrão `["html"]`. `json` retorna campos analisados. `screenshot` requer `run_js: true`                                       |
| `json`         | objeto           | não         | Extração personalizada: `{"prompt": string}` ou `{"schema": object}`, nunca ambos. Substitui o parser embutido                                                                               |
| `location`     | string           | não         | Código de país de duas letras para buscar, por exemplo `DE`                                                                                                                                  |
| `device`       | string           | não         | `desktop` (padrão) ou `mobile`                                                                                                                                                               |
| `run_js`       | booleano         | não         | Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 150 segundos ou mais                                                                              |
| `callback_url` | string           | não         | URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com `400`                                                                                           |
| `storage`      | objeto           | não         | Entrega o resultado em um bucket em vez da resposta: `{"type": string, "url": string}`. `tipo` é `s3`, `s3_gzip`, `s3_compatible`, `gcs`, ou `tos`. Somente assíncrono. `url` não é validado |

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

Retorna resultados de busca do eBay para uma palavra-chave.

**Modos:** síncrono · assíncrono

| Nome           | Tipo             | Obrigatório | Descrição                                                                                                                                                                                    |
| -------------- | ---------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`        | string           | sim         | Palavra-chave de busca                                                                                                                                                                       |
| `domain`       | string           | não         | TLD da loja                                                                                                                                                                                  |
| `start_page`   | inteiro          | não         | Primeira página de resultados                                                                                                                                                                |
| `output`       | array de strings | não         | Formatos a retornar: `markdown`, `html`, `json`, `screenshot`. Padrão `["html"]`. `json` retorna campos analisados. `screenshot` requer `run_js: true`                                       |
| `json`         | objeto           | não         | Extração personalizada: `{"prompt": string}` ou `{"schema": object}`, nunca ambos. Substitui o parser embutido                                                                               |
| `location`     | string           | não         | Código de país de duas letras para buscar, por exemplo `DE`                                                                                                                                  |
| `device`       | string           | não         | `desktop` (padrão) ou `mobile`                                                                                                                                                               |
| `run_js`       | booleano         | não         | Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 150 segundos ou mais                                                                              |
| `callback_url` | string           | não         | URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com `400`                                                                                           |
| `storage`      | objeto           | não         | Entrega o resultado em um bucket em vez da resposta: `{"type": string, "url": string}`. `tipo` é `s3`, `s3_gzip`, `s3_compatible`, `gcs`, ou `tos`. Somente assíncrono. `url` não é validado |

***

### Etsy

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

Retorna campos analisados de uma página do Etsy a partir de uma URL que você fornecer.

**Modos:** síncrono · assíncrono

| Nome           | Tipo             | Obrigatório | Descrição                                                                                                                                                                                    |
| -------------- | ---------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `url`          | string           | sim         | Uma URL de produto ou de busca do Etsy                                                                                                                                                       |
| `output`       | array de strings | não         | Formatos a retornar: `markdown`, `html`, `json`, `screenshot`. Padrão `["html"]`. `json` retorna campos analisados. `screenshot` requer `run_js: true`                                       |
| `json`         | objeto           | não         | Extração personalizada: `{"prompt": string}` ou `{"schema": object}`, nunca ambos. Substitui o parser embutido                                                                               |
| `location`     | string           | não         | Código de país de duas letras para buscar, por exemplo `DE`                                                                                                                                  |
| `device`       | string           | não         | `desktop` (padrão) ou `mobile`                                                                                                                                                               |
| `run_js`       | booleano         | não         | Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 120 segundos ou mais                                                                              |
| `callback_url` | string           | não         | URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com `400`                                                                                           |
| `storage`      | objeto           | não         | Entrega o resultado em um bucket em vez da resposta: `{"type": string, "url": string}`. `tipo` é `s3`, `s3_gzip`, `s3_compatible`, `gcs`, ou `tos`. Somente assíncrono. `url` não é validado |

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

Retorna o preço, o estoque e os detalhes de um produto do Etsy.

**Modos:** síncrono · assíncrono

| Nome           | Tipo             | Obrigatório | Descrição                                                                                                                                                                                    |
| -------------- | ---------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`        | string           | sim         | ID do produto                                                                                                                                                                                |
| `output`       | array de strings | não         | Formatos a retornar: `markdown`, `html`, `json`, `screenshot`. Padrão `["html"]`. `json` retorna campos analisados. `screenshot` requer `run_js: true`                                       |
| `json`         | objeto           | não         | Extração personalizada: `{"prompt": string}` ou `{"schema": object}`, nunca ambos. Substitui o parser embutido                                                                               |
| `location`     | string           | não         | Código de país de duas letras para buscar, por exemplo `DE`                                                                                                                                  |
| `device`       | string           | não         | `desktop` (padrão) ou `mobile`                                                                                                                                                               |
| `run_js`       | booleano         | não         | Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 120 segundos ou mais                                                                              |
| `callback_url` | string           | não         | URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com `400`                                                                                           |
| `storage`      | objeto           | não         | Entrega o resultado em um bucket em vez da resposta: `{"type": string, "url": string}`. `tipo` é `s3`, `s3_gzip`, `s3_compatible`, `gcs`, ou `tos`. Somente assíncrono. `url` não é validado |

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

Retorna resultados de busca do Etsy para uma palavra-chave.

**Modos:** síncrono · assíncrono

| Nome           | Tipo             | Obrigatório | Descrição                                                                                                                                                                                    |
| -------------- | ---------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`        | string           | sim         | Palavra-chave de busca                                                                                                                                                                       |
| `domain`       | string           | não         | TLD da loja                                                                                                                                                                                  |
| `ship_to`      | string           | não         | Destino de envio                                                                                                                                                                             |
| `start_page`   | inteiro          | não         | Primeira página de resultados                                                                                                                                                                |
| `store_id`     | string           | não         | A loja cujo catálogo e preços são retornados                                                                                                                                                 |
| `output`       | array de strings | não         | Formatos a retornar: `markdown`, `html`, `json`, `screenshot`. Padrão `["html"]`. `json` retorna campos analisados. `screenshot` requer `run_js: true`                                       |
| `json`         | objeto           | não         | Extração personalizada: `{"prompt": string}` ou `{"schema": object}`, nunca ambos. Substitui o parser embutido                                                                               |
| `location`     | string           | não         | Código de país de duas letras para buscar, por exemplo `DE`                                                                                                                                  |
| `device`       | string           | não         | `desktop` (padrão) ou `mobile`                                                                                                                                                               |
| `run_js`       | booleano         | não         | Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 120 segundos ou mais                                                                              |
| `callback_url` | string           | não         | URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com `400`                                                                                           |
| `storage`      | objeto           | não         | Entrega o resultado em um bucket em vez da resposta: `{"type": string, "url": string}`. `tipo` é `s3`, `s3_gzip`, `s3_compatible`, `gcs`, ou `tos`. Somente assíncrono. `url` não é validado |

***

### Falabella

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

Retorna campos extraídos de uma página da Falabella a partir de uma URL que você fornecer.

**Modos:** síncrono · assíncrono

| Nome           | Tipo             | Obrigatório | Descrição                                                                                                                                                                                    |
| -------------- | ---------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `url`          | string           | sim         | Uma URL de produto ou de busca da Falabella                                                                                                                                                  |
| `output`       | array de strings | não         | Formatos a retornar: `markdown`, `html`, `json`, `screenshot`. Padrão `["html"]`. `json` retorna campos analisados. `screenshot` requer `run_js: true`                                       |
| `json`         | objeto           | não         | Extração personalizada: `{"prompt": string}` ou `{"schema": object}`, nunca ambos. Substitui o parser embutido                                                                               |
| `location`     | string           | não         | Código de país de duas letras para buscar, por exemplo `DE`                                                                                                                                  |
| `device`       | string           | não         | `desktop` (padrão) ou `mobile`                                                                                                                                                               |
| `run_js`       | booleano         | não         | Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 120 segundos ou mais                                                                              |
| `callback_url` | string           | não         | URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com `400`                                                                                           |
| `storage`      | objeto           | não         | Entrega o resultado em um bucket em vez da resposta: `{"type": string, "url": string}`. `tipo` é `s3`, `s3_gzip`, `s3_compatible`, `gcs`, ou `tos`. Somente assíncrono. `url` não é validado |

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

Retorna o preço, o estoque e os detalhes de um produto da Falabella.

**Modos:** síncrono · assíncrono

| Nome           | Tipo             | Obrigatório | Descrição                                                                                                                                                                                    |
| -------------- | ---------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`        | string           | sim         | ID do produto                                                                                                                                                                                |
| `domain`       | string           | não         | TLD da loja                                                                                                                                                                                  |
| `output`       | array de strings | não         | Formatos a retornar: `markdown`, `html`, `json`, `screenshot`. Padrão `["html"]`. `json` retorna campos analisados. `screenshot` requer `run_js: true`                                       |
| `json`         | objeto           | não         | Extração personalizada: `{"prompt": string}` ou `{"schema": object}`, nunca ambos. Substitui o parser embutido                                                                               |
| `location`     | string           | não         | Código de país de duas letras para buscar, por exemplo `DE`                                                                                                                                  |
| `device`       | string           | não         | `desktop` (padrão) ou `mobile`                                                                                                                                                               |
| `run_js`       | booleano         | não         | Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 120 segundos ou mais                                                                              |
| `callback_url` | string           | não         | URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com `400`                                                                                           |
| `storage`      | objeto           | não         | Entrega o resultado em um bucket em vez da resposta: `{"type": string, "url": string}`. `tipo` é `s3`, `s3_gzip`, `s3_compatible`, `gcs`, ou `tos`. Somente assíncrono. `url` não é validado |

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

Retorna resultados de busca da Falabella para uma palavra-chave.

**Modos:** síncrono · assíncrono

| Nome           | Tipo             | Obrigatório | Descrição                                                                                                                                                                                    |
| -------------- | ---------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`        | string           | sim         | Palavra-chave de busca                                                                                                                                                                       |
| `domain`       | string           | não         | TLD da loja                                                                                                                                                                                  |
| `start_page`   | inteiro          | não         | Primeira página de resultados                                                                                                                                                                |
| `output`       | array de strings | não         | Formatos a retornar: `markdown`, `html`, `json`, `screenshot`. Padrão `["html"]`. `json` retorna campos analisados. `screenshot` requer `run_js: true`                                       |
| `json`         | objeto           | não         | Extração personalizada: `{"prompt": string}` ou `{"schema": object}`, nunca ambos. Substitui o parser embutido                                                                               |
| `location`     | string           | não         | Código de país de duas letras para buscar, por exemplo `DE`                                                                                                                                  |
| `device`       | string           | não         | `desktop` (padrão) ou `mobile`                                                                                                                                                               |
| `run_js`       | booleano         | não         | Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 120 segundos ou mais                                                                              |
| `callback_url` | string           | não         | URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com `400`                                                                                           |
| `storage`      | objeto           | não         | Entrega o resultado em um bucket em vez da resposta: `{"type": string, "url": string}`. `tipo` é `s3`, `s3_gzip`, `s3_compatible`, `gcs`, ou `tos`. Somente assíncrono. `url` não é validado |

***

### Flipkart

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

Retorna campos extraídos de uma página da Flipkart a partir de uma URL que você fornecer.

**Modos:** síncrono · assíncrono

| Nome           | Tipo             | Obrigatório | Descrição                                                                                                                                                                                    |
| -------------- | ---------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `url`          | string           | sim         | Uma URL de produto ou de busca da Flipkart                                                                                                                                                   |
| `output`       | array de strings | não         | Formatos a retornar: `markdown`, `html`, `json`, `screenshot`. Padrão `["html"]`. `json` retorna campos analisados. `screenshot` requer `run_js: true`                                       |
| `json`         | objeto           | não         | Extração personalizada: `{"prompt": string}` ou `{"schema": object}`, nunca ambos. Substitui o parser embutido                                                                               |
| `location`     | string           | não         | Código de país de duas letras para buscar, por exemplo `DE`                                                                                                                                  |
| `device`       | string           | não         | `desktop` (padrão) ou `mobile`                                                                                                                                                               |
| `run_js`       | booleano         | não         | Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 120 segundos ou mais                                                                              |
| `callback_url` | string           | não         | URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com `400`                                                                                           |
| `storage`      | objeto           | não         | Entrega o resultado em um bucket em vez da resposta: `{"type": string, "url": string}`. `tipo` é `s3`, `s3_gzip`, `s3_compatible`, `gcs`, ou `tos`. Somente assíncrono. `url` não é validado |

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

Retorna o preço, o estoque e os detalhes de um produto da Flipkart.

**Modos:** síncrono · assíncrono

| Nome           | Tipo             | Obrigatório | Descrição                                                                                                                                                                                    |
| -------------- | ---------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`        | string           | sim         | ID do produto                                                                                                                                                                                |
| `domain`       | string           | não         | TLD da loja                                                                                                                                                                                  |
| `output`       | array de strings | não         | Formatos a retornar: `markdown`, `html`, `json`, `screenshot`. Padrão `["html"]`. `json` retorna campos analisados. `screenshot` requer `run_js: true`                                       |
| `json`         | objeto           | não         | Extração personalizada: `{"prompt": string}` ou `{"schema": object}`, nunca ambos. Substitui o parser embutido                                                                               |
| `location`     | string           | não         | Código de país de duas letras para buscar, por exemplo `DE`                                                                                                                                  |
| `device`       | string           | não         | `desktop` (padrão) ou `mobile`                                                                                                                                                               |
| `run_js`       | booleano         | não         | Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 120 segundos ou mais                                                                              |
| `callback_url` | string           | não         | URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com `400`                                                                                           |
| `storage`      | objeto           | não         | Entrega o resultado em um bucket em vez da resposta: `{"type": string, "url": string}`. `tipo` é `s3`, `s3_gzip`, `s3_compatible`, `gcs`, ou `tos`. Somente assíncrono. `url` não é validado |

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

Retorna resultados de busca da Flipkart para uma palavra-chave.

**Modos:** síncrono · assíncrono

| Nome           | Tipo             | Obrigatório | Descrição                                                                                                                                                                                    |
| -------------- | ---------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`        | string           | sim         | Palavra-chave de busca                                                                                                                                                                       |
| `domain`       | string           | não         | TLD da loja                                                                                                                                                                                  |
| `start_page`   | inteiro          | não         | Primeira página de resultados                                                                                                                                                                |
| `output`       | array de strings | não         | Formatos a retornar: `markdown`, `html`, `json`, `screenshot`. Padrão `["html"]`. `json` retorna campos analisados. `screenshot` requer `run_js: true`                                       |
| `json`         | objeto           | não         | Extração personalizada: `{"prompt": string}` ou `{"schema": object}`, nunca ambos. Substitui o parser embutido                                                                               |
| `location`     | string           | não         | Código de país de duas letras para buscar, por exemplo `DE`                                                                                                                                  |
| `device`       | string           | não         | `desktop` (padrão) ou `mobile`                                                                                                                                                               |
| `run_js`       | booleano         | não         | Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 120 segundos ou mais                                                                              |
| `callback_url` | string           | não         | URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com `400`                                                                                           |
| `storage`      | objeto           | não         | Entrega o resultado em um bucket em vez da resposta: `{"type": string, "url": string}`. `tipo` é `s3`, `s3_gzip`, `s3_compatible`, `gcs`, ou `tos`. Somente assíncrono. `url` não é validado |

***

### Food 4 Less

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

Retorna campos extraídos de uma página do Food 4 Less a partir de uma URL que você fornecer.

**Modos:** síncrono · assíncrono

| Nome               | Tipo             | Obrigatório | Descrição                                                                                                                                                                                    |
| ------------------ | ---------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `url`              | string           | sim         | Uma URL de produto ou de busca do Food 4 Less                                                                                                                                                |
| `delivery_zip`     | string           | não         | A entrega por CEP é cotada para                                                                                                                                                              |
| `fulfillment_type` | string           | não         | Filtro de entrega, retirada ou envio para casa                                                                                                                                               |
| `store_id`         | string           | não         | A loja cujo catálogo e preços são retornados                                                                                                                                                 |
| `output`           | array de strings | não         | Formatos a retornar: `markdown`, `html`, `json`, `screenshot`. Padrão `["html"]`. `json` retorna campos analisados. `screenshot` requer `run_js: true`                                       |
| `json`             | objeto           | não         | Extração personalizada: `{"prompt": string}` ou `{"schema": object}`, nunca ambos. Substitui o parser embutido                                                                               |
| `location`         | string           | não         | Código de país de duas letras para buscar, por exemplo `DE`                                                                                                                                  |
| `device`           | string           | não         | `desktop` (padrão) ou `mobile`                                                                                                                                                               |
| `run_js`           | booleano         | não         | Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 120 segundos ou mais                                                                              |
| `callback_url`     | string           | não         | URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com `400`                                                                                           |
| `storage`          | objeto           | não         | Entrega o resultado em um bucket em vez da resposta: `{"type": string, "url": string}`. `tipo` é `s3`, `s3_gzip`, `s3_compatible`, `gcs`, ou `tos`. Somente assíncrono. `url` não é validado |

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

Retorna o preço, o estoque e os detalhes de um produto do Food 4 Less.

**Modos:** síncrono · assíncrono

| Nome               | Tipo             | Obrigatório | Descrição                                                                                                                                                                                    |
| ------------------ | ---------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`            | string           | sim         | ID do produto                                                                                                                                                                                |
| `delivery_zip`     | string           | não         | A entrega por CEP é cotada para                                                                                                                                                              |
| `fulfillment_type` | string           | não         | Filtro de entrega, retirada ou envio para casa                                                                                                                                               |
| `store_id`         | string           | não         | A loja cujo catálogo e preços são retornados                                                                                                                                                 |
| `output`           | array de strings | não         | Formatos a retornar: `markdown`, `html`, `json`, `screenshot`. Padrão `["html"]`. `json` retorna campos analisados. `screenshot` requer `run_js: true`                                       |
| `json`             | objeto           | não         | Extração personalizada: `{"prompt": string}` ou `{"schema": object}`, nunca ambos. Substitui o parser embutido                                                                               |
| `location`         | string           | não         | Código de país de duas letras para buscar, por exemplo `DE`                                                                                                                                  |
| `device`           | string           | não         | `desktop` (padrão) ou `mobile`                                                                                                                                                               |
| `run_js`           | booleano         | não         | Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 120 segundos ou mais                                                                              |
| `callback_url`     | string           | não         | URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com `400`                                                                                           |
| `storage`          | objeto           | não         | Entrega o resultado em um bucket em vez da resposta: `{"type": string, "url": string}`. `tipo` é `s3`, `s3_gzip`, `s3_compatible`, `gcs`, ou `tos`. Somente assíncrono. `url` não é validado |

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

Retorna resultados de busca do Food 4 Less para uma palavra-chave.

**Modos:** síncrono · assíncrono

| Nome               | Tipo             | Obrigatório | Descrição                                                                                                                                                                                    |
| ------------------ | ---------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`            | string           | sim         | Palavra-chave de busca                                                                                                                                                                       |
| `delivery_zip`     | string           | não         | A entrega por CEP é cotada para                                                                                                                                                              |
| `fulfillment_type` | string           | não         | Filtro de entrega, retirada ou envio para casa                                                                                                                                               |
| `store_id`         | string           | não         | A loja cujo catálogo e preços são retornados                                                                                                                                                 |
| `output`           | array de strings | não         | Formatos a retornar: `markdown`, `html`, `json`, `screenshot`. Padrão `["html"]`. `json` retorna campos analisados. `screenshot` requer `run_js: true`                                       |
| `json`             | objeto           | não         | Extração personalizada: `{"prompt": string}` ou `{"schema": object}`, nunca ambos. Substitui o parser embutido                                                                               |
| `location`         | string           | não         | Código de país de duas letras para buscar, por exemplo `DE`                                                                                                                                  |
| `device`           | string           | não         | `desktop` (padrão) ou `mobile`                                                                                                                                                               |
| `run_js`           | booleano         | não         | Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 120 segundos ou mais                                                                              |
| `callback_url`     | string           | não         | URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com `400`                                                                                           |
| `storage`          | objeto           | não         | Entrega o resultado em um bucket em vez da resposta: `{"type": string, "url": string}`. `tipo` é `s3`, `s3_gzip`, `s3_compatible`, `gcs`, ou `tos`. Somente assíncrono. `url` não é validado |

Aceita o formato de produto: não `brand` ou `price_range`.

***

### Fred Meyer

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

Retorna campos extraídos de uma página do Fred Meyer a partir de uma URL que você fornecer.

**Modos:** síncrono · assíncrono

| Nome               | Tipo             | Obrigatório | Descrição                                                                                                                                                                                    |
| ------------------ | ---------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `url`              | string           | sim         | Uma URL de produto ou de busca do Fred Meyer                                                                                                                                                 |
| `delivery_zip`     | string           | não         | A entrega por CEP é cotada para                                                                                                                                                              |
| `fulfillment_type` | string           | não         | Filtro de entrega, retirada ou envio para casa                                                                                                                                               |
| `store_id`         | string           | não         | A loja cujo catálogo e preços são retornados                                                                                                                                                 |
| `output`           | array de strings | não         | Formatos a retornar: `markdown`, `html`, `json`, `screenshot`. Padrão `["html"]`. `json` retorna campos analisados. `screenshot` requer `run_js: true`                                       |
| `json`             | objeto           | não         | Extração personalizada: `{"prompt": string}` ou `{"schema": object}`, nunca ambos. Substitui o parser embutido                                                                               |
| `location`         | string           | não         | Código de país de duas letras para buscar, por exemplo `DE`                                                                                                                                  |
| `device`           | string           | não         | `desktop` (padrão) ou `mobile`                                                                                                                                                               |
| `run_js`           | booleano         | não         | Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 120 segundos ou mais                                                                              |
| `callback_url`     | string           | não         | URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com `400`                                                                                           |
| `storage`          | objeto           | não         | Entrega o resultado em um bucket em vez da resposta: `{"type": string, "url": string}`. `tipo` é `s3`, `s3_gzip`, `s3_compatible`, `gcs`, ou `tos`. Somente assíncrono. `url` não é validado |

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

Retorna o preço, o estoque e os detalhes de um produto do Fred Meyer.

**Modos:** síncrono · assíncrono

| Nome               | Tipo             | Obrigatório | Descrição                                                                                                                                                                                    |
| ------------------ | ---------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`            | string           | sim         | ID do produto                                                                                                                                                                                |
| `delivery_zip`     | string           | não         | A entrega por CEP é cotada para                                                                                                                                                              |
| `fulfillment_type` | string           | não         | Filtro de entrega, retirada ou envio para casa                                                                                                                                               |
| `store_id`         | string           | não         | A loja cujo catálogo e preços são retornados                                                                                                                                                 |
| `output`           | array de strings | não         | Formatos a retornar: `markdown`, `html`, `json`, `screenshot`. Padrão `["html"]`. `json` retorna campos analisados. `screenshot` requer `run_js: true`                                       |
| `json`             | objeto           | não         | Extração personalizada: `{"prompt": string}` ou `{"schema": object}`, nunca ambos. Substitui o parser embutido                                                                               |
| `location`         | string           | não         | Código de país de duas letras para buscar, por exemplo `DE`                                                                                                                                  |
| `device`           | string           | não         | `desktop` (padrão) ou `mobile`                                                                                                                                                               |
| `run_js`           | booleano         | não         | Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 120 segundos ou mais                                                                              |
| `callback_url`     | string           | não         | URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com `400`                                                                                           |
| `storage`          | objeto           | não         | Entrega o resultado em um bucket em vez da resposta: `{"type": string, "url": string}`. `tipo` é `s3`, `s3_gzip`, `s3_compatible`, `gcs`, ou `tos`. Somente assíncrono. `url` não é validado |

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

Retorna resultados de busca do Fred Meyer para uma palavra-chave.

**Modos:** síncrono · assíncrono

| Nome               | Tipo             | Obrigatório | Descrição                                                                                                                                                                                    |
| ------------------ | ---------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`            | string           | sim         | Palavra-chave de busca                                                                                                                                                                       |
| `brand`            | string           | não         | Restringe os resultados a uma marca                                                                                                                                                          |
| `delivery_zip`     | string           | não         | A entrega por CEP é cotada para                                                                                                                                                              |
| `fulfillment_type` | string           | não         | Filtro de entrega, retirada ou envio para casa                                                                                                                                               |
| `price_range`      | string           | não         | Filtro de faixa de preço                                                                                                                                                                     |
| `store_id`         | string           | não         | A loja cujo catálogo e preços são retornados                                                                                                                                                 |
| `output`           | array de strings | não         | Formatos a retornar: `markdown`, `html`, `json`, `screenshot`. Padrão `["html"]`. `json` retorna campos analisados. `screenshot` requer `run_js: true`                                       |
| `json`             | objeto           | não         | Extração personalizada: `{"prompt": string}` ou `{"schema": object}`, nunca ambos. Substitui o parser embutido                                                                               |
| `location`         | string           | não         | Código de país de duas letras para buscar, por exemplo `DE`                                                                                                                                  |
| `device`           | string           | não         | `desktop` (padrão) ou `mobile`                                                                                                                                                               |
| `run_js`           | booleano         | não         | Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 120 segundos ou mais                                                                              |
| `callback_url`     | string           | não         | URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com `400`                                                                                           |
| `storage`          | objeto           | não         | Entrega o resultado em um bucket em vez da resposta: `{"type": string, "url": string}`. `tipo` é `s3`, `s3_gzip`, `s3_compatible`, `gcs`, ou `tos`. Somente assíncrono. `url` não é validado |

***

### Fry's Food

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

Retorna campos extraídos de uma página do Fry's Food a partir de uma URL que você fornecer.

**Modos:** síncrono · assíncrono

| Nome               | Tipo             | Obrigatório | Descrição                                                                                                                                                                                    |
| ------------------ | ---------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `url`              | string           | sim         | Uma URL de produto ou de busca do Fry's Food                                                                                                                                                 |
| `delivery_zip`     | string           | não         | A entrega por CEP é cotada para                                                                                                                                                              |
| `fulfillment_type` | string           | não         | Filtro de entrega, retirada ou envio para casa                                                                                                                                               |
| `store_id`         | string           | não         | A loja cujo catálogo e preços são retornados                                                                                                                                                 |
| `output`           | array de strings | não         | Formatos a retornar: `markdown`, `html`, `json`, `screenshot`. Padrão `["html"]`. `json` retorna campos analisados. `screenshot` requer `run_js: true`                                       |
| `json`             | objeto           | não         | Extração personalizada: `{"prompt": string}` ou `{"schema": object}`, nunca ambos. Substitui o parser embutido                                                                               |
| `location`         | string           | não         | Código de país de duas letras para buscar, por exemplo `DE`                                                                                                                                  |
| `device`           | string           | não         | `desktop` (padrão) ou `mobile`                                                                                                                                                               |
| `run_js`           | booleano         | não         | Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 120 segundos ou mais                                                                              |
| `callback_url`     | string           | não         | URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com `400`                                                                                           |
| `storage`          | objeto           | não         | Entrega o resultado em um bucket em vez da resposta: `{"type": string, "url": string}`. `tipo` é `s3`, `s3_gzip`, `s3_compatible`, `gcs`, ou `tos`. Somente assíncrono. `url` não é validado |

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

Retorna o preço, o estoque e os detalhes de um produto do Fry's Food.

**Modos:** síncrono · assíncrono

| Nome               | Tipo             | Obrigatório | Descrição                                                                                                                                                                                    |
| ------------------ | ---------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`            | string           | sim         | ID do produto                                                                                                                                                                                |
| `delivery_zip`     | string           | não         | A entrega por CEP é cotada para                                                                                                                                                              |
| `fulfillment_type` | string           | não         | Filtro de entrega, retirada ou envio para casa                                                                                                                                               |
| `store_id`         | string           | não         | A loja cujo catálogo e preços são retornados                                                                                                                                                 |
| `output`           | array de strings | não         | Formatos a retornar: `markdown`, `html`, `json`, `screenshot`. Padrão `["html"]`. `json` retorna campos analisados. `screenshot` requer `run_js: true`                                       |
| `json`             | objeto           | não         | Extração personalizada: `{"prompt": string}` ou `{"schema": object}`, nunca ambos. Substitui o parser embutido                                                                               |
| `location`         | string           | não         | Código de país de duas letras para buscar, por exemplo `DE`                                                                                                                                  |
| `device`           | string           | não         | `desktop` (padrão) ou `mobile`                                                                                                                                                               |
| `run_js`           | booleano         | não         | Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 120 segundos ou mais                                                                              |
| `callback_url`     | string           | não         | URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com `400`                                                                                           |
| `storage`          | objeto           | não         | Entrega o resultado em um bucket em vez da resposta: `{"type": string, "url": string}`. `tipo` é `s3`, `s3_gzip`, `s3_compatible`, `gcs`, ou `tos`. Somente assíncrono. `url` não é validado |

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

Retorna resultados de busca do Fry's Food para uma palavra-chave.

**Modos:** síncrono · assíncrono

| Nome               | Tipo             | Obrigatório | Descrição                                                                                                                                                                                    |
| ------------------ | ---------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`            | string           | sim         | Palavra-chave de busca                                                                                                                                                                       |
| `brand`            | string           | não         | Restringe os resultados a uma marca                                                                                                                                                          |
| `delivery_zip`     | string           | não         | A entrega por CEP é cotada para                                                                                                                                                              |
| `fulfillment_type` | string           | não         | Filtro de entrega, retirada ou envio para casa                                                                                                                                               |
| `price_range`      | string           | não         | Filtro de faixa de preço                                                                                                                                                                     |
| `store_id`         | string           | não         | A loja cujo catálogo e preços são retornados                                                                                                                                                 |
| `output`           | array de strings | não         | Formatos a retornar: `markdown`, `html`, `json`, `screenshot`. Padrão `["html"]`. `json` retorna campos analisados. `screenshot` requer `run_js: true`                                       |
| `json`             | objeto           | não         | Extração personalizada: `{"prompt": string}` ou `{"schema": object}`, nunca ambos. Substitui o parser embutido                                                                               |
| `location`         | string           | não         | Código de país de duas letras para buscar, por exemplo `DE`                                                                                                                                  |
| `device`           | string           | não         | `desktop` (padrão) ou `mobile`                                                                                                                                                               |
| `run_js`           | booleano         | não         | Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 120 segundos ou mais                                                                              |
| `callback_url`     | string           | não         | URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com `400`                                                                                           |
| `storage`          | objeto           | não         | Entrega o resultado em um bucket em vez da resposta: `{"type": string, "url": string}`. `tipo` é `s3`, `s3_gzip`, `s3_compatible`, `gcs`, ou `tos`. Somente assíncrono. `url` não é validado |

***

### Gerbes

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

Retorna campos extraídos de uma página do Gerbes a partir de uma URL que você fornecer.

**Modos:** síncrono · assíncrono

| Nome               | Tipo             | Obrigatório | Descrição                                                                                                                                                                                    |
| ------------------ | ---------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `url`              | string           | sim         | Uma URL de produto ou de busca do Gerbes                                                                                                                                                     |
| `delivery_zip`     | string           | não         | A entrega por CEP é cotada para                                                                                                                                                              |
| `fulfillment_type` | string           | não         | Filtro de entrega, retirada ou envio para casa                                                                                                                                               |
| `store_id`         | string           | não         | A loja cujo catálogo e preços são retornados                                                                                                                                                 |
| `output`           | array de strings | não         | Formatos a retornar: `markdown`, `html`, `json`, `screenshot`. Padrão `["html"]`. `json` retorna campos analisados. `screenshot` requer `run_js: true`                                       |
| `json`             | objeto           | não         | Extração personalizada: `{"prompt": string}` ou `{"schema": object}`, nunca ambos. Substitui o parser embutido                                                                               |
| `location`         | string           | não         | Código de país de duas letras para buscar, por exemplo `DE`                                                                                                                                  |
| `device`           | string           | não         | `desktop` (padrão) ou `mobile`                                                                                                                                                               |
| `run_js`           | booleano         | não         | Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 120 segundos ou mais                                                                              |
| `callback_url`     | string           | não         | URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com `400`                                                                                           |
| `storage`          | objeto           | não         | Entrega o resultado em um bucket em vez da resposta: `{"type": string, "url": string}`. `tipo` é `s3`, `s3_gzip`, `s3_compatible`, `gcs`, ou `tos`. Somente assíncrono. `url` não é validado |

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

Retorna o preço, o estoque e os detalhes de um produto do Gerbes.

**Modos:** síncrono · assíncrono

| Nome               | Tipo             | Obrigatório | Descrição                                                                                                                                                                                    |
| ------------------ | ---------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`            | string           | sim         | ID do produto                                                                                                                                                                                |
| `delivery_zip`     | string           | não         | A entrega por CEP é cotada para                                                                                                                                                              |
| `fulfillment_type` | string           | não         | Filtro de entrega, retirada ou envio para casa                                                                                                                                               |
| `store_id`         | string           | não         | A loja cujo catálogo e preços são retornados                                                                                                                                                 |
| `output`           | array de strings | não         | Formatos a retornar: `markdown`, `html`, `json`, `screenshot`. Padrão `["html"]`. `json` retorna campos analisados. `screenshot` requer `run_js: true`                                       |
| `json`             | objeto           | não         | Extração personalizada: `{"prompt": string}` ou `{"schema": object}`, nunca ambos. Substitui o parser embutido                                                                               |
| `location`         | string           | não         | Código de país de duas letras para buscar, por exemplo `DE`                                                                                                                                  |
| `device`           | string           | não         | `desktop` (padrão) ou `mobile`                                                                                                                                                               |
| `run_js`           | booleano         | não         | Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 120 segundos ou mais                                                                              |
| `callback_url`     | string           | não         | URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com `400`                                                                                           |
| `storage`          | objeto           | não         | Entrega o resultado em um bucket em vez da resposta: `{"type": string, "url": string}`. `tipo` é `s3`, `s3_gzip`, `s3_compatible`, `gcs`, ou `tos`. Somente assíncrono. `url` não é validado |

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

Retorna resultados de busca do Gerbes para uma palavra-chave.

**Modos:** síncrono · assíncrono

| Nome               | Tipo             | Obrigatório | Descrição                                                                                                                                                                                    |
| ------------------ | ---------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`            | string           | sim         | Palavra-chave de busca                                                                                                                                                                       |
| `brand`            | string           | não         | Restringe os resultados a uma marca                                                                                                                                                          |
| `delivery_zip`     | string           | não         | A entrega por CEP é cotada para                                                                                                                                                              |
| `fulfillment_type` | string           | não         | Filtro de entrega, retirada ou envio para casa                                                                                                                                               |
| `price_range`      | string           | não         | Filtro de faixa de preço                                                                                                                                                                     |
| `store_id`         | string           | não         | A loja cujo catálogo e preços são retornados                                                                                                                                                 |
| `output`           | array de strings | não         | Formatos a retornar: `markdown`, `html`, `json`, `screenshot`. Padrão `["html"]`. `json` retorna campos analisados. `screenshot` requer `run_js: true`                                       |
| `json`             | objeto           | não         | Extração personalizada: `{"prompt": string}` ou `{"schema": object}`, nunca ambos. Substitui o parser embutido                                                                               |
| `location`         | string           | não         | Código de país de duas letras para buscar, por exemplo `DE`                                                                                                                                  |
| `device`           | string           | não         | `desktop` (padrão) ou `mobile`                                                                                                                                                               |
| `run_js`           | booleano         | não         | Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 120 segundos ou mais                                                                              |
| `callback_url`     | string           | não         | URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com `400`                                                                                           |
| `storage`          | objeto           | não         | Entrega o resultado em um bucket em vez da resposta: `{"type": string, "url": string}`. `tipo` é `s3`, `s3_gzip`, `s3_compatible`, `gcs`, ou `tos`. Somente assíncrono. `url` não é validado |

***

### Grainger

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

Retorna campos extraídos de uma página da Grainger a partir de uma URL que você fornecer.

**Modos:** síncrono · assíncrono

| Nome           | Tipo             | Obrigatório | Descrição                                                                                                                                                                                    |
| -------------- | ---------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `url`          | string           | sim         | Uma URL de produto ou de busca da Grainger                                                                                                                                                   |
| `output`       | array de strings | não         | Formatos a retornar: `markdown`, `html`, `json`, `screenshot`. Padrão `["html"]`. `json` retorna campos analisados. `screenshot` requer `run_js: true`                                       |
| `json`         | objeto           | não         | Extração personalizada: `{"prompt": string}` ou `{"schema": object}`, nunca ambos. Substitui o parser embutido                                                                               |
| `location`     | string           | não         | Código de país de duas letras para buscar, por exemplo `DE`                                                                                                                                  |
| `device`       | string           | não         | `desktop` (padrão) ou `mobile`                                                                                                                                                               |
| `run_js`       | booleano         | não         | Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 120 segundos ou mais                                                                              |
| `callback_url` | string           | não         | URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com `400`                                                                                           |
| `storage`      | objeto           | não         | Entrega o resultado em um bucket em vez da resposta: `{"type": string, "url": string}`. `tipo` é `s3`, `s3_gzip`, `s3_compatible`, `gcs`, ou `tos`. Somente assíncrono. `url` não é validado |

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

Retorna o preço, o estoque e os detalhes de um produto da Grainger.

**Modos:** síncrono · assíncrono

| Nome           | Tipo             | Obrigatório | Descrição                                                                                                                                                                                    |
| -------------- | ---------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`        | string           | sim         | ID do produto                                                                                                                                                                                |
| `domain`       | string           | não         | TLD da loja                                                                                                                                                                                  |
| `output`       | array de strings | não         | Formatos a retornar: `markdown`, `html`, `json`, `screenshot`. Padrão `["html"]`. `json` retorna campos analisados. `screenshot` requer `run_js: true`                                       |
| `json`         | objeto           | não         | Extração personalizada: `{"prompt": string}` ou `{"schema": object}`, nunca ambos. Substitui o parser embutido                                                                               |
| `location`     | string           | não         | Código de país de duas letras para buscar, por exemplo `DE`                                                                                                                                  |
| `device`       | string           | não         | `desktop` (padrão) ou `mobile`                                                                                                                                                               |
| `run_js`       | booleano         | não         | Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 120 segundos ou mais                                                                              |
| `callback_url` | string           | não         | URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com `400`                                                                                           |
| `storage`      | objeto           | não         | Entrega o resultado em um bucket em vez da resposta: `{"type": string, "url": string}`. `tipo` é `s3`, `s3_gzip`, `s3_compatible`, `gcs`, ou `tos`. Somente assíncrono. `url` não é validado |

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

Retorna resultados de busca da Grainger para uma palavra-chave.

**Modos:** síncrono · assíncrono

| Nome           | Tipo             | Obrigatório | Descrição                                                                                                                                                                                    |
| -------------- | ---------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`        | string           | sim         | Palavra-chave de busca                                                                                                                                                                       |
| `domain`       | string           | não         | TLD da loja                                                                                                                                                                                  |
| `output`       | array de strings | não         | Formatos a retornar: `markdown`, `html`, `json`, `screenshot`. Padrão `["html"]`. `json` retorna campos analisados. `screenshot` requer `run_js: true`                                       |
| `json`         | objeto           | não         | Extração personalizada: `{"prompt": string}` ou `{"schema": object}`, nunca ambos. Substitui o parser embutido                                                                               |
| `location`     | string           | não         | Código de país de duas letras para buscar, por exemplo `DE`                                                                                                                                  |
| `device`       | string           | não         | `desktop` (padrão) ou `mobile`                                                                                                                                                               |
| `run_js`       | booleano         | não         | Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 120 segundos ou mais                                                                              |
| `callback_url` | string           | não         | URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com `400`                                                                                           |
| `storage`      | objeto           | não         | Entrega o resultado em um bucket em vez da resposta: `{"type": string, "url": string}`. `tipo` é `s3`, `s3_gzip`, `s3_compatible`, `gcs`, ou `tos`. Somente assíncrono. `url` não é validado |

***

### Harris Teeter

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

Retorna campos extraídos de uma página do Harris Teeter a partir de uma URL que você fornecer.

**Modos:** síncrono · assíncrono

| Nome               | Tipo             | Obrigatório | Descrição                                                                                                                                                                                    |
| ------------------ | ---------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `url`              | string           | sim         | Uma URL de produto ou de busca do Harris Teeter                                                                                                                                              |
| `delivery_zip`     | string           | não         | A entrega por CEP é cotada para                                                                                                                                                              |
| `fulfillment_type` | string           | não         | Filtro de entrega, retirada ou envio para casa                                                                                                                                               |
| `store_id`         | string           | não         | A loja cujo catálogo e preços são retornados                                                                                                                                                 |
| `output`           | array de strings | não         | Formatos a retornar: `markdown`, `html`, `json`, `screenshot`. Padrão `["html"]`. `json` retorna campos analisados. `screenshot` requer `run_js: true`                                       |
| `json`             | objeto           | não         | Extração personalizada: `{"prompt": string}` ou `{"schema": object}`, nunca ambos. Substitui o parser embutido                                                                               |
| `location`         | string           | não         | Código de país de duas letras para buscar, por exemplo `DE`                                                                                                                                  |
| `device`           | string           | não         | `desktop` (padrão) ou `mobile`                                                                                                                                                               |
| `run_js`           | booleano         | não         | Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 120 segundos ou mais                                                                              |
| `callback_url`     | string           | não         | URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com `400`                                                                                           |
| `storage`          | objeto           | não         | Entrega o resultado em um bucket em vez da resposta: `{"type": string, "url": string}`. `tipo` é `s3`, `s3_gzip`, `s3_compatible`, `gcs`, ou `tos`. Somente assíncrono. `url` não é validado |

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

Retorna o preço, o estoque e os detalhes de um produto do Harris Teeter.

**Modos:** síncrono · assíncrono

| Nome               | Tipo             | Obrigatório | Descrição                                                                                                                                                                                    |
| ------------------ | ---------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`            | string           | sim         | ID do produto                                                                                                                                                                                |
| `delivery_zip`     | string           | não         | A entrega por CEP é cotada para                                                                                                                                                              |
| `fulfillment_type` | string           | não         | Filtro de entrega, retirada ou envio para casa                                                                                                                                               |
| `store_id`         | string           | não         | A loja cujo catálogo e preços são retornados                                                                                                                                                 |
| `output`           | array de strings | não         | Formatos a retornar: `markdown`, `html`, `json`, `screenshot`. Padrão `["html"]`. `json` retorna campos analisados. `screenshot` requer `run_js: true`                                       |
| `json`             | objeto           | não         | Extração personalizada: `{"prompt": string}` ou `{"schema": object}`, nunca ambos. Substitui o parser embutido                                                                               |
| `location`         | string           | não         | Código de país de duas letras para buscar, por exemplo `DE`                                                                                                                                  |
| `device`           | string           | não         | `desktop` (padrão) ou `mobile`                                                                                                                                                               |
| `run_js`           | booleano         | não         | Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 120 segundos ou mais                                                                              |
| `callback_url`     | string           | não         | URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com `400`                                                                                           |
| `storage`          | objeto           | não         | Entrega o resultado em um bucket em vez da resposta: `{"type": string, "url": string}`. `tipo` é `s3`, `s3_gzip`, `s3_compatible`, `gcs`, ou `tos`. Somente assíncrono. `url` não é validado |

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

Retorna resultados de busca do Harris Teeter para uma palavra-chave.

**Modos:** síncrono · assíncrono

| Nome               | Tipo             | Obrigatório | Descrição                                                                                                                                                                                    |
| ------------------ | ---------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`            | string           | sim         | Palavra-chave de busca                                                                                                                                                                       |
| `brand`            | string           | não         | Restringe os resultados a uma marca                                                                                                                                                          |
| `delivery_zip`     | string           | não         | A entrega por CEP é cotada para                                                                                                                                                              |
| `fulfillment_type` | string           | não         | Filtro de entrega, retirada ou envio para casa                                                                                                                                               |
| `price_range`      | string           | não         | Filtro de faixa de preço                                                                                                                                                                     |
| `store_id`         | string           | não         | A loja cujo catálogo e preços são retornados                                                                                                                                                 |
| `output`           | array de strings | não         | Formatos a retornar: `markdown`, `html`, `json`, `screenshot`. Padrão `["html"]`. `json` retorna campos analisados. `screenshot` requer `run_js: true`                                       |
| `json`             | objeto           | não         | Extração personalizada: `{"prompt": string}` ou `{"schema": object}`, nunca ambos. Substitui o parser embutido                                                                               |
| `location`         | string           | não         | Código de país de duas letras para buscar, por exemplo `DE`                                                                                                                                  |
| `device`           | string           | não         | `desktop` (padrão) ou `mobile`                                                                                                                                                               |
| `run_js`           | booleano         | não         | Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 120 segundos ou mais                                                                              |
| `callback_url`     | string           | não         | URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com `400`                                                                                           |
| `storage`          | objeto           | não         | Entrega o resultado em um bucket em vez da resposta: `{"type": string, "url": string}`. `tipo` é `s3`, `s3_gzip`, `s3_compatible`, `gcs`, ou `tos`. Somente assíncrono. `url` não é validado |

***

### Idealo

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

Retorna resultados de busca do Idealo para uma palavra-chave.

**Modos:** síncrono · assíncrono

| Nome           | Tipo             | Obrigatório | Descrição                                                                                                                                                                                    |
| -------------- | ---------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`        | string           | sim         | Palavra-chave de busca                                                                                                                                                                       |
| `domain`       | string           | não         | TLD da loja                                                                                                                                                                                  |
| `output`       | array de strings | não         | Formatos a retornar: `markdown`, `html`, `json`, `screenshot`. Padrão `["html"]`. `json` retorna campos analisados. `screenshot` requer `run_js: true`                                       |
| `json`         | objeto           | não         | Extração personalizada: `{"prompt": string}` ou `{"schema": object}`, nunca ambos. Substitui o parser embutido                                                                               |
| `location`     | string           | não         | Código de país de duas letras para buscar, por exemplo `DE`                                                                                                                                  |
| `device`       | string           | não         | `desktop` (padrão) ou `mobile`                                                                                                                                                               |
| `run_js`       | booleano         | não         | Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 120 segundos ou mais                                                                              |
| `callback_url` | string           | não         | URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com `400`                                                                                           |
| `storage`      | objeto           | não         | Entrega o resultado em um bucket em vez da resposta: `{"type": string, "url": string}`. `tipo` é `s3`, `s3_gzip`, `s3_compatible`, `gcs`, ou `tos`. Somente assíncrono. `url` não é validado |

***

### Indiamart

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

Retorna campos extraídos de uma página do Indiamart a partir de uma URL que você fornecer.

**Modos:** síncrono · assíncrono

| Nome           | Tipo             | Obrigatório | Descrição                                                                                                                                                                                    |
| -------------- | ---------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `url`          | string           | sim         | Uma URL de produto ou de busca do Indiamart                                                                                                                                                  |
| `output`       | array de strings | não         | Formatos a retornar: `markdown`, `html`, `json`, `screenshot`. Padrão `["html"]`. `json` retorna campos analisados. `screenshot` requer `run_js: true`                                       |
| `json`         | objeto           | não         | Extração personalizada: `{"prompt": string}` ou `{"schema": object}`, nunca ambos. Substitui o parser embutido                                                                               |
| `location`     | string           | não         | Código de país de duas letras para buscar, por exemplo `DE`                                                                                                                                  |
| `device`       | string           | não         | `desktop` (padrão) ou `mobile`                                                                                                                                                               |
| `run_js`       | booleano         | não         | Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 120 segundos ou mais                                                                              |
| `callback_url` | string           | não         | URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com `400`                                                                                           |
| `storage`      | objeto           | não         | Entrega o resultado em um bucket em vez da resposta: `{"type": string, "url": string}`. `tipo` é `s3`, `s3_gzip`, `s3_compatible`, `gcs`, ou `tos`. Somente assíncrono. `url` não é validado |

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

Retorna o preço, o estoque e os detalhes de um produto do Indiamart.

**Modos:** síncrono · assíncrono

| Nome           | Tipo             | Obrigatório | Descrição                                                                                                                                                                                    |
| -------------- | ---------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`        | string           | sim         | ID do produto                                                                                                                                                                                |
| `domain`       | string           | não         | TLD da loja                                                                                                                                                                                  |
| `output`       | array de strings | não         | Formatos a retornar: `markdown`, `html`, `json`, `screenshot`. Padrão `["html"]`. `json` retorna campos analisados. `screenshot` requer `run_js: true`                                       |
| `json`         | objeto           | não         | Extração personalizada: `{"prompt": string}` ou `{"schema": object}`, nunca ambos. Substitui o parser embutido                                                                               |
| `location`     | string           | não         | Código de país de duas letras para buscar, por exemplo `DE`                                                                                                                                  |
| `device`       | string           | não         | `desktop` (padrão) ou `mobile`                                                                                                                                                               |
| `run_js`       | booleano         | não         | Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 120 segundos ou mais                                                                              |
| `callback_url` | string           | não         | URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com `400`                                                                                           |
| `storage`      | objeto           | não         | Entrega o resultado em um bucket em vez da resposta: `{"type": string, "url": string}`. `tipo` é `s3`, `s3_gzip`, `s3_compatible`, `gcs`, ou `tos`. Somente assíncrono. `url` não é validado |

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

Retorna resultados de busca do Indiamart para uma palavra-chave.

**Modos:** síncrono · assíncrono

| Nome           | Tipo             | Obrigatório | Descrição                                                                                                                                                                                    |
| -------------- | ---------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`        | string           | sim         | Palavra-chave de busca                                                                                                                                                                       |
| `domain`       | string           | não         | TLD da loja                                                                                                                                                                                  |
| `output`       | array de strings | não         | Formatos a retornar: `markdown`, `html`, `json`, `screenshot`. Padrão `["html"]`. `json` retorna campos analisados. `screenshot` requer `run_js: true`                                       |
| `json`         | objeto           | não         | Extração personalizada: `{"prompt": string}` ou `{"schema": object}`, nunca ambos. Substitui o parser embutido                                                                               |
| `location`     | string           | não         | Código de país de duas letras para buscar, por exemplo `DE`                                                                                                                                  |
| `device`       | string           | não         | `desktop` (padrão) ou `mobile`                                                                                                                                                               |
| `run_js`       | booleano         | não         | Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 120 segundos ou mais                                                                              |
| `callback_url` | string           | não         | URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com `400`                                                                                           |
| `storage`      | objeto           | não         | Entrega o resultado em um bucket em vez da resposta: `{"type": string, "url": string}`. `tipo` é `s3`, `s3_gzip`, `s3_compatible`, `gcs`, ou `tos`. Somente assíncrono. `url` não é validado |

***

### Instacart

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

Retorna campos extraídos de uma página do Instacart a partir de uma URL que você fornecer.

**Modos:** síncrono · assíncrono

| Nome           | Tipo             | Obrigatório | Descrição                                                                                                                                                                                    |
| -------------- | ---------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `url`          | string           | sim         | Uma URL de produto ou de busca do Instacart                                                                                                                                                  |
| `output`       | array de strings | não         | Formatos a retornar: `markdown`, `html`, `json`, `screenshot`. Padrão `["html"]`. `json` retorna campos analisados. `screenshot` requer `run_js: true`                                       |
| `json`         | objeto           | não         | Extração personalizada: `{"prompt": string}` ou `{"schema": object}`, nunca ambos. Substitui o parser embutido                                                                               |
| `location`     | string           | não         | Código de país de duas letras para buscar, por exemplo `DE`                                                                                                                                  |
| `device`       | string           | não         | `desktop` (padrão) ou `mobile`                                                                                                                                                               |
| `run_js`       | booleano         | não         | Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 120 segundos ou mais                                                                              |
| `callback_url` | string           | não         | URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com `400`                                                                                           |
| `storage`      | objeto           | não         | Entrega o resultado em um bucket em vez da resposta: `{"type": string, "url": string}`. `tipo` é `s3`, `s3_gzip`, `s3_compatible`, `gcs`, ou `tos`. Somente assíncrono. `url` não é validado |

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

Retorna o preço, o estoque e os detalhes de um produto do Instacart.

**Modos:** síncrono · assíncrono

| Nome           | Tipo             | Obrigatório | Descrição                                                                                                                                                                                    |
| -------------- | ---------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`        | string           | sim         | ID do produto                                                                                                                                                                                |
| `domain`       | string           | não         | TLD da loja                                                                                                                                                                                  |
| `output`       | array de strings | não         | Formatos a retornar: `markdown`, `html`, `json`, `screenshot`. Padrão `["html"]`. `json` retorna campos analisados. `screenshot` requer `run_js: true`                                       |
| `json`         | objeto           | não         | Extração personalizada: `{"prompt": string}` ou `{"schema": object}`, nunca ambos. Substitui o parser embutido                                                                               |
| `location`     | string           | não         | Código de país de duas letras para buscar, por exemplo `DE`                                                                                                                                  |
| `device`       | string           | não         | `desktop` (padrão) ou `mobile`                                                                                                                                                               |
| `run_js`       | booleano         | não         | Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 120 segundos ou mais                                                                              |
| `callback_url` | string           | não         | URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com `400`                                                                                           |
| `storage`      | objeto           | não         | Entrega o resultado em um bucket em vez da resposta: `{"type": string, "url": string}`. `tipo` é `s3`, `s3_gzip`, `s3_compatible`, `gcs`, ou `tos`. Somente assíncrono. `url` não é validado |

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

Retorna resultados de busca do Instacart para uma palavra-chave.

**Modos:** síncrono · assíncrono

| Nome           | Tipo             | Obrigatório | Descrição                                                                                                                                                                                    |
| -------------- | ---------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`        | string           | sim         | Palavra-chave de busca                                                                                                                                                                       |
| `domain`       | string           | não         | TLD da loja                                                                                                                                                                                  |
| `output`       | array de strings | não         | Formatos a retornar: `markdown`, `html`, `json`, `screenshot`. Padrão `["html"]`. `json` retorna campos analisados. `screenshot` requer `run_js: true`                                       |
| `json`         | objeto           | não         | Extração personalizada: `{"prompt": string}` ou `{"schema": object}`, nunca ambos. Substitui o parser embutido                                                                               |
| `location`     | string           | não         | Código de país de duas letras para buscar, por exemplo `DE`                                                                                                                                  |
| `device`       | string           | não         | `desktop` (padrão) ou `mobile`                                                                                                                                                               |
| `run_js`       | booleano         | não         | Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 120 segundos ou mais                                                                              |
| `callback_url` | string           | não         | URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com `400`                                                                                           |
| `storage`      | objeto           | não         | Entrega o resultado em um bucket em vez da resposta: `{"type": string, "url": string}`. `tipo` é `s3`, `s3_gzip`, `s3_compatible`, `gcs`, ou `tos`. Somente assíncrono. `url` não é validado |

***

### King Soopers

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

Retorna campos extraídos de uma página do King Soopers a partir de uma URL que você fornecer.

**Modos:** síncrono · assíncrono

| Nome               | Tipo             | Obrigatório | Descrição                                                                                                                                                                                    |
| ------------------ | ---------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `url`              | string           | sim         | Uma URL de produto ou de busca do King Soopers                                                                                                                                               |
| `delivery_zip`     | string           | não         | A entrega por CEP é cotada para                                                                                                                                                              |
| `fulfillment_type` | string           | não         | Filtro de entrega, retirada ou envio para casa                                                                                                                                               |
| `store_id`         | string           | não         | A loja cujo catálogo e preços são retornados                                                                                                                                                 |
| `output`           | array de strings | não         | Formatos a retornar: `markdown`, `html`, `json`, `screenshot`. Padrão `["html"]`. `json` retorna campos analisados. `screenshot` requer `run_js: true`                                       |
| `json`             | objeto           | não         | Extração personalizada: `{"prompt": string}` ou `{"schema": object}`, nunca ambos. Substitui o parser embutido                                                                               |
| `location`         | string           | não         | Código de país de duas letras para buscar, por exemplo `DE`                                                                                                                                  |
| `device`           | string           | não         | `desktop` (padrão) ou `mobile`                                                                                                                                                               |
| `run_js`           | booleano         | não         | Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 120 segundos ou mais                                                                              |
| `callback_url`     | string           | não         | URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com `400`                                                                                           |
| `storage`          | objeto           | não         | Entrega o resultado em um bucket em vez da resposta: `{"type": string, "url": string}`. `tipo` é `s3`, `s3_gzip`, `s3_compatible`, `gcs`, ou `tos`. Somente assíncrono. `url` não é validado |

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

Retorna o preço, o estoque e os detalhes de um produto do King Soopers.

**Modos:** síncrono · assíncrono

| Nome               | Tipo             | Obrigatório | Descrição                                                                                                                                                                                    |
| ------------------ | ---------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`            | string           | sim         | ID do produto                                                                                                                                                                                |
| `delivery_zip`     | string           | não         | A entrega por CEP é cotada para                                                                                                                                                              |
| `fulfillment_type` | string           | não         | Filtro de entrega, retirada ou envio para casa                                                                                                                                               |
| `store_id`         | string           | não         | A loja cujo catálogo e preços são retornados                                                                                                                                                 |
| `output`           | array de strings | não         | Formatos a retornar: `markdown`, `html`, `json`, `screenshot`. Padrão `["html"]`. `json` retorna campos analisados. `screenshot` requer `run_js: true`                                       |
| `json`             | objeto           | não         | Extração personalizada: `{"prompt": string}` ou `{"schema": object}`, nunca ambos. Substitui o parser embutido                                                                               |
| `location`         | string           | não         | Código de país de duas letras para buscar, por exemplo `DE`                                                                                                                                  |
| `device`           | string           | não         | `desktop` (padrão) ou `mobile`                                                                                                                                                               |
| `run_js`           | booleano         | não         | Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 120 segundos ou mais                                                                              |
| `callback_url`     | string           | não         | URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com `400`                                                                                           |
| `storage`          | objeto           | não         | Entrega o resultado em um bucket em vez da resposta: `{"type": string, "url": string}`. `tipo` é `s3`, `s3_gzip`, `s3_compatible`, `gcs`, ou `tos`. Somente assíncrono. `url` não é validado |

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

Retorna resultados de busca do King Soopers para uma palavra-chave.

**Modos:** síncrono · assíncrono

| Nome               | Tipo             | Obrigatório | Descrição                                                                                                                                                                                    |
| ------------------ | ---------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`            | string           | sim         | Palavra-chave de busca                                                                                                                                                                       |
| `brand`            | string           | não         | Restringe os resultados a uma marca                                                                                                                                                          |
| `delivery_zip`     | string           | não         | A entrega por CEP é cotada para                                                                                                                                                              |
| `fulfillment_type` | string           | não         | Filtro de entrega, retirada ou envio para casa                                                                                                                                               |
| `price_range`      | string           | não         | Filtro de faixa de preço                                                                                                                                                                     |
| `store_id`         | string           | não         | A loja cujo catálogo e preços são retornados                                                                                                                                                 |
| `output`           | array de strings | não         | Formatos a retornar: `markdown`, `html`, `json`, `screenshot`. Padrão `["html"]`. `json` retorna campos analisados. `screenshot` requer `run_js: true`                                       |
| `json`             | objeto           | não         | Extração personalizada: `{"prompt": string}` ou `{"schema": object}`, nunca ambos. Substitui o parser embutido                                                                               |
| `location`         | string           | não         | Código de país de duas letras para buscar, por exemplo `DE`                                                                                                                                  |
| `device`           | string           | não         | `desktop` (padrão) ou `mobile`                                                                                                                                                               |
| `run_js`           | booleano         | não         | Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 120 segundos ou mais                                                                              |
| `callback_url`     | string           | não         | URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com `400`                                                                                           |
| `storage`          | objeto           | não         | Entrega o resultado em um bucket em vez da resposta: `{"type": string, "url": string}`. `tipo` é `s3`, `s3_gzip`, `s3_compatible`, `gcs`, ou `tos`. Somente assíncrono. `url` não é validado |

***

### Kroger

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

Retorna campos extraídos de uma página do Kroger a partir de uma URL que você fornecer.

**Modos:** síncrono · assíncrono

| Nome               | Tipo             | Obrigatório | Descrição                                                                                                                                                                                    |
| ------------------ | ---------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `url`              | string           | sim         | Uma URL de produto ou de busca do Kroger                                                                                                                                                     |
| `delivery_zip`     | string           | não         | A entrega por CEP é cotada para                                                                                                                                                              |
| `fulfillment_type` | string           | não         | Filtro de entrega, retirada ou envio para casa                                                                                                                                               |
| `store_id`         | string           | não         | A loja cujo catálogo e preços são retornados                                                                                                                                                 |
| `output`           | array de strings | não         | Formatos a retornar: `markdown`, `html`, `json`, `screenshot`. Padrão `["html"]`. `json` retorna campos analisados. `screenshot` requer `run_js: true`                                       |
| `json`             | objeto           | não         | Extração personalizada: `{"prompt": string}` ou `{"schema": object}`, nunca ambos. Substitui o parser embutido                                                                               |
| `location`         | string           | não         | Código de país de duas letras para buscar, por exemplo `DE`                                                                                                                                  |
| `device`           | string           | não         | `desktop` (padrão) ou `mobile`                                                                                                                                                               |
| `run_js`           | booleano         | não         | Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 120 segundos ou mais                                                                              |
| `callback_url`     | string           | não         | URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com `400`                                                                                           |
| `storage`          | objeto           | não         | Entrega o resultado em um bucket em vez da resposta: `{"type": string, "url": string}`. `tipo` é `s3`, `s3_gzip`, `s3_compatible`, `gcs`, ou `tos`. Somente assíncrono. `url` não é validado |

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

Retorna o preço, o estoque e os detalhes de um produto do Kroger.

**Modos:** síncrono · assíncrono

| Nome               | Tipo             | Obrigatório | Descrição                                                                                                                                                                                    |
| ------------------ | ---------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`            | string           | sim         | ID do produto                                                                                                                                                                                |
| `delivery_zip`     | string           | não         | A entrega por CEP é cotada para                                                                                                                                                              |
| `fulfillment_type` | string           | não         | Filtro de entrega, retirada ou envio para casa                                                                                                                                               |
| `store_id`         | string           | não         | A loja cujo catálogo e preços são retornados                                                                                                                                                 |
| `output`           | array de strings | não         | Formatos a retornar: `markdown`, `html`, `json`, `screenshot`. Padrão `["html"]`. `json` retorna campos analisados. `screenshot` requer `run_js: true`                                       |
| `json`             | objeto           | não         | Extração personalizada: `{"prompt": string}` ou `{"schema": object}`, nunca ambos. Substitui o parser embutido                                                                               |
| `location`         | string           | não         | Código de país de duas letras para buscar, por exemplo `DE`                                                                                                                                  |
| `device`           | string           | não         | `desktop` (padrão) ou `mobile`                                                                                                                                                               |
| `run_js`           | booleano         | não         | Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 120 segundos ou mais                                                                              |
| `callback_url`     | string           | não         | URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com `400`                                                                                           |
| `storage`          | objeto           | não         | Entrega o resultado em um bucket em vez da resposta: `{"type": string, "url": string}`. `tipo` é `s3`, `s3_gzip`, `s3_compatible`, `gcs`, ou `tos`. Somente assíncrono. `url` não é validado |

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

Retorna resultados de busca do Kroger para uma palavra-chave.

**Modos:** síncrono · assíncrono

| Nome               | Tipo             | Obrigatório | Descrição                                                                                                                                                                                    |
| ------------------ | ---------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`            | string           | sim         | Palavra-chave de busca                                                                                                                                                                       |
| `brand`            | string           | não         | Restringe os resultados a uma marca                                                                                                                                                          |
| `delivery_zip`     | string           | não         | A entrega por CEP é cotada para                                                                                                                                                              |
| `fulfillment_type` | string           | não         | Filtro de entrega, retirada ou envio para casa                                                                                                                                               |
| `price_range`      | string           | não         | Filtro de faixa de preço                                                                                                                                                                     |
| `store_id`         | string           | não         | A loja cujo catálogo e preços são retornados                                                                                                                                                 |
| `output`           | array de strings | não         | Formatos a retornar: `markdown`, `html`, `json`, `screenshot`. Padrão `["html"]`. `json` retorna campos analisados. `screenshot` requer `run_js: true`                                       |
| `json`             | objeto           | não         | Extração personalizada: `{"prompt": string}` ou `{"schema": object}`, nunca ambos. Substitui o parser embutido                                                                               |
| `location`         | string           | não         | Código de país de duas letras para buscar, por exemplo `DE`                                                                                                                                  |
| `device`           | string           | não         | `desktop` (padrão) ou `mobile`                                                                                                                                                               |
| `run_js`           | booleano         | não         | Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 120 segundos ou mais                                                                              |
| `callback_url`     | string           | não         | URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com `400`                                                                                           |
| `storage`          | objeto           | não         | Entrega o resultado em um bucket em vez da resposta: `{"type": string, "url": string}`. `tipo` é `s3`, `s3_gzip`, `s3_compatible`, `gcs`, ou `tos`. Somente assíncrono. `url` não é validado |

***

### Lazada

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

Retorna campos extraídos de uma página da Lazada a partir de uma URL que você fornecer.

**Modos:** síncrono · assíncrono

| Nome           | Tipo             | Obrigatório | Descrição                                                                                                                                                                                    |
| -------------- | ---------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `url`          | string           | sim         | Uma URL de produto ou de busca da Lazada                                                                                                                                                     |
| `start_page`   | inteiro          | não         | Primeira página de resultados                                                                                                                                                                |
| `output`       | array de strings | não         | Formatos a retornar: `markdown`, `html`, `json`, `screenshot`. Padrão `["html"]`. `json` retorna campos analisados. `screenshot` requer `run_js: true`                                       |
| `json`         | objeto           | não         | Extração personalizada: `{"prompt": string}` ou `{"schema": object}`, nunca ambos. Substitui o parser embutido                                                                               |
| `location`     | string           | não         | Código de país de duas letras para buscar, por exemplo `DE`                                                                                                                                  |
| `device`       | string           | não         | `desktop` (padrão) ou `mobile`                                                                                                                                                               |
| `run_js`       | booleano         | não         | Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 120 segundos ou mais                                                                              |
| `callback_url` | string           | não         | URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com `400`                                                                                           |
| `storage`      | objeto           | não         | Entrega o resultado em um bucket em vez da resposta: `{"type": string, "url": string}`. `tipo` é `s3`, `s3_gzip`, `s3_compatible`, `gcs`, ou `tos`. Somente assíncrono. `url` não é validado |

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

Retorna o preço, o estoque e os detalhes de um produto da Lazada.

**Modos:** síncrono · assíncrono

| Nome           | Tipo             | Obrigatório | Descrição                                                                                                                                                                                    |
| -------------- | ---------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`        | string           | sim         | ID do produto                                                                                                                                                                                |
| `domain`       | string           | não         | TLD da loja                                                                                                                                                                                  |
| `output`       | array de strings | não         | Formatos a retornar: `markdown`, `html`, `json`, `screenshot`. Padrão `["html"]`. `json` retorna campos analisados. `screenshot` requer `run_js: true`                                       |
| `json`         | objeto           | não         | Extração personalizada: `{"prompt": string}` ou `{"schema": object}`, nunca ambos. Substitui o parser embutido                                                                               |
| `location`     | string           | não         | Código de país de duas letras para buscar, por exemplo `DE`                                                                                                                                  |
| `device`       | string           | não         | `desktop` (padrão) ou `mobile`                                                                                                                                                               |
| `run_js`       | booleano         | não         | Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 120 segundos ou mais                                                                              |
| `callback_url` | string           | não         | URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com `400`                                                                                           |
| `storage`      | objeto           | não         | Entrega o resultado em um bucket em vez da resposta: `{"type": string, "url": string}`. `tipo` é `s3`, `s3_gzip`, `s3_compatible`, `gcs`, ou `tos`. Somente assíncrono. `url` não é validado |

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

Retorna resultados de busca da Lazada para uma palavra-chave.

**Modos:** síncrono · assíncrono

| Nome           | Tipo             | Obrigatório | Descrição                                                                                                                                                                                    |
| -------------- | ---------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`        | string           | sim         | Palavra-chave de busca                                                                                                                                                                       |
| `domain`       | string           | não         | TLD da loja                                                                                                                                                                                  |
| `start_page`   | inteiro          | não         | Primeira página de resultados                                                                                                                                                                |
| `output`       | array de strings | não         | Formatos a retornar: `markdown`, `html`, `json`, `screenshot`. Padrão `["html"]`. `json` retorna campos analisados. `screenshot` requer `run_js: true`                                       |
| `json`         | objeto           | não         | Extração personalizada: `{"prompt": string}` ou `{"schema": object}`, nunca ambos. Substitui o parser embutido                                                                               |
| `location`     | string           | não         | Código de país de duas letras para buscar, por exemplo `DE`                                                                                                                                  |
| `device`       | string           | não         | `desktop` (padrão) ou `mobile`                                                                                                                                                               |
| `run_js`       | booleano         | não         | Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 120 segundos ou mais                                                                              |
| `callback_url` | string           | não         | URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com `400`                                                                                           |
| `storage`      | objeto           | não         | Entrega o resultado em um bucket em vez da resposta: `{"type": string, "url": string}`. `tipo` é `s3`, `s3_gzip`, `s3_compatible`, `gcs`, ou `tos`. Somente assíncrono. `url` não é validado |

***

### Lowe's

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

Retorna campos extraídos de uma página da Lowe's a partir de uma URL que você fornecer.

**Modos:** síncrono · assíncrono

| Nome           | Tipo             | Obrigatório | Descrição                                                                                                                                                                                    |
| -------------- | ---------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `url`          | string           | sim         | Uma URL de produto ou de busca da Lowe's                                                                                                                                                     |
| `delivery_zip` | string           | não         | A entrega por CEP é cotada para                                                                                                                                                              |
| `store_id`     | string           | não         | A loja cujo catálogo e preços são retornados                                                                                                                                                 |
| `output`       | array de strings | não         | Formatos a retornar: `markdown`, `html`, `json`, `screenshot`. Padrão `["html"]`. `json` retorna campos analisados. `screenshot` requer `run_js: true`                                       |
| `json`         | objeto           | não         | Extração personalizada: `{"prompt": string}` ou `{"schema": object}`, nunca ambos. Substitui o parser embutido                                                                               |
| `location`     | string           | não         | Código de país de duas letras para buscar, por exemplo `DE`                                                                                                                                  |
| `device`       | string           | não         | `desktop` (padrão) ou `mobile`                                                                                                                                                               |
| `run_js`       | booleano         | não         | Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 120 segundos ou mais                                                                              |
| `callback_url` | string           | não         | URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com `400`                                                                                           |
| `storage`      | objeto           | não         | Entrega o resultado em um bucket em vez da resposta: `{"type": string, "url": string}`. `tipo` é `s3`, `s3_gzip`, `s3_compatible`, `gcs`, ou `tos`. Somente assíncrono. `url` não é validado |

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

Retorna o preço, o estoque e os detalhes de um produto da Lowe's.

**Modos:** síncrono · assíncrono

| Nome           | Tipo             | Obrigatório | Descrição                                                                                                                                                                                    |
| -------------- | ---------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`        | string           | sim         | ID do produto                                                                                                                                                                                |
| `delivery_zip` | string           | não         | A entrega por CEP é cotada para                                                                                                                                                              |
| `store_id`     | string           | não         | A loja cujo catálogo e preços são retornados                                                                                                                                                 |
| `output`       | array de strings | não         | Formatos a retornar: `markdown`, `html`, `json`, `screenshot`. Padrão `["html"]`. `json` retorna campos analisados. `screenshot` requer `run_js: true`                                       |
| `json`         | objeto           | não         | Extração personalizada: `{"prompt": string}` ou `{"schema": object}`, nunca ambos. Substitui o parser embutido                                                                               |
| `location`     | string           | não         | Código de país de duas letras para buscar, por exemplo `DE`                                                                                                                                  |
| `device`       | string           | não         | `desktop` (padrão) ou `mobile`                                                                                                                                                               |
| `run_js`       | booleano         | não         | Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 120 segundos ou mais                                                                              |
| `callback_url` | string           | não         | URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com `400`                                                                                           |
| `storage`      | objeto           | não         | Entrega o resultado em um bucket em vez da resposta: `{"type": string, "url": string}`. `tipo` é `s3`, `s3_gzip`, `s3_compatible`, `gcs`, ou `tos`. Somente assíncrono. `url` não é validado |

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

Retorna resultados de busca da Lowe's para uma palavra-chave.

**Modos:** síncrono · assíncrono

| Nome                      | Tipo             | Obrigatório | Descrição                                                                                                                                                                                    |
| ------------------------- | ---------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`                   | string           | sim         | Palavra-chave de busca                                                                                                                                                                       |
| `delivery_today_tomorrow` | booleano         | não         | Somente itens que podem ser entregues hoje ou amanhã                                                                                                                                         |
| `delivery_zip`            | string           | não         | A entrega por CEP é cotada para                                                                                                                                                              |
| `domain`                  | string           | não         | TLD da loja                                                                                                                                                                                  |
| `free_delivery`           | booleano         | não         | Somente itens elegíveis para entrega gratuita                                                                                                                                                |
| `pickup_today`            | booleano         | não         | Somente itens disponíveis para retirada hoje                                                                                                                                                 |
| `store_id`                | string           | não         | A loja cujo catálogo e preços são retornados                                                                                                                                                 |
| `output`                  | array de strings | não         | Formatos a retornar: `markdown`, `html`, `json`, `screenshot`. Padrão `["html"]`. `json` retorna campos analisados. `screenshot` requer `run_js: true`                                       |
| `json`                    | objeto           | não         | Extração personalizada: `{"prompt": string}` ou `{"schema": object}`, nunca ambos. Substitui o parser embutido                                                                               |
| `location`                | string           | não         | Código de país de duas letras para buscar, por exemplo `DE`                                                                                                                                  |
| `device`                  | string           | não         | `desktop` (padrão) ou `mobile`                                                                                                                                                               |
| `run_js`                  | booleano         | não         | Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 120 segundos ou mais                                                                              |
| `callback_url`            | string           | não         | URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com `400`                                                                                           |
| `storage`                 | objeto           | não         | Entrega o resultado em um bucket em vez da resposta: `{"type": string, "url": string}`. `tipo` é `s3`, `s3_gzip`, `s3_compatible`, `gcs`, ou `tos`. Somente assíncrono. `url` não é validado |

`pickup_today` é um filtro de disponibilidade: ele altera quais produtos são retornados, não apenas como são exibidos.

***

### Magazine Luiza

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

Retorna campos extraídos de uma página da Magazine Luiza a partir de uma URL que você fornecer.

**Modos:** síncrono · assíncrono

| Nome           | Tipo             | Obrigatório | Descrição                                                                                                                                                                                    |
| -------------- | ---------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `url`          | string           | sim         | Uma URL de produto ou de busca da Magazine Luiza                                                                                                                                             |
| `output`       | array de strings | não         | Formatos a retornar: `markdown`, `html`, `json`, `screenshot`. Padrão `["html"]`. `json` retorna campos analisados. `screenshot` requer `run_js: true`                                       |
| `json`         | objeto           | não         | Extração personalizada: `{"prompt": string}` ou `{"schema": object}`, nunca ambos. Substitui o parser embutido                                                                               |
| `location`     | string           | não         | Código de país de duas letras para buscar, por exemplo `DE`                                                                                                                                  |
| `device`       | string           | não         | `desktop` (padrão) ou `mobile`                                                                                                                                                               |
| `run_js`       | booleano         | não         | Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 120 segundos ou mais                                                                              |
| `callback_url` | string           | não         | URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com `400`                                                                                           |
| `storage`      | objeto           | não         | Entrega o resultado em um bucket em vez da resposta: `{"type": string, "url": string}`. `tipo` é `s3`, `s3_gzip`, `s3_compatible`, `gcs`, ou `tos`. Somente assíncrono. `url` não é validado |

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

Retorna o preço, o estoque e os detalhes de um produto da Magazine Luiza.

**Modos:** síncrono · assíncrono

| Nome           | Tipo             | Obrigatório | Descrição                                                                                                                                                                                    |
| -------------- | ---------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`        | string           | sim         | ID do produto                                                                                                                                                                                |
| `domain`       | string           | não         | TLD da loja                                                                                                                                                                                  |
| `output`       | array de strings | não         | Formatos a retornar: `markdown`, `html`, `json`, `screenshot`. Padrão `["html"]`. `json` retorna campos analisados. `screenshot` requer `run_js: true`                                       |
| `json`         | objeto           | não         | Extração personalizada: `{"prompt": string}` ou `{"schema": object}`, nunca ambos. Substitui o parser embutido                                                                               |
| `location`     | string           | não         | Código de país de duas letras para buscar, por exemplo `DE`                                                                                                                                  |
| `device`       | string           | não         | `desktop` (padrão) ou `mobile`                                                                                                                                                               |
| `run_js`       | booleano         | não         | Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 120 segundos ou mais                                                                              |
| `callback_url` | string           | não         | URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com `400`                                                                                           |
| `storage`      | objeto           | não         | Entrega o resultado em um bucket em vez da resposta: `{"type": string, "url": string}`. `tipo` é `s3`, `s3_gzip`, `s3_compatible`, `gcs`, ou `tos`. Somente assíncrono. `url` não é validado |

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

Retorna resultados de busca da Magazine Luiza para uma palavra-chave.

**Modos:** síncrono · assíncrono

| Nome           | Tipo             | Obrigatório | Descrição                                                                                                                                                                                    |
| -------------- | ---------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`        | string           | sim         | Palavra-chave de busca                                                                                                                                                                       |
| `domain`       | string           | não         | TLD da loja                                                                                                                                                                                  |
| `start_page`   | inteiro          | não         | Primeira página de resultados                                                                                                                                                                |
| `output`       | array de strings | não         | Formatos a retornar: `markdown`, `html`, `json`, `screenshot`. Padrão `["html"]`. `json` retorna campos analisados. `screenshot` requer `run_js: true`                                       |
| `json`         | objeto           | não         | Extração personalizada: `{"prompt": string}` ou `{"schema": object}`, nunca ambos. Substitui o parser embutido                                                                               |
| `location`     | string           | não         | Código de país de duas letras para buscar, por exemplo `DE`                                                                                                                                  |
| `device`       | string           | não         | `desktop` (padrão) ou `mobile`                                                                                                                                                               |
| `run_js`       | booleano         | não         | Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 120 segundos ou mais                                                                              |
| `callback_url` | string           | não         | URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com `400`                                                                                           |
| `storage`      | objeto           | não         | Entrega o resultado em um bucket em vez da resposta: `{"type": string, "url": string}`. `tipo` é `s3`, `s3_gzip`, `s3_compatible`, `gcs`, ou `tos`. Somente assíncrono. `url` não é validado |

***

### Mariano's

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

Retorna campos extraídos de uma página do Mariano's a partir de uma URL que você fornecer.

**Modos:** síncrono · assíncrono

| Nome               | Tipo             | Obrigatório | Descrição                                                                                                                                                                                    |
| ------------------ | ---------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `url`              | string           | sim         | Uma URL de produto ou de busca do Mariano's                                                                                                                                                  |
| `delivery_zip`     | string           | não         | A entrega por CEP é cotada para                                                                                                                                                              |
| `fulfillment_type` | string           | não         | Filtro de entrega, retirada ou envio para casa                                                                                                                                               |
| `store_id`         | string           | não         | A loja cujo catálogo e preços são retornados                                                                                                                                                 |
| `output`           | array de strings | não         | Formatos a retornar: `markdown`, `html`, `json`, `screenshot`. Padrão `["html"]`. `json` retorna campos analisados. `screenshot` requer `run_js: true`                                       |
| `json`             | objeto           | não         | Extração personalizada: `{"prompt": string}` ou `{"schema": object}`, nunca ambos. Substitui o parser embutido                                                                               |
| `location`         | string           | não         | Código de país de duas letras para buscar, por exemplo `DE`                                                                                                                                  |
| `device`           | string           | não         | `desktop` (padrão) ou `mobile`                                                                                                                                                               |
| `run_js`           | booleano         | não         | Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 120 segundos ou mais                                                                              |
| `callback_url`     | string           | não         | URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com `400`                                                                                           |
| `storage`          | objeto           | não         | Entrega o resultado em um bucket em vez da resposta: `{"type": string, "url": string}`. `tipo` é `s3`, `s3_gzip`, `s3_compatible`, `gcs`, ou `tos`. Somente assíncrono. `url` não é validado |

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

Retorna o preço, o estoque e os detalhes de um produto do Mariano's.

**Modos:** síncrono · assíncrono

| Nome               | Tipo             | Obrigatório | Descrição                                                                                                                                                                                    |
| ------------------ | ---------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`            | string           | sim         | ID do produto                                                                                                                                                                                |
| `delivery_zip`     | string           | não         | A entrega por CEP é cotada para                                                                                                                                                              |
| `fulfillment_type` | string           | não         | Filtro de entrega, retirada ou envio para casa                                                                                                                                               |
| `store_id`         | string           | não         | A loja cujo catálogo e preços são retornados                                                                                                                                                 |
| `output`           | array de strings | não         | Formatos a retornar: `markdown`, `html`, `json`, `screenshot`. Padrão `["html"]`. `json` retorna campos analisados. `screenshot` requer `run_js: true`                                       |
| `json`             | objeto           | não         | Extração personalizada: `{"prompt": string}` ou `{"schema": object}`, nunca ambos. Substitui o parser embutido                                                                               |
| `location`         | string           | não         | Código de país de duas letras para buscar, por exemplo `DE`                                                                                                                                  |
| `device`           | string           | não         | `desktop` (padrão) ou `mobile`                                                                                                                                                               |
| `run_js`           | booleano         | não         | Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 120 segundos ou mais                                                                              |
| `callback_url`     | string           | não         | URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com `400`                                                                                           |
| `storage`          | objeto           | não         | Entrega o resultado em um bucket em vez da resposta: `{"type": string, "url": string}`. `tipo` é `s3`, `s3_gzip`, `s3_compatible`, `gcs`, ou `tos`. Somente assíncrono. `url` não é validado |

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

Retorna resultados de busca do Mariano's para uma palavra-chave.

**Modos:** síncrono · assíncrono

| Nome               | Tipo             | Obrigatório | Descrição                                                                                                                                                                                    |
| ------------------ | ---------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`            | string           | sim         | Palavra-chave de busca                                                                                                                                                                       |
| `brand`            | string           | não         | Restringe os resultados a uma marca                                                                                                                                                          |
| `delivery_zip`     | string           | não         | A entrega por CEP é cotada para                                                                                                                                                              |
| `fulfillment_type` | string           | não         | Filtro de entrega, retirada ou envio para casa                                                                                                                                               |
| `price_range`      | string           | não         | Filtro de faixa de preço                                                                                                                                                                     |
| `store_id`         | string           | não         | A loja cujo catálogo e preços são retornados                                                                                                                                                 |
| `output`           | array de strings | não         | Formatos a retornar: `markdown`, `html`, `json`, `screenshot`. Padrão `["html"]`. `json` retorna campos analisados. `screenshot` requer `run_js: true`                                       |
| `json`             | objeto           | não         | Extração personalizada: `{"prompt": string}` ou `{"schema": object}`, nunca ambos. Substitui o parser embutido                                                                               |
| `location`         | string           | não         | Código de país de duas letras para buscar, por exemplo `DE`                                                                                                                                  |
| `device`           | string           | não         | `desktop` (padrão) ou `mobile`                                                                                                                                                               |
| `run_js`           | booleano         | não         | Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 120 segundos ou mais                                                                              |
| `callback_url`     | string           | não         | URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com `400`                                                                                           |
| `storage`          | objeto           | não         | Entrega o resultado em um bucket em vez da resposta: `{"type": string, "url": string}`. `tipo` é `s3`, `s3_gzip`, `s3_compatible`, `gcs`, ou `tos`. Somente assíncrono. `url` não é validado |

***

### MediaMarkt

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

Retorna campos extraídos de uma página da MediaMarkt a partir de uma URL que você fornecer.

**Modos:** síncrono · assíncrono

| Nome           | Tipo             | Obrigatório | Descrição                                                                                                                                                                                    |
| -------------- | ---------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `url`          | string           | sim         | Uma URL de produto ou de busca da MediaMarkt                                                                                                                                                 |
| `output`       | array de strings | não         | Formatos a retornar: `markdown`, `html`, `json`, `screenshot`. Padrão `["html"]`. `json` retorna campos analisados. `screenshot` requer `run_js: true`                                       |
| `json`         | objeto           | não         | Extração personalizada: `{"prompt": string}` ou `{"schema": object}`, nunca ambos. Substitui o parser embutido                                                                               |
| `location`     | string           | não         | Código de país de duas letras para buscar, por exemplo `DE`                                                                                                                                  |
| `device`       | string           | não         | `desktop` (padrão) ou `mobile`                                                                                                                                                               |
| `run_js`       | booleano         | não         | Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 120 segundos ou mais                                                                              |
| `callback_url` | string           | não         | URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com `400`                                                                                           |
| `storage`      | objeto           | não         | Entrega o resultado em um bucket em vez da resposta: `{"type": string, "url": string}`. `tipo` é `s3`, `s3_gzip`, `s3_compatible`, `gcs`, ou `tos`. Somente assíncrono. `url` não é validado |

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

Retorna o preço, o estoque e os detalhes de um produto da MediaMarkt.

**Modos:** síncrono · assíncrono

| Nome           | Tipo             | Obrigatório | Descrição                                                                                                                                                                                    |
| -------------- | ---------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`        | string           | sim         | ID do produto                                                                                                                                                                                |
| `domain`       | string           | não         | TLD da loja                                                                                                                                                                                  |
| `output`       | array de strings | não         | Formatos a retornar: `markdown`, `html`, `json`, `screenshot`. Padrão `["html"]`. `json` retorna campos analisados. `screenshot` requer `run_js: true`                                       |
| `json`         | objeto           | não         | Extração personalizada: `{"prompt": string}` ou `{"schema": object}`, nunca ambos. Substitui o parser embutido                                                                               |
| `location`     | string           | não         | Código de país de duas letras para buscar, por exemplo `DE`                                                                                                                                  |
| `device`       | string           | não         | `desktop` (padrão) ou `mobile`                                                                                                                                                               |
| `run_js`       | booleano         | não         | Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 120 segundos ou mais                                                                              |
| `callback_url` | string           | não         | URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com `400`                                                                                           |
| `storage`      | objeto           | não         | Entrega o resultado em um bucket em vez da resposta: `{"type": string, "url": string}`. `tipo` é `s3`, `s3_gzip`, `s3_compatible`, `gcs`, ou `tos`. Somente assíncrono. `url` não é validado |

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

Retorna resultados de busca da MediaMarkt para uma palavra-chave.

**Modos:** síncrono · assíncrono

| Nome           | Tipo             | Obrigatório | Descrição                                                                                                                                                                                    |
| -------------- | ---------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`        | string           | sim         | Palavra-chave de busca                                                                                                                                                                       |
| `domain`       | string           | não         | TLD da loja                                                                                                                                                                                  |
| `start_page`   | inteiro          | não         | Primeira página de resultados                                                                                                                                                                |
| `output`       | array de strings | não         | Formatos a retornar: `markdown`, `html`, `json`, `screenshot`. Padrão `["html"]`. `json` retorna campos analisados. `screenshot` requer `run_js: true`                                       |
| `json`         | objeto           | não         | Extração personalizada: `{"prompt": string}` ou `{"schema": object}`, nunca ambos. Substitui o parser embutido                                                                               |
| `location`     | string           | não         | Código de país de duas letras para buscar, por exemplo `DE`                                                                                                                                  |
| `device`       | string           | não         | `desktop` (padrão) ou `mobile`                                                                                                                                                               |
| `run_js`       | booleano         | não         | Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 120 segundos ou mais                                                                              |
| `callback_url` | string           | não         | URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com `400`                                                                                           |
| `storage`      | objeto           | não         | Entrega o resultado em um bucket em vez da resposta: `{"type": string, "url": string}`. `tipo` é `s3`, `s3_gzip`, `s3_compatible`, `gcs`, ou `tos`. Somente assíncrono. `url` não é validado |

***

### Menards

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

Retorna campos extraídos de uma página da Menards a partir de uma URL que você fornecer.

**Modos:** síncrono · assíncrono

| Nome           | Tipo             | Obrigatório | Descrição                                                                                                                                                                                    |
| -------------- | ---------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `url`          | string           | sim         | Uma URL de produto ou de busca da Menards                                                                                                                                                    |
| `store_id`     | string           | não         | A loja cujo catálogo e preços são retornados                                                                                                                                                 |
| `output`       | array de strings | não         | Formatos a retornar: `markdown`, `html`, `json`, `screenshot`. Padrão `["html"]`. `json` retorna campos analisados. `screenshot` requer `run_js: true`                                       |
| `json`         | objeto           | não         | Extração personalizada: `{"prompt": string}` ou `{"schema": object}`, nunca ambos. Substitui o parser embutido                                                                               |
| `location`     | string           | não         | Código de país de duas letras para buscar, por exemplo `DE`                                                                                                                                  |
| `device`       | string           | não         | `desktop` (padrão) ou `mobile`                                                                                                                                                               |
| `run_js`       | booleano         | não         | Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 120 segundos ou mais                                                                              |
| `callback_url` | string           | não         | URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com `400`                                                                                           |
| `storage`      | objeto           | não         | Entrega o resultado em um bucket em vez da resposta: `{"type": string, "url": string}`. `tipo` é `s3`, `s3_gzip`, `s3_compatible`, `gcs`, ou `tos`. Somente assíncrono. `url` não é validado |

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

Retorna o preço, o estoque e os detalhes de um produto da Menards.

**Modos:** síncrono · assíncrono

| Nome           | Tipo             | Obrigatório | Descrição                                                                                                                                                                                    |
| -------------- | ---------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`        | string           | sim         | ID do produto                                                                                                                                                                                |
| `domain`       | string           | não         | TLD da loja                                                                                                                                                                                  |
| `store_id`     | string           | não         | A loja cujo catálogo e preços são retornados                                                                                                                                                 |
| `output`       | array de strings | não         | Formatos a retornar: `markdown`, `html`, `json`, `screenshot`. Padrão `["html"]`. `json` retorna campos analisados. `screenshot` requer `run_js: true`                                       |
| `json`         | objeto           | não         | Extração personalizada: `{"prompt": string}` ou `{"schema": object}`, nunca ambos. Substitui o parser embutido                                                                               |
| `location`     | string           | não         | Código de país de duas letras para buscar, por exemplo `DE`                                                                                                                                  |
| `device`       | string           | não         | `desktop` (padrão) ou `mobile`                                                                                                                                                               |
| `run_js`       | booleano         | não         | Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 120 segundos ou mais                                                                              |
| `callback_url` | string           | não         | URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com `400`                                                                                           |
| `storage`      | objeto           | não         | Entrega o resultado em um bucket em vez da resposta: `{"type": string, "url": string}`. `tipo` é `s3`, `s3_gzip`, `s3_compatible`, `gcs`, ou `tos`. Somente assíncrono. `url` não é validado |

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

Retorna resultados de busca da Menards para uma palavra-chave.

**Modos:** síncrono · assíncrono

| Nome                       | Tipo             | Obrigatório | Descrição                                                                                                                                                                                    |
| -------------------------- | ---------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`                    | string           | sim         | Palavra-chave de busca                                                                                                                                                                       |
| `delivery_eligible`        | booleano         | não         | Somente itens elegíveis para entrega                                                                                                                                                         |
| `domain`                   | string           | não         | TLD da loja                                                                                                                                                                                  |
| `fulfillment_center`       | string           | não         | O local de atendimento ou armazém em relação ao qual a solicitação é avaliada                                                                                                                |
| `in_stock_today`           | booleano         | não         | Somente itens em estoque com disponibilidade no mesmo dia                                                                                                                                    |
| `pickup_at_store_eligible` | booleano         | não         | Somente itens elegíveis para retirada na loja                                                                                                                                                |
| `start_page`               | inteiro          | não         | Primeira página de resultados                                                                                                                                                                |
| `store_id`                 | string           | não         | A loja cujo catálogo e preços são retornados                                                                                                                                                 |
| `output`                   | array de strings | não         | Formatos a retornar: `markdown`, `html`, `json`, `screenshot`. Padrão `["html"]`. `json` retorna campos analisados. `screenshot` requer `run_js: true`                                       |
| `json`                     | objeto           | não         | Extração personalizada: `{"prompt": string}` ou `{"schema": object}`, nunca ambos. Substitui o parser embutido                                                                               |
| `location`                 | string           | não         | Código de país de duas letras para buscar, por exemplo `DE`                                                                                                                                  |
| `device`                   | string           | não         | `desktop` (padrão) ou `mobile`                                                                                                                                                               |
| `run_js`                   | booleano         | não         | Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 120 segundos ou mais                                                                              |
| `callback_url`             | string           | não         | URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com `400`                                                                                           |
| `storage`                  | objeto           | não         | Entrega o resultado em um bucket em vez da resposta: `{"type": string, "url": string}`. `tipo` é `s3`, `s3_gzip`, `s3_compatible`, `gcs`, ou `tos`. Somente assíncrono. `url` não é validado |

`in_stock_today` é um filtro de disponibilidade: ele altera quais produtos são retornados, não apenas como são exibidos.

***

### Mercado Libre

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

Retorna campos extraídos de uma página do Mercado Libre a partir de uma URL que você fornecer.

**Modos:** síncrono · assíncrono

| Nome           | Tipo             | Obrigatório | Descrição                                                                                                                                                                                    |
| -------------- | ---------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `url`          | string           | sim         | Uma URL de produto ou de busca do Mercado Libre                                                                                                                                              |
| `output`       | array de strings | não         | Formatos a retornar: `markdown`, `html`, `json`, `screenshot`. Padrão `["html"]`. `json` retorna campos analisados. `screenshot` requer `run_js: true`                                       |
| `json`         | objeto           | não         | Extração personalizada: `{"prompt": string}` ou `{"schema": object}`, nunca ambos. Substitui o parser embutido                                                                               |
| `location`     | string           | não         | Código de país de duas letras para buscar, por exemplo `DE`                                                                                                                                  |
| `device`       | string           | não         | `desktop` (padrão) ou `mobile`                                                                                                                                                               |
| `run_js`       | booleano         | não         | Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 120 segundos ou mais                                                                              |
| `callback_url` | string           | não         | URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com `400`                                                                                           |
| `storage`      | objeto           | não         | Entrega o resultado em um bucket em vez da resposta: `{"type": string, "url": string}`. `tipo` é `s3`, `s3_gzip`, `s3_compatible`, `gcs`, ou `tos`. Somente assíncrono. `url` não é validado |

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

Retorna o preço, o estoque e os detalhes de um produto do Mercado Libre.

**Modos:** síncrono · assíncrono

| Nome           | Tipo             | Obrigatório | Descrição                                                                                                                                                                                    |
| -------------- | ---------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`        | string           | sim         | ID do produto                                                                                                                                                                                |
| `domain`       | string           | não         | TLD da loja                                                                                                                                                                                  |
| `output`       | array de strings | não         | Formatos a retornar: `markdown`, `html`, `json`, `screenshot`. Padrão `["html"]`. `json` retorna campos analisados. `screenshot` requer `run_js: true`                                       |
| `json`         | objeto           | não         | Extração personalizada: `{"prompt": string}` ou `{"schema": object}`, nunca ambos. Substitui o parser embutido                                                                               |
| `location`     | string           | não         | Código de país de duas letras para buscar, por exemplo `DE`                                                                                                                                  |
| `device`       | string           | não         | `desktop` (padrão) ou `mobile`                                                                                                                                                               |
| `run_js`       | booleano         | não         | Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 120 segundos ou mais                                                                              |
| `callback_url` | string           | não         | URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com `400`                                                                                           |
| `storage`      | objeto           | não         | Entrega o resultado em um bucket em vez da resposta: `{"type": string, "url": string}`. `tipo` é `s3`, `s3_gzip`, `s3_compatible`, `gcs`, ou `tos`. Somente assíncrono. `url` não é validado |

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

Retorna resultados de busca do Mercado Libre para uma palavra-chave.

**Modos:** síncrono · assíncrono

| Nome           | Tipo             | Obrigatório | Descrição                                                                                                                                                                                    |
| -------------- | ---------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`        | string           | sim         | Palavra-chave de busca                                                                                                                                                                       |
| `domain`       | string           | não         | TLD da loja                                                                                                                                                                                  |
| `output`       | array de strings | não         | Formatos a retornar: `markdown`, `html`, `json`, `screenshot`. Padrão `["html"]`. `json` retorna campos analisados. `screenshot` requer `run_js: true`                                       |
| `json`         | objeto           | não         | Extração personalizada: `{"prompt": string}` ou `{"schema": object}`, nunca ambos. Substitui o parser embutido                                                                               |
| `location`     | string           | não         | Código de país de duas letras para buscar, por exemplo `DE`                                                                                                                                  |
| `device`       | string           | não         | `desktop` (padrão) ou `mobile`                                                                                                                                                               |
| `run_js`       | booleano         | não         | Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 120 segundos ou mais                                                                              |
| `callback_url` | string           | não         | URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com `400`                                                                                           |
| `storage`      | objeto           | não         | Entrega o resultado em um bucket em vez da resposta: `{"type": string, "url": string}`. `tipo` é `s3`, `s3_gzip`, `s3_compatible`, `gcs`, ou `tos`. Somente assíncrono. `url` não é validado |

***

### Mercado Livre

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

Retorna o preço, o estoque e os detalhes de um produto do Mercado Livre.

**Modos:** síncrono · assíncrono

| Nome           | Tipo             | Obrigatório | Descrição                                                                                                                                                                                    |
| -------------- | ---------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`        | string           | sim         | ID do produto                                                                                                                                                                                |
| `domain`       | string           | não         | TLD da loja                                                                                                                                                                                  |
| `output`       | array de strings | não         | Formatos a retornar: `markdown`, `html`, `json`, `screenshot`. Padrão `["html"]`. `json` retorna campos analisados. `screenshot` requer `run_js: true`                                       |
| `json`         | objeto           | não         | Extração personalizada: `{"prompt": string}` ou `{"schema": object}`, nunca ambos. Substitui o parser embutido                                                                               |
| `location`     | string           | não         | Código de país de duas letras para buscar, por exemplo `DE`                                                                                                                                  |
| `device`       | string           | não         | `desktop` (padrão) ou `mobile`                                                                                                                                                               |
| `run_js`       | booleano         | não         | Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 120 segundos ou mais                                                                              |
| `callback_url` | string           | não         | URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com `400`                                                                                           |
| `storage`      | objeto           | não         | Entrega o resultado em um bucket em vez da resposta: `{"type": string, "url": string}`. `tipo` é `s3`, `s3_gzip`, `s3_compatible`, `gcs`, ou `tos`. Somente assíncrono. `url` não é validado |

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

Retorna resultados de busca do Mercado Livre para uma palavra-chave.

**Modos:** síncrono · assíncrono

| Nome           | Tipo             | Obrigatório | Descrição                                                                                                                                                                                    |
| -------------- | ---------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`        | string           | sim         | Palavra-chave de busca                                                                                                                                                                       |
| `domain`       | string           | não         | TLD da loja                                                                                                                                                                                  |
| `output`       | array de strings | não         | Formatos a retornar: `markdown`, `html`, `json`, `screenshot`. Padrão `["html"]`. `json` retorna campos analisados. `screenshot` requer `run_js: true`                                       |
| `json`         | objeto           | não         | Extração personalizada: `{"prompt": string}` ou `{"schema": object}`, nunca ambos. Substitui o parser embutido                                                                               |
| `location`     | string           | não         | Código de país de duas letras para buscar, por exemplo `DE`                                                                                                                                  |
| `device`       | string           | não         | `desktop` (padrão) ou `mobile`                                                                                                                                                               |
| `run_js`       | booleano         | não         | Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 120 segundos ou mais                                                                              |
| `callback_url` | string           | não         | URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com `400`                                                                                           |
| `storage`      | objeto           | não         | Entrega o resultado em um bucket em vez da resposta: `{"type": string, "url": string}`. `tipo` é `s3`, `s3_gzip`, `s3_compatible`, `gcs`, ou `tos`. Somente assíncrono. `url` não é validado |

***

### Metro Market

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

Retorna campos extraídos de uma página do Metro Market a partir de uma URL que você fornecer.

**Modos:** síncrono · assíncrono

| Nome               | Tipo             | Obrigatório | Descrição                                                                                                                                                                                    |
| ------------------ | ---------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `url`              | string           | sim         | Uma URL de produto ou de busca do Metro Market                                                                                                                                               |
| `delivery_zip`     | string           | não         | A entrega por CEP é cotada para                                                                                                                                                              |
| `fulfillment_type` | string           | não         | Filtro de entrega, retirada ou envio para casa                                                                                                                                               |
| `store_id`         | string           | não         | A loja cujo catálogo e preços são retornados                                                                                                                                                 |
| `output`           | array de strings | não         | Formatos a retornar: `markdown`, `html`, `json`, `screenshot`. Padrão `["html"]`. `json` retorna campos analisados. `screenshot` requer `run_js: true`                                       |
| `json`             | objeto           | não         | Extração personalizada: `{"prompt": string}` ou `{"schema": object}`, nunca ambos. Substitui o parser embutido                                                                               |
| `location`         | string           | não         | Código de país de duas letras para buscar, por exemplo `DE`                                                                                                                                  |
| `device`           | string           | não         | `desktop` (padrão) ou `mobile`                                                                                                                                                               |
| `run_js`           | booleano         | não         | Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 120 segundos ou mais                                                                              |
| `callback_url`     | string           | não         | URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com `400`                                                                                           |
| `storage`          | objeto           | não         | Entrega o resultado em um bucket em vez da resposta: `{"type": string, "url": string}`. `tipo` é `s3`, `s3_gzip`, `s3_compatible`, `gcs`, ou `tos`. Somente assíncrono. `url` não é validado |

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

Retorna o preço, o estoque e os detalhes de um produto do Metro Market.

**Modos:** síncrono · assíncrono

| Nome               | Tipo             | Obrigatório | Descrição                                                                                                                                                                                    |
| ------------------ | ---------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`            | string           | sim         | ID do produto                                                                                                                                                                                |
| `delivery_zip`     | string           | não         | A entrega por CEP é cotada para                                                                                                                                                              |
| `fulfillment_type` | string           | não         | Filtro de entrega, retirada ou envio para casa                                                                                                                                               |
| `store_id`         | string           | não         | A loja cujo catálogo e preços são retornados                                                                                                                                                 |
| `output`           | array de strings | não         | Formatos a retornar: `markdown`, `html`, `json`, `screenshot`. Padrão `["html"]`. `json` retorna campos analisados. `screenshot` requer `run_js: true`                                       |
| `json`             | objeto           | não         | Extração personalizada: `{"prompt": string}` ou `{"schema": object}`, nunca ambos. Substitui o parser embutido                                                                               |
| `location`         | string           | não         | Código de país de duas letras para buscar, por exemplo `DE`                                                                                                                                  |
| `device`           | string           | não         | `desktop` (padrão) ou `mobile`                                                                                                                                                               |
| `run_js`           | booleano         | não         | Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 120 segundos ou mais                                                                              |
| `callback_url`     | string           | não         | URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com `400`                                                                                           |
| `storage`          | objeto           | não         | Entrega o resultado em um bucket em vez da resposta: `{"type": string, "url": string}`. `tipo` é `s3`, `s3_gzip`, `s3_compatible`, `gcs`, ou `tos`. Somente assíncrono. `url` não é validado |

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

Retorna resultados de busca do Metro Market para uma palavra-chave.

**Modos:** síncrono · assíncrono

| Nome               | Tipo             | Obrigatório | Descrição                                                                                                                                                                                    |
| ------------------ | ---------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`            | string           | sim         | Palavra-chave de busca                                                                                                                                                                       |
| `brand`            | string           | não         | Restringe os resultados a uma marca                                                                                                                                                          |
| `delivery_zip`     | string           | não         | A entrega por CEP é cotada para                                                                                                                                                              |
| `fulfillment_type` | string           | não         | Filtro de entrega, retirada ou envio para casa                                                                                                                                               |
| `price_range`      | string           | não         | Filtro de faixa de preço                                                                                                                                                                     |
| `store_id`         | string           | não         | A loja cujo catálogo e preços são retornados                                                                                                                                                 |
| `output`           | array de strings | não         | Formatos a retornar: `markdown`, `html`, `json`, `screenshot`. Padrão `["html"]`. `json` retorna campos analisados. `screenshot` requer `run_js: true`                                       |
| `json`             | objeto           | não         | Extração personalizada: `{"prompt": string}` ou `{"schema": object}`, nunca ambos. Substitui o parser embutido                                                                               |
| `location`         | string           | não         | Código de país de duas letras para buscar, por exemplo `DE`                                                                                                                                  |
| `device`           | string           | não         | `desktop` (padrão) ou `mobile`                                                                                                                                                               |
| `run_js`           | booleano         | não         | Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 120 segundos ou mais                                                                              |
| `callback_url`     | string           | não         | URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com `400`                                                                                           |
| `storage`          | objeto           | não         | Entrega o resultado em um bucket em vez da resposta: `{"type": string, "url": string}`. `tipo` é `s3`, `s3_gzip`, `s3_compatible`, `gcs`, ou `tos`. Somente assíncrono. `url` não é validado |

***

### Neobits

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

Retorna resultados de busca do Neobits para uma palavra-chave.

**Modos:** síncrono · assíncrono

| Nome           | Tipo             | Obrigatório | Descrição                                                                                                                                                                                    |
| -------------- | ---------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`        | string           | sim         | Palavra-chave de busca                                                                                                                                                                       |
| `domain`       | string           | não         | TLD da loja                                                                                                                                                                                  |
| `output`       | array de strings | não         | Formatos a retornar: `markdown`, `html`, `json`, `screenshot`. Padrão `["html"]`. `json` retorna campos analisados. `screenshot` requer `run_js: true`                                       |
| `json`         | objeto           | não         | Extração personalizada: `{"prompt": string}` ou `{"schema": object}`, nunca ambos. Substitui o parser embutido                                                                               |
| `location`     | string           | não         | Código de país de duas letras para buscar, por exemplo `DE`                                                                                                                                  |
| `device`       | string           | não         | `desktop` (padrão) ou `mobile`                                                                                                                                                               |
| `run_js`       | booleano         | não         | Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 120 segundos ou mais                                                                              |
| `callback_url` | string           | não         | URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com `400`                                                                                           |
| `storage`      | objeto           | não         | Entrega o resultado em um bucket em vez da resposta: `{"type": string, "url": string}`. `tipo` é `s3`, `s3_gzip`, `s3_compatible`, `gcs`, ou `tos`. Somente assíncrono. `url` não é validado |

***

### Petco

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

Retorna campos extraídos de uma página do Petco a partir de uma URL que você fornecer.

**Modos:** síncrono · assíncrono

| Nome           | Tipo             | Obrigatório | Descrição                                                                                                                                                                                    |
| -------------- | ---------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `url`          | string           | sim         | Uma URL de produto ou de busca do Petco                                                                                                                                                      |
| `store_id`     | string           | não         | A loja cujo catálogo e preços são retornados                                                                                                                                                 |
| `output`       | array de strings | não         | Formatos a retornar: `markdown`, `html`, `json`, `screenshot`. Padrão `["html"]`. `json` retorna campos analisados. `screenshot` requer `run_js: true`                                       |
| `json`         | objeto           | não         | Extração personalizada: `{"prompt": string}` ou `{"schema": object}`, nunca ambos. Substitui o parser embutido                                                                               |
| `location`     | string           | não         | Código de país de duas letras para buscar, por exemplo `DE`                                                                                                                                  |
| `device`       | string           | não         | `desktop` (padrão) ou `mobile`                                                                                                                                                               |
| `run_js`       | booleano         | não         | Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 120 segundos ou mais                                                                              |
| `callback_url` | string           | não         | URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com `400`                                                                                           |
| `storage`      | objeto           | não         | Entrega o resultado em um bucket em vez da resposta: `{"type": string, "url": string}`. `tipo` é `s3`, `s3_gzip`, `s3_compatible`, `gcs`, ou `tos`. Somente assíncrono. `url` não é validado |

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

Retorna resultados de busca do Petco para uma palavra-chave.

**Modos:** síncrono · assíncrono

| Nome               | Tipo             | Obrigatório | Descrição                                                                                                                                                                                    |
| ------------------ | ---------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`            | string           | sim         | Palavra-chave de busca                                                                                                                                                                       |
| `domain`           | string           | não         | TLD da loja                                                                                                                                                                                  |
| `fulfillment_type` | string           | não         | Filtro de entrega, retirada ou envio para casa                                                                                                                                               |
| `start_page`       | inteiro          | não         | Primeira página de resultados                                                                                                                                                                |
| `store_id`         | string           | não         | A loja cujo catálogo e preços são retornados                                                                                                                                                 |
| `output`           | array de strings | não         | Formatos a retornar: `markdown`, `html`, `json`, `screenshot`. Padrão `["html"]`. `json` retorna campos analisados. `screenshot` requer `run_js: true`                                       |
| `json`             | objeto           | não         | Extração personalizada: `{"prompt": string}` ou `{"schema": object}`, nunca ambos. Substitui o parser embutido                                                                               |
| `location`         | string           | não         | Código de país de duas letras para buscar, por exemplo `DE`                                                                                                                                  |
| `device`           | string           | não         | `desktop` (padrão) ou `mobile`                                                                                                                                                               |
| `run_js`           | booleano         | não         | Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 120 segundos ou mais                                                                              |
| `callback_url`     | string           | não         | URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com `400`                                                                                           |
| `storage`          | objeto           | não         | Entrega o resultado em um bucket em vez da resposta: `{"type": string, "url": string}`. `tipo` é `s3`, `s3_gzip`, `s3_compatible`, `gcs`, ou `tos`. Somente assíncrono. `url` não é validado |

***

### Pick 'n Save

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

Retorna campos extraídos de uma página do Pick 'n Save a partir de uma URL que você fornecer.

**Modos:** síncrono · assíncrono

| Nome               | Tipo             | Obrigatório | Descrição                                                                                                                                                                                    |
| ------------------ | ---------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `url`              | string           | sim         | Uma URL de produto ou de busca do Pick 'n Save                                                                                                                                               |
| `delivery_zip`     | string           | não         | A entrega por CEP é cotada para                                                                                                                                                              |
| `fulfillment_type` | string           | não         | Filtro de entrega, retirada ou envio para casa                                                                                                                                               |
| `store_id`         | string           | não         | A loja cujo catálogo e preços são retornados                                                                                                                                                 |
| `output`           | array de strings | não         | Formatos a retornar: `markdown`, `html`, `json`, `screenshot`. Padrão `["html"]`. `json` retorna campos analisados. `screenshot` requer `run_js: true`                                       |
| `json`             | objeto           | não         | Extração personalizada: `{"prompt": string}` ou `{"schema": object}`, nunca ambos. Substitui o parser embutido                                                                               |
| `location`         | string           | não         | Código de país de duas letras para buscar, por exemplo `DE`                                                                                                                                  |
| `device`           | string           | não         | `desktop` (padrão) ou `mobile`                                                                                                                                                               |
| `run_js`           | booleano         | não         | Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 120 segundos ou mais                                                                              |
| `callback_url`     | string           | não         | URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com `400`                                                                                           |
| `storage`          | objeto           | não         | Entrega o resultado em um bucket em vez da resposta: `{"type": string, "url": string}`. `tipo` é `s3`, `s3_gzip`, `s3_compatible`, `gcs`, ou `tos`. Somente assíncrono. `url` não é validado |

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

Retorna o preço, o estoque e os detalhes de um produto do Pick 'n Save.

**Modos:** síncrono · assíncrono

| Nome               | Tipo             | Obrigatório | Descrição                                                                                                                                                                                    |
| ------------------ | ---------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`            | string           | sim         | ID do produto                                                                                                                                                                                |
| `delivery_zip`     | string           | não         | A entrega por CEP é cotada para                                                                                                                                                              |
| `fulfillment_type` | string           | não         | Filtro de entrega, retirada ou envio para casa                                                                                                                                               |
| `store_id`         | string           | não         | A loja cujo catálogo e preços são retornados                                                                                                                                                 |
| `output`           | array de strings | não         | Formatos a retornar: `markdown`, `html`, `json`, `screenshot`. Padrão `["html"]`. `json` retorna campos analisados. `screenshot` requer `run_js: true`                                       |
| `json`             | objeto           | não         | Extração personalizada: `{"prompt": string}` ou `{"schema": object}`, nunca ambos. Substitui o parser embutido                                                                               |
| `location`         | string           | não         | Código de país de duas letras para buscar, por exemplo `DE`                                                                                                                                  |
| `device`           | string           | não         | `desktop` (padrão) ou `mobile`                                                                                                                                                               |
| `run_js`           | booleano         | não         | Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 120 segundos ou mais                                                                              |
| `callback_url`     | string           | não         | URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com `400`                                                                                           |
| `storage`          | objeto           | não         | Entrega o resultado em um bucket em vez da resposta: `{"type": string, "url": string}`. `tipo` é `s3`, `s3_gzip`, `s3_compatible`, `gcs`, ou `tos`. Somente assíncrono. `url` não é validado |

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

Retorna resultados de busca do Pick 'n Save para uma palavra-chave.

**Modos:** síncrono · assíncrono

| Nome               | Tipo             | Obrigatório | Descrição                                                                                                                                                                                    |
| ------------------ | ---------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`            | string           | sim         | Palavra-chave de busca                                                                                                                                                                       |
| `brand`            | string           | não         | Restringe os resultados a uma marca                                                                                                                                                          |
| `delivery_zip`     | string           | não         | A entrega por CEP é cotada para                                                                                                                                                              |
| `fulfillment_type` | string           | não         | Filtro de entrega, retirada ou envio para casa                                                                                                                                               |
| `price_range`      | string           | não         | Filtro de faixa de preço                                                                                                                                                                     |
| `store_id`         | string           | não         | A loja cujo catálogo e preços são retornados                                                                                                                                                 |
| `output`           | array de strings | não         | Formatos a retornar: `markdown`, `html`, `json`, `screenshot`. Padrão `["html"]`. `json` retorna campos analisados. `screenshot` requer `run_js: true`                                       |
| `json`             | objeto           | não         | Extração personalizada: `{"prompt": string}` ou `{"schema": object}`, nunca ambos. Substitui o parser embutido                                                                               |
| `location`         | string           | não         | Código de país de duas letras para buscar, por exemplo `DE`                                                                                                                                  |
| `device`           | string           | não         | `desktop` (padrão) ou `mobile`                                                                                                                                                               |
| `run_js`           | booleano         | não         | Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 120 segundos ou mais                                                                              |
| `callback_url`     | string           | não         | URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com `400`                                                                                           |
| `storage`          | objeto           | não         | Entrega o resultado em um bucket em vez da resposta: `{"type": string, "url": string}`. `tipo` é `s3`, `s3_gzip`, `s3_compatible`, `gcs`, ou `tos`. Somente assíncrono. `url` não é validado |

***

### Publix

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

Retorna campos extraídos de uma página do Publix a partir de uma URL que você fornecer.

**Modos:** síncrono · assíncrono

| Nome           | Tipo             | Obrigatório | Descrição                                                                                                                                                                                    |
| -------------- | ---------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `url`          | string           | sim         | Uma URL de produto ou de busca do Publix                                                                                                                                                     |
| `store_id`     | string           | não         | A loja cujo catálogo e preços são retornados                                                                                                                                                 |
| `output`       | array de strings | não         | Formatos a retornar: `markdown`, `html`, `json`, `screenshot`. Padrão `["html"]`. `json` retorna campos analisados. `screenshot` requer `run_js: true`                                       |
| `json`         | objeto           | não         | Extração personalizada: `{"prompt": string}` ou `{"schema": object}`, nunca ambos. Substitui o parser embutido                                                                               |
| `location`     | string           | não         | Código de país de duas letras para buscar, por exemplo `DE`                                                                                                                                  |
| `device`       | string           | não         | `desktop` (padrão) ou `mobile`                                                                                                                                                               |
| `run_js`       | booleano         | não         | Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 120 segundos ou mais                                                                              |
| `callback_url` | string           | não         | URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com `400`                                                                                           |
| `storage`      | objeto           | não         | Entrega o resultado em um bucket em vez da resposta: `{"type": string, "url": string}`. `tipo` é `s3`, `s3_gzip`, `s3_compatible`, `gcs`, ou `tos`. Somente assíncrono. `url` não é validado |

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

Retorna o preço, o estoque e os detalhes de um produto do Publix.

**Modos:** síncrono · assíncrono

| Nome           | Tipo             | Obrigatório | Descrição                                                                                                                                                                                    |
| -------------- | ---------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`        | string           | sim         | ID do produto                                                                                                                                                                                |
| `store_id`     | string           | não         | A loja cujo catálogo e preços são retornados                                                                                                                                                 |
| `output`       | array de strings | não         | Formatos a retornar: `markdown`, `html`, `json`, `screenshot`. Padrão `["html"]`. `json` retorna campos analisados. `screenshot` requer `run_js: true`                                       |
| `json`         | objeto           | não         | Extração personalizada: `{"prompt": string}` ou `{"schema": object}`, nunca ambos. Substitui o parser embutido                                                                               |
| `location`     | string           | não         | Código de país de duas letras para buscar, por exemplo `DE`                                                                                                                                  |
| `device`       | string           | não         | `desktop` (padrão) ou `mobile`                                                                                                                                                               |
| `run_js`       | booleano         | não         | Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 120 segundos ou mais                                                                              |
| `callback_url` | string           | não         | URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com `400`                                                                                           |
| `storage`      | objeto           | não         | Entrega o resultado em um bucket em vez da resposta: `{"type": string, "url": string}`. `tipo` é `s3`, `s3_gzip`, `s3_compatible`, `gcs`, ou `tos`. Somente assíncrono. `url` não é validado |

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

Retorna resultados de busca do Publix para uma palavra-chave.

**Modos:** síncrono · assíncrono

| Nome           | Tipo             | Obrigatório | Descrição                                                                                                                                                                                    |
| -------------- | ---------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`        | string           | sim         | Palavra-chave de busca                                                                                                                                                                       |
| `store_id`     | string           | não         | A loja cujo catálogo e preços são retornados                                                                                                                                                 |
| `output`       | array de strings | não         | Formatos a retornar: `markdown`, `html`, `json`, `screenshot`. Padrão `["html"]`. `json` retorna campos analisados. `screenshot` requer `run_js: true`                                       |
| `json`         | objeto           | não         | Extração personalizada: `{"prompt": string}` ou `{"schema": object}`, nunca ambos. Substitui o parser embutido                                                                               |
| `location`     | string           | não         | Código de país de duas letras para buscar, por exemplo `DE`                                                                                                                                  |
| `device`       | string           | não         | `desktop` (padrão) ou `mobile`                                                                                                                                                               |
| `run_js`       | booleano         | não         | Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 120 segundos ou mais                                                                              |
| `callback_url` | string           | não         | URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com `400`                                                                                           |
| `storage`      | objeto           | não         | Entrega o resultado em um bucket em vez da resposta: `{"type": string, "url": string}`. `tipo` é `s3`, `s3_gzip`, `s3_compatible`, `gcs`, ou `tos`. Somente assíncrono. `url` não é validado |

***

### QFC

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

Retorna campos extraídos de uma página do QFC a partir de uma URL que você fornecer.

**Modos:** síncrono · assíncrono

| Nome               | Tipo             | Obrigatório | Descrição                                                                                                                                                                                    |
| ------------------ | ---------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `url`              | string           | sim         | Uma URL de produto ou de busca do QFC                                                                                                                                                        |
| `delivery_zip`     | string           | não         | A entrega por CEP é cotada para                                                                                                                                                              |
| `fulfillment_type` | string           | não         | Filtro de entrega, retirada ou envio para casa                                                                                                                                               |
| `store_id`         | string           | não         | A loja cujo catálogo e preços são retornados                                                                                                                                                 |
| `output`           | array de strings | não         | Formatos a retornar: `markdown`, `html`, `json`, `screenshot`. Padrão `["html"]`. `json` retorna campos analisados. `screenshot` requer `run_js: true`                                       |
| `json`             | objeto           | não         | Extração personalizada: `{"prompt": string}` ou `{"schema": object}`, nunca ambos. Substitui o parser embutido                                                                               |
| `location`         | string           | não         | Código de país de duas letras para buscar, por exemplo `DE`                                                                                                                                  |
| `device`           | string           | não         | `desktop` (padrão) ou `mobile`                                                                                                                                                               |
| `run_js`           | booleano         | não         | Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 120 segundos ou mais                                                                              |
| `callback_url`     | string           | não         | URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com `400`                                                                                           |
| `storage`          | objeto           | não         | Entrega o resultado em um bucket em vez da resposta: `{"type": string, "url": string}`. `tipo` é `s3`, `s3_gzip`, `s3_compatible`, `gcs`, ou `tos`. Somente assíncrono. `url` não é validado |

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

Retorna o preço, o estoque e os detalhes de um produto do QFC.

**Modos:** síncrono · assíncrono

| Nome               | Tipo             | Obrigatório | Descrição                                                                                                                                                                                    |
| ------------------ | ---------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`            | string           | sim         | ID do produto                                                                                                                                                                                |
| `delivery_zip`     | string           | não         | A entrega por CEP é cotada para                                                                                                                                                              |
| `fulfillment_type` | string           | não         | Filtro de entrega, retirada ou envio para casa                                                                                                                                               |
| `store_id`         | string           | não         | A loja cujo catálogo e preços são retornados                                                                                                                                                 |
| `output`           | array de strings | não         | Formatos a retornar: `markdown`, `html`, `json`, `screenshot`. Padrão `["html"]`. `json` retorna campos analisados. `screenshot` requer `run_js: true`                                       |
| `json`             | objeto           | não         | Extração personalizada: `{"prompt": string}` ou `{"schema": object}`, nunca ambos. Substitui o parser embutido                                                                               |
| `location`         | string           | não         | Código de país de duas letras para buscar, por exemplo `DE`                                                                                                                                  |
| `device`           | string           | não         | `desktop` (padrão) ou `mobile`                                                                                                                                                               |
| `run_js`           | booleano         | não         | Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 120 segundos ou mais                                                                              |
| `callback_url`     | string           | não         | URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com `400`                                                                                           |
| `storage`          | objeto           | não         | Entrega o resultado em um bucket em vez da resposta: `{"type": string, "url": string}`. `tipo` é `s3`, `s3_gzip`, `s3_compatible`, `gcs`, ou `tos`. Somente assíncrono. `url` não é validado |

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

Retorna resultados de busca do QFC para uma palavra-chave.

**Modos:** síncrono · assíncrono

| Nome               | Tipo             | Obrigatório | Descrição                                                                                                                                                                                    |
| ------------------ | ---------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`            | string           | sim         | Palavra-chave de busca                                                                                                                                                                       |
| `brand`            | string           | não         | Restringe os resultados a uma marca                                                                                                                                                          |
| `delivery_zip`     | string           | não         | A entrega por CEP é cotada para                                                                                                                                                              |
| `fulfillment_type` | string           | não         | Filtro de entrega, retirada ou envio para casa                                                                                                                                               |
| `price_range`      | string           | não         | Filtro de faixa de preço                                                                                                                                                                     |
| `store_id`         | string           | não         | A loja cujo catálogo e preços são retornados                                                                                                                                                 |
| `output`           | array de strings | não         | Formatos a retornar: `markdown`, `html`, `json`, `screenshot`. Padrão `["html"]`. `json` retorna campos analisados. `screenshot` requer `run_js: true`                                       |
| `json`             | objeto           | não         | Extração personalizada: `{"prompt": string}` ou `{"schema": object}`, nunca ambos. Substitui o parser embutido                                                                               |
| `location`         | string           | não         | Código de país de duas letras para buscar, por exemplo `DE`                                                                                                                                  |
| `device`           | string           | não         | `desktop` (padrão) ou `mobile`                                                                                                                                                               |
| `run_js`           | booleano         | não         | Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 120 segundos ou mais                                                                              |
| `callback_url`     | string           | não         | URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com `400`                                                                                           |
| `storage`          | objeto           | não         | Entrega o resultado em um bucket em vez da resposta: `{"type": string, "url": string}`. `tipo` é `s3`, `s3_gzip`, `s3_compatible`, `gcs`, ou `tos`. Somente assíncrono. `url` não é validado |

***

### Rakuten

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

Retorna campos extraídos de uma página do Rakuten a partir de uma URL que você fornecer.

**Modos:** síncrono · assíncrono

| Nome           | Tipo             | Obrigatório | Descrição                                                                                                                                                                                    |
| -------------- | ---------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `url`          | string           | sim         | Uma URL de produto ou de busca do Rakuten                                                                                                                                                    |
| `output`       | array de strings | não         | Formatos a retornar: `markdown`, `html`, `json`, `screenshot`. Padrão `["html"]`. `json` retorna campos analisados. `screenshot` requer `run_js: true`                                       |
| `json`         | objeto           | não         | Extração personalizada: `{"prompt": string}` ou `{"schema": object}`, nunca ambos. Substitui o parser embutido                                                                               |
| `location`     | string           | não         | Código de país de duas letras para buscar, por exemplo `DE`                                                                                                                                  |
| `device`       | string           | não         | `desktop` (padrão) ou `mobile`                                                                                                                                                               |
| `run_js`       | booleano         | não         | Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 120 segundos ou mais                                                                              |
| `callback_url` | string           | não         | URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com `400`                                                                                           |
| `storage`      | objeto           | não         | Entrega o resultado em um bucket em vez da resposta: `{"type": string, "url": string}`. `tipo` é `s3`, `s3_gzip`, `s3_compatible`, `gcs`, ou `tos`. Somente assíncrono. `url` não é validado |

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

Retorna resultados de busca do Rakuten para uma palavra-chave.

**Modos:** síncrono · assíncrono

| Nome           | Tipo             | Obrigatório | Descrição                                                                                                                                                                                    |
| -------------- | ---------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`        | string           | sim         | Palavra-chave de busca                                                                                                                                                                       |
| `domain`       | string           | não         | TLD da loja                                                                                                                                                                                  |
| `output`       | array de strings | não         | Formatos a retornar: `markdown`, `html`, `json`, `screenshot`. Padrão `["html"]`. `json` retorna campos analisados. `screenshot` requer `run_js: true`                                       |
| `json`         | objeto           | não         | Extração personalizada: `{"prompt": string}` ou `{"schema": object}`, nunca ambos. Substitui o parser embutido                                                                               |
| `location`     | string           | não         | Código de país de duas letras para buscar, por exemplo `DE`                                                                                                                                  |
| `device`       | string           | não         | `desktop` (padrão) ou `mobile`                                                                                                                                                               |
| `run_js`       | booleano         | não         | Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 120 segundos ou mais                                                                              |
| `callback_url` | string           | não         | URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com `400`                                                                                           |
| `storage`      | objeto           | não         | Entrega o resultado em um bucket em vez da resposta: `{"type": string, "url": string}`. `tipo` é `s3`, `s3_gzip`, `s3_compatible`, `gcs`, ou `tos`. Somente assíncrono. `url` não é validado |

***

### Ralphs

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

Retorna campos extraídos de uma página do Ralphs a partir de uma URL que você fornecer.

**Modos:** síncrono · assíncrono

| Nome               | Tipo             | Obrigatório | Descrição                                                                                                                                                                                    |
| ------------------ | ---------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `url`              | string           | sim         | Uma URL de produto ou de busca do Ralphs                                                                                                                                                     |
| `delivery_zip`     | string           | não         | A entrega por CEP é cotada para                                                                                                                                                              |
| `fulfillment_type` | string           | não         | Filtro de entrega, retirada ou envio para casa                                                                                                                                               |
| `store_id`         | string           | não         | A loja cujo catálogo e preços são retornados                                                                                                                                                 |
| `output`           | array de strings | não         | Formatos a retornar: `markdown`, `html`, `json`, `screenshot`. Padrão `["html"]`. `json` retorna campos analisados. `screenshot` requer `run_js: true`                                       |
| `json`             | objeto           | não         | Extração personalizada: `{"prompt": string}` ou `{"schema": object}`, nunca ambos. Substitui o parser embutido                                                                               |
| `location`         | string           | não         | Código de país de duas letras para buscar, por exemplo `DE`                                                                                                                                  |
| `device`           | string           | não         | `desktop` (padrão) ou `mobile`                                                                                                                                                               |
| `run_js`           | booleano         | não         | Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 120 segundos ou mais                                                                              |
| `callback_url`     | string           | não         | URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com `400`                                                                                           |
| `storage`          | objeto           | não         | Entrega o resultado em um bucket em vez da resposta: `{"type": string, "url": string}`. `tipo` é `s3`, `s3_gzip`, `s3_compatible`, `gcs`, ou `tos`. Somente assíncrono. `url` não é validado |

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

Retorna o preço, o estoque e os detalhes de um produto do Ralphs.

**Modos:** síncrono · assíncrono

| Nome               | Tipo             | Obrigatório | Descrição                                                                                                                                                                                    |
| ------------------ | ---------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`            | string           | sim         | ID do produto                                                                                                                                                                                |
| `delivery_zip`     | string           | não         | A entrega por CEP é cotada para                                                                                                                                                              |
| `fulfillment_type` | string           | não         | Filtro de entrega, retirada ou envio para casa                                                                                                                                               |
| `store_id`         | string           | não         | A loja cujo catálogo e preços são retornados                                                                                                                                                 |
| `output`           | array de strings | não         | Formatos a retornar: `markdown`, `html`, `json`, `screenshot`. Padrão `["html"]`. `json` retorna campos analisados. `screenshot` requer `run_js: true`                                       |
| `json`             | objeto           | não         | Extração personalizada: `{"prompt": string}` ou `{"schema": object}`, nunca ambos. Substitui o parser embutido                                                                               |
| `location`         | string           | não         | Código de país de duas letras para buscar, por exemplo `DE`                                                                                                                                  |
| `device`           | string           | não         | `desktop` (padrão) ou `mobile`                                                                                                                                                               |
| `run_js`           | booleano         | não         | Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 120 segundos ou mais                                                                              |
| `callback_url`     | string           | não         | URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com `400`                                                                                           |
| `storage`          | objeto           | não         | Entrega o resultado em um bucket em vez da resposta: `{"type": string, "url": string}`. `tipo` é `s3`, `s3_gzip`, `s3_compatible`, `gcs`, ou `tos`. Somente assíncrono. `url` não é validado |

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

Retorna resultados de busca do Ralphs para uma palavra-chave.

**Modos:** síncrono · assíncrono

| Nome               | Tipo             | Obrigatório | Descrição                                                                                                                                                                                    |
| ------------------ | ---------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`            | string           | sim         | Palavra-chave de busca                                                                                                                                                                       |
| `brand`            | string           | não         | Restringe os resultados a uma marca                                                                                                                                                          |
| `delivery_zip`     | string           | não         | A entrega por CEP é cotada para                                                                                                                                                              |
| `fulfillment_type` | string           | não         | Filtro de entrega, retirada ou envio para casa                                                                                                                                               |
| `price_range`      | string           | não         | Filtro de faixa de preço                                                                                                                                                                     |
| `store_id`         | string           | não         | A loja cujo catálogo e preços são retornados                                                                                                                                                 |
| `output`           | array de strings | não         | Formatos a retornar: `markdown`, `html`, `json`, `screenshot`. Padrão `["html"]`. `json` retorna campos analisados. `screenshot` requer `run_js: true`                                       |
| `json`             | objeto           | não         | Extração personalizada: `{"prompt": string}` ou `{"schema": object}`, nunca ambos. Substitui o parser embutido                                                                               |
| `location`         | string           | não         | Código de país de duas letras para buscar, por exemplo `DE`                                                                                                                                  |
| `device`           | string           | não         | `desktop` (padrão) ou `mobile`                                                                                                                                                               |
| `run_js`           | booleano         | não         | Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 120 segundos ou mais                                                                              |
| `callback_url`     | string           | não         | URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com `400`                                                                                           |
| `storage`          | objeto           | não         | Entrega o resultado em um bucket em vez da resposta: `{"type": string, "url": string}`. `tipo` é `s3`, `s3_gzip`, `s3_compatible`, `gcs`, ou `tos`. Somente assíncrono. `url` não é validado |

***

### Safeway

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

Retorna o preço, o estoque e os detalhes de um produto do Safeway.

**Modos:** síncrono · assíncrono

| Nome           | Tipo             | Obrigatório | Descrição                                                                                                                                                                                    |
| -------------- | ---------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`        | string           | sim         | ID do produto                                                                                                                                                                                |
| `zip_code`     | string           | não         | A entrega por CEP é cotada para                                                                                                                                                              |
| `output`       | array de strings | não         | Formatos a retornar: `markdown`, `html`, `json`, `screenshot`. Padrão `["html"]`. `json` retorna campos analisados. `screenshot` requer `run_js: true`                                       |
| `json`         | objeto           | não         | Extração personalizada: `{"prompt": string}` ou `{"schema": object}`, nunca ambos. Substitui o parser embutido                                                                               |
| `location`     | string           | não         | Código de país de duas letras para buscar, por exemplo `DE`                                                                                                                                  |
| `device`       | string           | não         | `desktop` (padrão) ou `mobile`                                                                                                                                                               |
| `run_js`       | booleano         | não         | Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 120 segundos ou mais                                                                              |
| `callback_url` | string           | não         | URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com `400`                                                                                           |
| `storage`      | objeto           | não         | Entrega o resultado em um bucket em vez da resposta: `{"type": string, "url": string}`. `tipo` é `s3`, `s3_gzip`, `s3_compatible`, `gcs`, ou `tos`. Somente assíncrono. `url` não é validado |

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

Retorna resultados de busca do Safeway para uma palavra-chave.

**Modos:** síncrono · assíncrono

| Nome           | Tipo             | Obrigatório | Descrição                                                                                                                                                                                    |
| -------------- | ---------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`        | string           | sim         | Palavra-chave de busca                                                                                                                                                                       |
| `zip_code`     | string           | não         | A entrega por CEP é cotada para                                                                                                                                                              |
| `output`       | array de strings | não         | Formatos a retornar: `markdown`, `html`, `json`, `screenshot`. Padrão `["html"]`. `json` retorna campos analisados. `screenshot` requer `run_js: true`                                       |
| `json`         | objeto           | não         | Extração personalizada: `{"prompt": string}` ou `{"schema": object}`, nunca ambos. Substitui o parser embutido                                                                               |
| `location`     | string           | não         | Código de país de duas letras para buscar, por exemplo `DE`                                                                                                                                  |
| `device`       | string           | não         | `desktop` (padrão) ou `mobile`                                                                                                                                                               |
| `run_js`       | booleano         | não         | Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 120 segundos ou mais                                                                              |
| `callback_url` | string           | não         | URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com `400`                                                                                           |
| `storage`      | objeto           | não         | Entrega o resultado em um bucket em vez da resposta: `{"type": string, "url": string}`. `tipo` é `s3`, `s3_gzip`, `s3_compatible`, `gcs`, ou `tos`. Somente assíncrono. `url` não é validado |

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

Retorna os produtos de uma categoria Safeway.

**Modos:** síncrono · assíncrono

| Nome           | Tipo             | Obrigatório | Descrição                                                                                                                                                                                    |
| -------------- | ---------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`        | string           | sim         | Categoria                                                                                                                                                                                    |
| `zip_code`     | string           | não         | A entrega por CEP é cotada para                                                                                                                                                              |
| `zip_code_url` | string           | não         | CEP formatado para inclusão na URL da categoria                                                                                                                                              |
| `output`       | array de strings | não         | Formatos a retornar: `markdown`, `html`, `json`, `screenshot`. Padrão `["html"]`. `json` retorna campos analisados. `screenshot` requer `run_js: true`                                       |
| `json`         | objeto           | não         | Extração personalizada: `{"prompt": string}` ou `{"schema": object}`, nunca ambos. Substitui o parser embutido                                                                               |
| `location`     | string           | não         | Código de país de duas letras para buscar, por exemplo `DE`                                                                                                                                  |
| `device`       | string           | não         | `desktop` (padrão) ou `mobile`                                                                                                                                                               |
| `run_js`       | booleano         | não         | Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 120 segundos ou mais                                                                              |
| `callback_url` | string           | não         | URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com `400`                                                                                           |
| `storage`      | objeto           | não         | Entrega o resultado em um bucket em vez da resposta: `{"type": string, "url": string}`. `tipo` é `s3`, `s3_gzip`, `s3_compatible`, `gcs`, ou `tos`. Somente assíncrono. `url` não é validado |

***

### Smith's

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

Retorna campos extraídos de uma página do Smith's a partir de uma URL que você fornecer.

**Modos:** síncrono · assíncrono

| Nome               | Tipo             | Obrigatório | Descrição                                                                                                                                                                                    |
| ------------------ | ---------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `url`              | string           | sim         | Uma URL de produto ou de busca do Smith's                                                                                                                                                    |
| `delivery_zip`     | string           | não         | A entrega por CEP é cotada para                                                                                                                                                              |
| `fulfillment_type` | string           | não         | Filtro de entrega, retirada ou envio para casa                                                                                                                                               |
| `store_id`         | string           | não         | A loja cujo catálogo e preços são retornados                                                                                                                                                 |
| `output`           | array de strings | não         | Formatos a retornar: `markdown`, `html`, `json`, `screenshot`. Padrão `["html"]`. `json` retorna campos analisados. `screenshot` requer `run_js: true`                                       |
| `json`             | objeto           | não         | Extração personalizada: `{"prompt": string}` ou `{"schema": object}`, nunca ambos. Substitui o parser embutido                                                                               |
| `location`         | string           | não         | Código de país de duas letras para buscar, por exemplo `DE`                                                                                                                                  |
| `device`           | string           | não         | `desktop` (padrão) ou `mobile`                                                                                                                                                               |
| `run_js`           | booleano         | não         | Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 120 segundos ou mais                                                                              |
| `callback_url`     | string           | não         | URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com `400`                                                                                           |
| `storage`          | objeto           | não         | Entrega o resultado em um bucket em vez da resposta: `{"type": string, "url": string}`. `tipo` é `s3`, `s3_gzip`, `s3_compatible`, `gcs`, ou `tos`. Somente assíncrono. `url` não é validado |

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

Retorna o preço, o estoque e os detalhes de um produto do Smith's.

**Modos:** síncrono · assíncrono

| Nome               | Tipo             | Obrigatório | Descrição                                                                                                                                                                                    |
| ------------------ | ---------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`            | string           | sim         | ID do produto                                                                                                                                                                                |
| `delivery_zip`     | string           | não         | A entrega por CEP é cotada para                                                                                                                                                              |
| `fulfillment_type` | string           | não         | Filtro de entrega, retirada ou envio para casa                                                                                                                                               |
| `store_id`         | string           | não         | A loja cujo catálogo e preços são retornados                                                                                                                                                 |
| `output`           | array de strings | não         | Formatos a retornar: `markdown`, `html`, `json`, `screenshot`. Padrão `["html"]`. `json` retorna campos analisados. `screenshot` requer `run_js: true`                                       |
| `json`             | objeto           | não         | Extração personalizada: `{"prompt": string}` ou `{"schema": object}`, nunca ambos. Substitui o parser embutido                                                                               |
| `location`         | string           | não         | Código de país de duas letras para buscar, por exemplo `DE`                                                                                                                                  |
| `device`           | string           | não         | `desktop` (padrão) ou `mobile`                                                                                                                                                               |
| `run_js`           | booleano         | não         | Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 120 segundos ou mais                                                                              |
| `callback_url`     | string           | não         | URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com `400`                                                                                           |
| `storage`          | objeto           | não         | Entrega o resultado em um bucket em vez da resposta: `{"type": string, "url": string}`. `tipo` é `s3`, `s3_gzip`, `s3_compatible`, `gcs`, ou `tos`. Somente assíncrono. `url` não é validado |

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

Retorna resultados de busca do Smith's para uma palavra-chave.

**Modos:** síncrono · assíncrono

| Nome               | Tipo             | Obrigatório | Descrição                                                                                                                                                                                    |
| ------------------ | ---------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`            | string           | sim         | Palavra-chave de busca                                                                                                                                                                       |
| `brand`            | string           | não         | Restringe os resultados a uma marca                                                                                                                                                          |
| `delivery_zip`     | string           | não         | A entrega por CEP é cotada para                                                                                                                                                              |
| `fulfillment_type` | string           | não         | Filtro de entrega, retirada ou envio para casa                                                                                                                                               |
| `price_range`      | string           | não         | Filtro de faixa de preço                                                                                                                                                                     |
| `store_id`         | string           | não         | A loja cujo catálogo e preços são retornados                                                                                                                                                 |
| `output`           | array de strings | não         | Formatos a retornar: `markdown`, `html`, `json`, `screenshot`. Padrão `["html"]`. `json` retorna campos analisados. `screenshot` requer `run_js: true`                                       |
| `json`             | objeto           | não         | Extração personalizada: `{"prompt": string}` ou `{"schema": object}`, nunca ambos. Substitui o parser embutido                                                                               |
| `location`         | string           | não         | Código de país de duas letras para buscar, por exemplo `DE`                                                                                                                                  |
| `device`           | string           | não         | `desktop` (padrão) ou `mobile`                                                                                                                                                               |
| `run_js`           | booleano         | não         | Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 120 segundos ou mais                                                                              |
| `callback_url`     | string           | não         | URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com `400`                                                                                           |
| `storage`          | objeto           | não         | Entrega o resultado em um bucket em vez da resposta: `{"type": string, "url": string}`. `tipo` é `s3`, `s3_gzip`, `s3_compatible`, `gcs`, ou `tos`. Somente assíncrono. `url` não é validado |

***

### Target

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

Retorna campos extraídos de uma página do Target a partir de uma URL que você fornecer.

**Modos:** síncrono · assíncrono

| Nome               | Tipo             | Obrigatório | Descrição                                                                                                                                                                                    |
| ------------------ | ---------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `url`              | string           | sim         | Uma URL de produto ou de busca do Target                                                                                                                                                     |
| `delivery_zip`     | string           | não         | A entrega por CEP é cotada para                                                                                                                                                              |
| `fulfillment_type` | string           | não         | Filtro de entrega, retirada ou envio para casa                                                                                                                                               |
| `store_id`         | string           | não         | A loja cujo catálogo e preços são retornados                                                                                                                                                 |
| `output`           | array de strings | não         | Formatos a retornar: `markdown`, `html`, `json`, `screenshot`. Padrão `["html"]`. `json` retorna campos analisados. `screenshot` requer `run_js: true`                                       |
| `json`             | objeto           | não         | Extração personalizada: `{"prompt": string}` ou `{"schema": object}`, nunca ambos. Substitui o parser embutido                                                                               |
| `location`         | string           | não         | Código de país de duas letras para buscar, por exemplo `DE`                                                                                                                                  |
| `device`           | string           | não         | `desktop` (padrão) ou `mobile`                                                                                                                                                               |
| `run_js`           | booleano         | não         | Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 120 segundos ou mais                                                                              |
| `callback_url`     | string           | não         | URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com `400`                                                                                           |
| `storage`          | objeto           | não         | Entrega o resultado em um bucket em vez da resposta: `{"type": string, "url": string}`. `tipo` é `s3`, `s3_gzip`, `s3_compatible`, `gcs`, ou `tos`. Somente assíncrono. `url` não é validado |

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

Retorna os produtos de uma categoria Target.

**Modos:** síncrono · assíncrono

| Nome               | Tipo             | Obrigatório | Descrição                                                                                                                                                                                    |
| ------------------ | ---------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`            | string           | sim         | Categoria                                                                                                                                                                                    |
| `delivery_zip`     | string           | não         | A entrega por CEP é cotada para                                                                                                                                                              |
| `fulfillment_type` | string           | não         | Filtro de entrega, retirada ou envio para casa                                                                                                                                               |
| `store_id`         | string           | não         | A loja cujo catálogo e preços são retornados                                                                                                                                                 |
| `output`           | array de strings | não         | Formatos a retornar: `markdown`, `html`, `json`, `screenshot`. Padrão `["html"]`. `json` retorna campos analisados. `screenshot` requer `run_js: true`                                       |
| `json`             | objeto           | não         | Extração personalizada: `{"prompt": string}` ou `{"schema": object}`, nunca ambos. Substitui o parser embutido                                                                               |
| `location`         | string           | não         | Código de país de duas letras para buscar, por exemplo `DE`                                                                                                                                  |
| `device`           | string           | não         | `desktop` (padrão) ou `mobile`                                                                                                                                                               |
| `run_js`           | booleano         | não         | Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 120 segundos ou mais                                                                              |
| `callback_url`     | string           | não         | URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com `400`                                                                                           |
| `storage`          | objeto           | não         | Entrega o resultado em um bucket em vez da resposta: `{"type": string, "url": string}`. `tipo` é `s3`, `s3_gzip`, `s3_compatible`, `gcs`, ou `tos`. Somente assíncrono. `url` não é validado |

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

Retorna o preço, o estoque e os detalhes de um produto do Target.

**Modos:** síncrono · assíncrono

| Nome               | Tipo             | Obrigatório | Descrição                                                                                                                                                                                    |
| ------------------ | ---------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`            | string           | sim         | ID do produto                                                                                                                                                                                |
| `delivery_zip`     | string           | não         | A entrega por CEP é cotada para                                                                                                                                                              |
| `fulfillment_type` | string           | não         | Filtro de entrega, retirada ou envio para casa                                                                                                                                               |
| `store_id`         | string           | não         | A loja cujo catálogo e preços são retornados                                                                                                                                                 |
| `output`           | array de strings | não         | Formatos a retornar: `markdown`, `html`, `json`, `screenshot`. Padrão `["html"]`. `json` retorna campos analisados. `screenshot` requer `run_js: true`                                       |
| `json`             | objeto           | não         | Extração personalizada: `{"prompt": string}` ou `{"schema": object}`, nunca ambos. Substitui o parser embutido                                                                               |
| `location`         | string           | não         | Código de país de duas letras para buscar, por exemplo `DE`                                                                                                                                  |
| `device`           | string           | não         | `desktop` (padrão) ou `mobile`                                                                                                                                                               |
| `run_js`           | booleano         | não         | Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 120 segundos ou mais                                                                              |
| `callback_url`     | string           | não         | URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com `400`                                                                                           |
| `storage`          | objeto           | não         | Entrega o resultado em um bucket em vez da resposta: `{"type": string, "url": string}`. `tipo` é `s3`, `s3_gzip`, `s3_compatible`, `gcs`, ou `tos`. Somente assíncrono. `url` não é validado |

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

Retorna resultados de busca do Target para uma palavra-chave.

**Modos:** síncrono · assíncrono

| Nome               | Tipo             | Obrigatório | Descrição                                                                                                                                                                                    |
| ------------------ | ---------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`            | string           | sim         | Palavra-chave de busca                                                                                                                                                                       |
| `delivery_zip`     | string           | não         | A entrega por CEP é cotada para                                                                                                                                                              |
| `fulfillment_type` | string           | não         | Filtro de entrega, retirada ou envio para casa                                                                                                                                               |
| `store_id`         | string           | não         | A loja cujo catálogo e preços são retornados                                                                                                                                                 |
| `output`           | array de strings | não         | Formatos a retornar: `markdown`, `html`, `json`, `screenshot`. Padrão `["html"]`. `json` retorna campos analisados. `screenshot` requer `run_js: true`                                       |
| `json`             | objeto           | não         | Extração personalizada: `{"prompt": string}` ou `{"schema": object}`, nunca ambos. Substitui o parser embutido                                                                               |
| `location`         | string           | não         | Código de país de duas letras para buscar, por exemplo `DE`                                                                                                                                  |
| `device`           | string           | não         | `desktop` (padrão) ou `mobile`                                                                                                                                                               |
| `run_js`           | booleano         | não         | Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 120 segundos ou mais                                                                              |
| `callback_url`     | string           | não         | URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com `400`                                                                                           |
| `storage`          | objeto           | não         | Entrega o resultado em um bucket em vez da resposta: `{"type": string, "url": string}`. `tipo` é `s3`, `s3_gzip`, `s3_compatible`, `gcs`, ou `tos`. Somente assíncrono. `url` não é validado |

***

### TikTok Shop

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

Retorna campos extraídos de uma página do TikTok Shop a partir de uma URL que você fornecer.

**Modos:** síncrono · assíncrono

| Nome           | Tipo             | Obrigatório | Descrição                                                                                                                                                                                    |
| -------------- | ---------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `url`          | string           | sim         | Uma URL de produto ou de busca do TikTok Shop                                                                                                                                                |
| `output`       | array de strings | não         | Formatos a retornar: `markdown`, `html`, `json`, `screenshot`. Padrão `["html"]`. `json` retorna campos analisados. `screenshot` requer `run_js: true`                                       |
| `json`         | objeto           | não         | Extração personalizada: `{"prompt": string}` ou `{"schema": object}`, nunca ambos. Substitui o parser embutido                                                                               |
| `location`     | string           | não         | Código de país de duas letras para buscar, por exemplo `DE`                                                                                                                                  |
| `device`       | string           | não         | `desktop` (padrão) ou `mobile`                                                                                                                                                               |
| `run_js`       | booleano         | não         | Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 120 segundos ou mais                                                                              |
| `callback_url` | string           | não         | URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com `400`                                                                                           |
| `storage`      | objeto           | não         | Entrega o resultado em um bucket em vez da resposta: `{"type": string, "url": string}`. `tipo` é `s3`, `s3_gzip`, `s3_compatible`, `gcs`, ou `tos`. Somente assíncrono. `url` não é validado |

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

Retorna o preço, o estoque e os detalhes de um produto do TikTok Shop.

**Modos:** síncrono · assíncrono

| Nome           | Tipo             | Obrigatório | Descrição                                                                                                                                                                                    |
| -------------- | ---------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`        | string           | sim         | ID do produto                                                                                                                                                                                |
| `country`      | string           | não         | Marketplace nacional a consultar                                                                                                                                                             |
| `uuid`         | string           | não         | Identifica uma listagem específica de produto quando `query` sozinho é ambíguo                                                                                                               |
| `output`       | array de strings | não         | Formatos a retornar: `markdown`, `html`, `json`, `screenshot`. Padrão `["html"]`. `json` retorna campos analisados. `screenshot` requer `run_js: true`                                       |
| `json`         | objeto           | não         | Extração personalizada: `{"prompt": string}` ou `{"schema": object}`, nunca ambos. Substitui o parser embutido                                                                               |
| `location`     | string           | não         | Código de país de duas letras para buscar, por exemplo `DE`                                                                                                                                  |
| `device`       | string           | não         | `desktop` (padrão) ou `mobile`                                                                                                                                                               |
| `run_js`       | booleano         | não         | Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 120 segundos ou mais                                                                              |
| `callback_url` | string           | não         | URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com `400`                                                                                           |
| `storage`      | objeto           | não         | Entrega o resultado em um bucket em vez da resposta: `{"type": string, "url": string}`. `tipo` é `s3`, `s3_gzip`, `s3_compatible`, `gcs`, ou `tos`. Somente assíncrono. `url` não é validado |

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

Retorna resultados de busca do TikTok Shop para uma palavra-chave.

**Modos:** síncrono · assíncrono

| Nome           | Tipo             | Obrigatório | Descrição                                                                                                                                                                                    |
| -------------- | ---------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`        | string           | sim         | Palavra-chave de busca                                                                                                                                                                       |
| `country`      | string           | não         | Marketplace nacional a consultar                                                                                                                                                             |
| `output`       | array de strings | não         | Formatos a retornar: `markdown`, `html`, `json`, `screenshot`. Padrão `["html"]`. `json` retorna campos analisados. `screenshot` requer `run_js: true`                                       |
| `json`         | objeto           | não         | Extração personalizada: `{"prompt": string}` ou `{"schema": object}`, nunca ambos. Substitui o parser embutido                                                                               |
| `location`     | string           | não         | Código de país de duas letras para buscar, por exemplo `DE`                                                                                                                                  |
| `device`       | string           | não         | `desktop` (padrão) ou `mobile`                                                                                                                                                               |
| `run_js`       | booleano         | não         | Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 120 segundos ou mais                                                                              |
| `callback_url` | string           | não         | URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com `400`                                                                                           |
| `storage`      | objeto           | não         | Entrega o resultado em um bucket em vez da resposta: `{"type": string, "url": string}`. `tipo` é `s3`, `s3_gzip`, `s3_compatible`, `gcs`, ou `tos`. Somente assíncrono. `url` não é validado |

TikTok Shop é um marketplace nacional, então ele usa `country` em vez de `store_id`.

***

### Walmart

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

Retorna campos extraídos de uma página do Walmart a partir de uma URL que você fornecer.

**Modos:** síncrono · assíncrono

| Nome               | Tipo             | Obrigatório | Descrição                                                                                                                                                                                    |
| ------------------ | ---------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `url`              | string           | sim         | Uma URL de produto ou de busca do Walmart                                                                                                                                                    |
| `fulfillment_type` | string           | não         | Filtro de entrega, retirada ou envio para casa                                                                                                                                               |
| `store_id`         | string           | não         | A loja cujo catálogo e preços são retornados                                                                                                                                                 |
| `output`           | array de strings | não         | Formatos a retornar: `markdown`, `html`, `json`, `screenshot`. Padrão `["html"]`. `json` retorna campos analisados. `screenshot` requer `run_js: true`                                       |
| `json`             | objeto           | não         | Extração personalizada: `{"prompt": string}` ou `{"schema": object}`, nunca ambos. Substitui o parser embutido                                                                               |
| `location`         | string           | não         | Código de país de duas letras para buscar, por exemplo `DE`                                                                                                                                  |
| `device`           | string           | não         | `desktop` (padrão) ou `mobile`                                                                                                                                                               |
| `run_js`           | booleano         | não         | Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 120 segundos ou mais                                                                              |
| `callback_url`     | string           | não         | URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com `400`                                                                                           |
| `storage`          | objeto           | não         | Entrega o resultado em um bucket em vez da resposta: `{"type": string, "url": string}`. `tipo` é `s3`, `s3_gzip`, `s3_compatible`, `gcs`, ou `tos`. Somente assíncrono. `url` não é validado |

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

Retorna o preço, o estoque e os detalhes de um produto do Walmart.

**Modos:** síncrono · assíncrono

| Nome               | Tipo             | Obrigatório | Descrição                                                                                                                                                                                    |
| ------------------ | ---------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`            | string           | sim         | ID do produto                                                                                                                                                                                |
| `domain`           | string           | não         | TLD da loja                                                                                                                                                                                  |
| `fulfillment_type` | string           | não         | Filtro de entrega, retirada ou envio para casa                                                                                                                                               |
| `store_id`         | string           | não         | A loja cujo catálogo e preços são retornados                                                                                                                                                 |
| `output`           | array de strings | não         | Formatos a retornar: `markdown`, `html`, `json`, `screenshot`. Padrão `["html"]`. `json` retorna campos analisados. `screenshot` requer `run_js: true`                                       |
| `json`             | objeto           | não         | Extração personalizada: `{"prompt": string}` ou `{"schema": object}`, nunca ambos. Substitui o parser embutido                                                                               |
| `location`         | string           | não         | Código de país de duas letras para buscar, por exemplo `DE`                                                                                                                                  |
| `device`           | string           | não         | `desktop` (padrão) ou `mobile`                                                                                                                                                               |
| `run_js`           | booleano         | não         | Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 120 segundos ou mais                                                                              |
| `callback_url`     | string           | não         | URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com `400`                                                                                           |
| `storage`          | objeto           | não         | Entrega o resultado em um bucket em vez da resposta: `{"type": string, "url": string}`. `tipo` é `s3`, `s3_gzip`, `s3_compatible`, `gcs`, ou `tos`. Somente assíncrono. `url` não é validado |

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

Retorna resultados de busca do Walmart para uma palavra-chave.

**Modos:** síncrono · assíncrono

| Nome                | Tipo             | Obrigatório | Descrição                                                                                                                                                                                    |
| ------------------- | ---------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query`             | string           | sim         | Palavra-chave de busca                                                                                                                                                                       |
| `domain`            | string           | não         | TLD da loja                                                                                                                                                                                  |
| `fulfillment_speed` | string           | não         | Velocidade de entrega expressa ou padrão                                                                                                                                                     |
| `fulfillment_type`  | string           | não         | Filtro de entrega, retirada ou envio para casa                                                                                                                                               |
| `max_price`         | inteiro          | não         | Preço máximo a incluir, na moeda do marketplace                                                                                                                                              |
| `min_price`         | inteiro          | não         | Preço mínimo a incluir, na moeda do marketplace                                                                                                                                              |
| `sort_by`           | string           | não         | A própria chave de ordenação do Walmart, repassada literalmente                                                                                                                              |
| `start_page`        | inteiro          | não         | Primeira página de resultados                                                                                                                                                                |
| `store_id`          | string           | não         | A loja cujo catálogo e preços são retornados                                                                                                                                                 |
| `output`            | array de strings | não         | Formatos a retornar: `markdown`, `html`, `json`, `screenshot`. Padrão `["html"]`. `json` retorna campos analisados. `screenshot` requer `run_js: true`                                       |
| `json`              | objeto           | não         | Extração personalizada: `{"prompt": string}` ou `{"schema": object}`, nunca ambos. Substitui o parser embutido                                                                               |
| `location`          | string           | não         | Código de país de duas letras para buscar, por exemplo `DE`                                                                                                                                  |
| `device`            | string           | não         | `desktop` (padrão) ou `mobile`                                                                                                                                                               |
| `run_js`            | booleano         | não         | Executa o JavaScript da página antes da captura. Mais lento — use um timeout do cliente de 120 segundos ou mais                                                                              |
| `callback_url`      | string           | não         | URL de webhook para o job concluído. Somente assíncrono. URLs malformadas são rejeitadas com `400`                                                                                           |
| `storage`           | objeto           | não         | Entrega o resultado em um bucket em vez da resposta: `{"type": string, "url": string}`. `tipo` é `s3`, `s3_gzip`, `s3_compatible`, `gcs`, ou `tos`. Somente assíncrono. `url` não é validado |

`fulfillment_speed` altera tanto o conjunto de itens quanto o preço informado.


---

# 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/pt-br/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.
