# 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 grande escala de qualquer site público. Ela cobre todas as etapas do web scraping, desde o rastreamento de URLs e a contornação de bloqueios de IP até o parsing de dados e a entrega para o seu armazenamento preferido, para que você não precise gerenciar proxies, desbloqueio ou infraestrutura.

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

## Começando

**Crie suas credenciais de usuário da API**: Cadastre-se para um teste grátis 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`).

{% hint style="warning" %}
Se você precisar de mais de um usuário de API para sua conta, entre em contato com nosso [**suporte ao cliente**](mailto:support@oxylabs.io) ou envie uma mensagem para nosso suporte por chat ao vivo 24/7.
{% endhint %}

### Solicitar exemplos

A API lida automaticamente com rotação de proxy, repetição de requisições e contorno de anti-bot 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/mecanismos-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 integração assíncrona [**Push-Pull**](/products/pt-br/web-scraper-api/integration-methods/push-pull.md) , consulte a seção [**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 o `URL` ou `query` para o tipo de página que você deseja 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. Leia mais: [**Recursos**](/products/pt-br/web-scraper-api/features.md).

\- parâmetro obrigatório

### Extração com URLs ou entradas parametrizadas

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

<table><thead><tr><th width="217">Destino</th><th width="246">Source (URL de scraping)</th><th>Source (Usando Query, ID de Produto ou Vídeo)</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_transcript</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> o 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> o 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 especializado 24/7 está disponível via chat ao vivo.
{% endhint %}

## Teste 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>" %}

## Teste via Postman

Comece a usar nossa API com o Postman, uma ferramenta útil para fazer requisições HTTP. Baixe nossa [**coleção do Postman do Web Scraper API**](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 agora mesmo.

Para instruções passo a passo, assista ao nosso tutorial em vídeo abaixo. Se você é novo no Postman, confira este breve [**guia**](broken://spaces/0ejViy9b0hpEq5P8gbMb/pages/d4243dc2129737ba75887447d05c21bbd9b0e017).

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

{% hint style="info" %}
*Todas as informações aqui contidas são fornecidas "no estado em que se encontram" e apenas para fins informativos. Não oferecemos nenhuma declaração e isentamo-nos 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 atentamente os termos de serviço do site específico ou obter uma licença de scraping.*
{% endhint %}


---

# Agent Instructions: 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:

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

The question should be specific, self-contained, and written in natural language.
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.