> 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/products/pt-br/web-scraper-api.md).

# Web Scraper API

[**Web Scraper API**](https://oxylabs.io/products/scraper-api/web) é uma **solução completa de coleta de dados da web** projetada para extrair dados em tempo real em escala de qualquer site público. Ela cobre todas as etapas do web scraping, desde o rastreamento de URLs e a melhoria das taxas de sucesso de acesso até a análise de dados e a entrega para o armazenamento de sua preferência, para que você não precise gerenciar Proxies, gerenciamento de requisições ou infraestrutura.

A ferramenta foi desenvolvida para atender aos padrões de segurança corporativa, incluindo conformidade com SOC 2 Type II, e oferece infraestrutura de rápida adaptação que se ajusta dinamicamente aos sites de destino para garantir altas taxas de sucesso e extração confiável de dados em mecanismos de busca, sites de e-commerce, plataformas de viagem e mais.

## Primeiros passos

**Crie suas credenciais de usuário da API**: Cadastre-se para uma avaliação gratuita ou compre o produto no [**painel da Oxylabs**](https://dashboard.oxylabs.io/en/registration) para criar suas credenciais de usuário da API (`USERNAME` e `PASSWORD`).

### Exemplos de requisição

A API gerencia a rotação de Proxies, as novas tentativas de requisição e lida com sistemas de monitoramento de bots automaticamente como parte de sua infraestrutura integrada, então uma única requisição é suficiente para recuperar todos os dados estruturados.

Abaixo, você encontrará exemplos de requisições cURL. Para exemplos em outras linguagens de programação, consulte as seções relevantes: [**Amazon**](/api-targets/pt-br/e-commerce/amazon.md), [**Google**](/api-targets/pt-br/motores-de-busca/google.md), [**Outros sites**](/api-targets/pt-br/qualquer-dominio.md).

{% tabs %}
{% tab title="Amazon" %}

```bash
curl 'https://realtime.oxylabs.io/v1/queries' \
--user "USERNAME:PASSWORD" \
-H "Content-Type: application/json" \
-d '{
        "source": "amazon_product",
        "query": "B07FZ8S74R",
        "geo_location": "90210",
        "parse": true
    }'
```

{% endtab %}

{% tab title="Google" %}

```bash
curl 'https://realtime.oxylabs.io/v1/queries' \
--user 'USERNAME:PASSWORD' \
-H 'Content-Type: application/json' \
-d '{
        "source": "google_search",
        "query": "adidas",
        "geo_location": "California,United States",
        "parse": true
    }'
```

{% endtab %}

{% tab title="Outro" %}

```bash
curl 'https://realtime.oxylabs.io/v1/queries' \
--user 'USERNAME:PASSWORD' \
-H 'Content-Type: application/json' \
-d '{
        "source": "universal",
        "url": "https://sandbox.oxylabs.io/"
    }'
```

{% endtab %}
{% endtabs %}

Usamos o método de integração síncrona [**Realtime**](/products/pt-br/web-scraper-api/integration-methods/realtime.md) em nossos exemplos. Se você quiser usar [**Proxy Endpoint**](/products/pt-br/web-scraper-api/integration-methods/proxy-endpoint.md) ou a integração assíncrona [**Push-Pull**](/products/pt-br/web-scraper-api/integration-methods/push-pull.md) , consulte a [**seção de métodos de integração**](/products/pt-br/web-scraper-api/integration-methods.md) .

{% file src="/files/aa07e53fa34659844953e2213963f82d061b9358" %}

{% file src="/files/2428ff0d105abc034f5e9fc288e7bd55bc7ca608" %}

### Valores dos parâmetros da requisição

1. <mark style="background-color:green;">**`source`**</mark> - Este parâmetro define o scraper que será usado para processar sua requisição.
2. <mark style="background-color:green;">**`URL`**</mark> ou <mark style="background-color:green;">**`query`**</mark> - Forneça a `URL` ou `query` para o tipo de página que você quer extrair. Consulte a tabela abaixo e as subpáginas de destino correspondentes para orientações detalhadas sobre quando usar cada parâmetro.
3. Opcionalmente, você pode incluir parâmetros adicionais como `geo_location`, `user_agent_type`, `parse` (encontre a lista dos nossos parsers [**aqui**](/products/pt-br/web-scraper-api/features/result-processing-and-storage/dedicated-parsers.md)), `render` e mais para personalizar sua requisição de scraping. Saiba mais: [**Recursos**](/products/pt-br/web-scraper-api/features.md).

&#x20;    \- parâmetro obrigatório

### Scraping com URLs ou entradas parametrizadas

A Oxylabs oferece suporte a dois grupos gerais de entradas - URLs e entradas parametrizadas como consultas, IDs de produto ou de vídeo. [Alvos genéricos](/api-targets/pt-br/qualquer-dominio.md) que não têm uma source dedicada podem ser extraídos com `universal` source.

<table><thead><tr><th width="217">Destino</th><th width="246">Fonte (URL de scraping)</th><th>Fonte (Usando Query, Product ou Video ID)</th></tr></thead><tbody><tr><td><a href="/spaces/gX8vttpPiyavlcSeOiGz/pages/46f9ad28d24826dcffa1094230cd485773bfaef1"><strong>Amazon</strong></a></td><td><code>amazon</code></td><td><p><code>amazon_product</code>,</p><p><code>amazon_search</code>,</p><p><code>amazon_pricing</code>,</p><p><code>amazon_sellers</code>,</p><p><code>amazon_bestsellers</code></p></td></tr><tr><td><a href="/spaces/gX8vttpPiyavlcSeOiGz/pages/7a124cd3d2ac6d7bd90b758b93df602722bf2157"><strong>Google</strong></a></td><td><code>google</code></td><td><p><code>google_search</code>,</p><p><code>google_ads</code>,</p><p><code>google_ai_mode</code>,</p><p><code>google_lens</code>,</p><p><code>google_maps</code>,</p><p><code>google_travel_hotels</code>,</p><p><code>google_trends_explore</code>,</p><p><code>google_shopping_product</code>,</p><p><code>google_shopping_search</code></p></td></tr><tr><td><a href="/spaces/gX8vttpPiyavlcSeOiGz/pages/36c9f8f91694f38bc79bdc7b3459b7d084153ef0"><strong>Bing</strong></a></td><td><code>bing</code></td><td><code>bing_search</code></td></tr><tr><td><a href="/spaces/gX8vttpPiyavlcSeOiGz/pages/f49652f4b9f2c3674fc9a2ecc1f4162973df2495"><strong>YouTube</strong></a></td><td><code>universal</code></td><td><p><code>youtube_search</code>,</p><p><code>youtube_search_max</code>,</p><p><code>youtube_video_trainability</code>,</p><p><code>youtube_download</code>,</p><p><code>youtube_subtitles</code>,</p><p><code>youtube_metadata</code>,</p><p><code>youtube_channel</code>,</p><p><code>youtube_autocomplete</code></p></td></tr><tr><td><a href="/spaces/gX8vttpPiyavlcSeOiGz/pages/65fa2c7cdb846d7522c1e7e8c5d813ff2316f459"><strong>ChatGPT</strong></a></td><td><code>universal</code></td><td><code>chatgpt</code></td></tr><tr><td><a href="/spaces/gX8vttpPiyavlcSeOiGz/pages/95494c972f48aa60a8d5d1162447e24ef19657f0"><strong>Perplexity</strong></a></td><td><code>universal</code></td><td><code>perplexity</code></td></tr><tr><td><a href="/spaces/gX8vttpPiyavlcSeOiGz/pages/1d6e96cf4a21f1f554460a22871928c9a00fa113"><strong>Walmart</strong></a></td><td><code>walmart</code></td><td><p><code>walmart_search</code>,</p><p><code>walmart_product</code></p></td></tr><tr><td><a href="/spaces/gX8vttpPiyavlcSeOiGz/pages/9d3324f6ecdce7eeefc6b0a5c3cc2d179c1dfe7e"><strong>TikTok</strong></a></td><td><code>universal</code></td><td><p><code>tiktok_shop_search</code>,</p><p><code>tiktok_shop_product</code></p></td></tr><tr><td><a href="/spaces/gX8vttpPiyavlcSeOiGz/pages/ce83ad104c61ec1fca32405202f8203664efd0f0"><strong>eBay</strong></a></td><td><code>ebay</code></td><td><p><code>ebay_search</code>,</p><p><code>ebay_product</code></p></td></tr><tr><td><a href="/spaces/gX8vttpPiyavlcSeOiGz/pages/78b6bebdf265465e3478d51616769fff5dba9d59"><strong>Etsy</strong></a></td><td><code>etsy</code></td><td><p><code>etsy_search</code>,</p><p><code>etsy_product</code></p></td></tr><tr><td><a href="/spaces/gX8vttpPiyavlcSeOiGz/pages/8d1a51fbb6b9e9f581944f09e3d3ea50ec738d09"><strong>Best Buy</strong></a></td><td><code>universal</code></td><td><p><code>bestbuy_search</code>,</p><p><code>bestbuy_product</code></p></td></tr><tr><td><a href="/spaces/gX8vttpPiyavlcSeOiGz/pages/e6cd741aa9178cf6d9f8e063d9ef90733714da7b"><strong>Bed Bath &#x26; Beyond</strong></a></td><td><code>bedbathandbeyond</code></td><td><code>bedbathandbeyond_search</code>,<br><code>bedbathandbeyond_product</code></td></tr><tr><td><a href="/spaces/gX8vttpPiyavlcSeOiGz/pages/21700841c4247d7e1a38d966e3e36493a1be4cda"><strong>Bodega Aurrerá</strong></a></td><td><code>bodegaaurrera</code></td><td><code>bodegaaurrera_search</code>,<br><code>bodegaaurrera_product</code></td></tr><tr><td><a href="/spaces/gX8vttpPiyavlcSeOiGz/pages/148b6fad7b7a8a08a739feb898d04811bcb3ac2b"><strong>Instacart</strong></a></td><td><code>instacart</code></td><td><code>instacart_search</code>,<br><code>instacart_product</code></td></tr><tr><td><a href="/spaces/gX8vttpPiyavlcSeOiGz/pages/32ffe9a99b6e1b4e5e01ae18268916d5d4cfb692"><strong>Kroger</strong></a></td><td><code>kroger</code></td><td><p><code>kroger_search</code>,</p><p><code>kroger_product</code></p></td></tr><tr><td><a href="/spaces/gX8vttpPiyavlcSeOiGz/pages/d802fb7b82fe2183e86783105b357c541a7d4630"><strong>Lowe's</strong></a></td><td><code>lowes</code></td><td><p><code>lowes_search</code>,</p><p><code>lowes_product</code></p></td></tr><tr><td><a href="/spaces/gX8vttpPiyavlcSeOiGz/pages/75b13beede1c683e7c38930e6f0c3cb5699032f1"><strong>Publix</strong></a></td><td><code>publix</code></td><td><code>publix_search</code>,<br><code>publix_product</code></td></tr><tr><td><a href="/spaces/gX8vttpPiyavlcSeOiGz/pages/1d394d45c1b6c43ba727011108b03c7d2501b172"><strong>Destino</strong></a></td><td><code>target</code></td><td><p><code>target_search</code>,</p><p><code>target_product</code>,</p><p><code>target_category</code></p></td></tr><tr><td><a href="/spaces/gX8vttpPiyavlcSeOiGz/pages/6c389130445255a53c001f5a6057db83e8e42b4d"><strong>Grainger</strong></a></td><td><code>grainger</code></td><td><code>grainger_search</code>,<br><code>grainger_product</code></td></tr><tr><td><a href="/spaces/gX8vttpPiyavlcSeOiGz/pages/ff709ab4f3d2ec09e08dbc6403f4a3b67de930d5"><strong>Costco</strong></a></td><td><code>costco</code></td><td><p><code>costco_search</code>,</p><p><code>costco_product</code></p></td></tr><tr><td><a href="/spaces/gX8vttpPiyavlcSeOiGz/pages/b7853ee38f68328db17915517444c33c418177f5"><strong>Menards</strong></a></td><td><code>menards</code></td><td><code>menards_search</code>,<br><code>menards_product</code></td></tr><tr><td><a href="/spaces/gX8vttpPiyavlcSeOiGz/pages/f67d1a80856fdb9f7c4738dc3275b4cd43dd42a5"><strong>Petco</strong></a></td><td><code>universal</code></td><td><code>petco_search</code></td></tr><tr><td><a href="/spaces/gX8vttpPiyavlcSeOiGz/pages/e9d86fd0a988d81eee9868b4513a8a93f5ddb8bb"><strong>Staples</strong></a></td><td><code>universal</code></td><td><code>staples_search</code></td></tr><tr><td><a href="/spaces/gX8vttpPiyavlcSeOiGz/pages/f9d4fb0f242113112db9da5b55f0e80ac8adbfe8"><strong>Allegro</strong></a></td><td><code>universal</code></td><td><p><code>allegro_search</code>,</p><p><code>allegro_product</code></p></td></tr><tr><td><a href="/spaces/gX8vttpPiyavlcSeOiGz/pages/616fa73d92b31b5bca96bd3afebe9f9e70f634bd"><strong>Idealo</strong></a></td><td><code>universal</code></td><td><code>idealo_search</code></td></tr><tr><td><a href="/spaces/gX8vttpPiyavlcSeOiGz/pages/13e14b5d8767a06e02ca096b77ce66d40b63ffbf"><strong>MediaMarkt</strong></a></td><td><code>mediamarkt</code></td><td><code>mediamarkt_search</code>,<br><code>mediamarkt_product</code></td></tr><tr><td><a href="/spaces/gX8vttpPiyavlcSeOiGz/pages/956902361f911e0fd65f1f1ca6f2b29fa3e9bbb2"><strong>Cdiscount</strong></a></td><td><code>cdiscount</code></td><td><code>cdiscount_search</code>,<br><code>cdiscount_product</code></td></tr><tr><td><a href="/spaces/gX8vttpPiyavlcSeOiGz/pages/5e5ae9f4afca03d2065a1dd0a4b36b5f8d69b24c"><strong>Alibaba</strong></a></td><td><code>alibaba</code></td><td><code>alibaba_search</code>,<br><code>alibaba_product</code></td></tr><tr><td><a href="/spaces/gX8vttpPiyavlcSeOiGz/pages/c1b7e4f2aceecf6cd41e37b54f7ddd4702ee2d76"><strong>AliExpress</strong></a></td><td><code>aliexpress</code></td><td><code>aliexpress_search</code>,<br><code>aliexpress_product</code></td></tr><tr><td><a href="/spaces/gX8vttpPiyavlcSeOiGz/pages/af4224917ad7d240d8c2a9e54b2772fec712e221"><strong>IndiaMART</strong></a></td><td><code>indiamart</code></td><td><code>indiamart_search</code>,<br><code>indiamart_product</code></td></tr><tr><td><a href="/spaces/gX8vttpPiyavlcSeOiGz/pages/baf18f5948db87d3e3f9ff60e614b70638b1fad6"><strong>Avnet</strong></a></td><td><code>universal</code></td><td><code>avnet_search</code></td></tr><tr><td><a href="/spaces/gX8vttpPiyavlcSeOiGz/pages/1a995ad76da9bb9dd10b18583c499937922ecd0a"><strong>Lazada</strong></a></td><td><code>lazada</code></td><td><code>lazada_search</code>,<br><code>lazada_product</code></td></tr><tr><td><a href="/spaces/gX8vttpPiyavlcSeOiGz/pages/0163c00728d7990312d865a64c47a44c953bf2bb"><strong>Rakuten</strong></a></td><td><code>universal</code></td><td><code>rakuten_search</code></td></tr><tr><td><a href="/spaces/gX8vttpPiyavlcSeOiGz/pages/41da9cd6b70d1c4779d41fca7820b5a60350409b"><strong>Tokopedia</strong></a></td><td><code>universal</code></td><td><code>tokopedia_search</code></td></tr><tr><td><a href="/spaces/gX8vttpPiyavlcSeOiGz/pages/920a57574b544622434a5143198ca94c2b721f03"><strong>Flipkart</strong></a></td><td><code>flipkart</code></td><td><code>flipkart_search</code>,<br><code>flipkart_product</code></td></tr><tr><td><a href="/spaces/gX8vttpPiyavlcSeOiGz/pages/2a823b9ee3380a033e0d12170335d4e043ec441f"><strong>MercadoLibre</strong></a></td><td><code>universal</code></td><td><code>mercadolibre_search</code></td></tr><tr><td><a href="/spaces/gX8vttpPiyavlcSeOiGz/pages/a53a3b6498910533b1d22e064ea0170816e89ecc"><strong>Mercado Livre</strong></a></td><td><code>universal</code></td><td><code>mercadolivre_search</code></td></tr><tr><td><a href="/spaces/gX8vttpPiyavlcSeOiGz/pages/4a9dff9b55b930d6ce16cafb1e7f23318a4e70d1"><strong>Magazine Luiza</strong></a></td><td><code>magazineluiza</code></td><td><code>magazineluiza_search</code>,<br><code>magazineluiza_product</code></td></tr><tr><td><a href="/spaces/gX8vttpPiyavlcSeOiGz/pages/e5a76c29df2b05a776f5eb0e4c216e45ed015ec5"><strong>Falabella</strong></a></td><td><code>falabella</code></td><td><code>falabella_search</code>,<br><code>falabella_product</code></td></tr><tr><td><a href="/spaces/gX8vttpPiyavlcSeOiGz/pages/7594cf80d980645bc973c0c89dbc36f1db77b256"><strong>Dcard</strong></a></td><td><code>universal</code></td><td><code>dcard_search</code></td></tr><tr><td><a href="/spaces/gX8vttpPiyavlcSeOiGz/pages/1a262d154f6ce863109952ea8bc9a76a793b0e38"><strong>Airbnb</strong></a></td><td><code>airbnb</code></td><td><code>airbnb_product</code></td></tr><tr><td><a href="/spaces/gX8vttpPiyavlcSeOiGz/pages/ffd334d0640f439da45966b8365d5d244769f741"><strong>Zillow</strong></a></td><td><code>zillow</code></td><td>Usando <code>query</code> parâmetro não suportado</td></tr><tr><td><a href="/spaces/gX8vttpPiyavlcSeOiGz/pages/36ac46d8ba740c64335d63fada518eb5d3b25f02"><strong>Outros sites</strong></a></td><td><code>universal</code></td><td>Usando <code>query</code> parâmetro não suportado</td></tr></tbody></table>

{% hint style="info" %}
Se você precisar de ajuda para fazer sua primeira requisição ou otimizar sua configuração, nossa equipe de suporte especializada 24/7 está disponível via chat ao vivo.
{% endhint %}

## Testando via Scraper APIs Playground

Experimente [**Web Scraper API**](https://oxylabs.io/products/scraper-api/web) e [**OxyCopilot**](https://oxylabs.io/products/scraper-api/ai-web-scraper-copilot) no [**Scraper APIs Playground**](https://dashboard.oxylabs.io/?route=/api-playground).

{% embed url="<https://www.youtube.com/watch?v=kDhknxrod6U>" %}

{% embed url="<https://youtu.be/9JoF8_5r5HY?si=61c3Zkx6FrH06PVa>" %}

## Testando via Postman

Comece a usar nossa API com o Postman, uma ferramenta útil para fazer requisições HTTP. Baixe nossa [**Web Scraper API Postman collection**](https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzrXw45naRpCZ0Ku9AjY1%2Fuploads%2FMeGA0TZQMcAFHoVhRSQi%2FWeb%20Scraper%20API.new_postman_collection.json?alt=media\&token=9f51d41b-6604-4eef-b6c1-5024cf52c5bf) e importe-a. Esta coleção inclui exemplos que demonstram a funcionalidade do scraper. Personalize os exemplos conforme suas necessidades ou comece a extrair dados imediatamente.

Para instruções passo a passo, assista ao nosso vídeo tutorial abaixo. Se você é novo no Postman, confira este breve [**guia**](/integrations/pt-br/integracoes-da-web-scraper-api/postman.md).

{% embed url="<https://www.youtube.com/watch?v=WOD0mZnu-j0>" %}

{% hint style="info" %}
*Todas as informações aqui fornecidas são disponibilizadas "no estado em que se encontram" e apenas para fins informativos. Não fazemos nenhuma declaração e nos isentamos de toda responsabilidade em relação ao seu uso de qualquer informação contida nesta página. Antes de realizar atividades de scraping de qualquer tipo, você deve consultar seus assessores jurídicos e ler cuidadosamente os termos de serviço do site específico ou obter uma licença de scraping.*
{% endhint %}


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://developers.oxylabs.io/products/pt-br/web-scraper-api.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.