> 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

Aprenda a usar Web Scraper API e faça scraping de qualquer site público de que precisar. Encontre exemplos de código, uso de parâmetros, localização, alvos e muito mais.

[**Web Scraper API**](https://oxylabs.io/products/scraper-api/web) é uma **solução completa para 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 ao armazenamento de sua preferência, para que você não precise gerenciar Proxies, o gerenciamento de requisições ou a infraestrutura.

A ferramenta foi construída 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-alvo 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 muito mais.

## Primeiros passos

**Crie suas credenciais de usuário da API**: Cadastre-se para um teste gratuito ou compre o produto na [**Oxylabs dashboard**](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 rotação de Proxies, novas tentativas de solicitação e lida com sistemas de monitoramento de bots automaticamente como parte de sua infraestrutura integrada, então uma única solicitaçã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/search-engines/google.md), [**Outros sites**](https://developers.oxylabs.io/api-targets/pt-br/).

{% 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="Outros" %}

```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 a 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) integração, 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 solicitação.
2. <mark style="background-color:green;">**`URL`**</mark> ou <mark style="background-color:green;">**`query`**</mark> - Forneça o `URL` ou `query` source para o tipo de página que você deseja extrair. Consulte a tabela abaixo e as subpáginas-alvo correspondentes para orientação detalhada 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 analisadores [**aqui**](/products/pt-br/web-scraper-api/features/result-processing-and-storage/dedicated-parsers.md)), `render` e outros para personalizar sua solicitaçã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 oferece suporte a dois grupos gerais de entradas - URLs e entradas parametrizadas como consultas, IDs de produto ou vídeo. [Alvos genéricos](https://developers.oxylabs.io/api-targets/pt-br/) que não têm uma source dedicada podem ser coletados com `universal` source.

<table><thead><tr><th width="217">Alvo</th><th width="246">Origem (URL de scraping)</th><th>Origem (Usando Query, Product ou Video ID)</th></tr></thead><tbody><tr><td><a href="/api-targets/pt-br/e-commerce/amazon.md"><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="/api-targets/pt-br/search-engines/google.md"><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="/api-targets/pt-br/search-engines/bing.md"><strong>Bing</strong></a></td><td><code>bing</code></td><td><code>bing_search</code></td></tr><tr><td><a href="/api-targets/pt-br/video-and-social-media/youtube.md"><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="/api-targets/pt-br/llms-and-ai/chatgpt.md"><strong>ChatGPT</strong></a></td><td><code>universal</code></td><td><code>chatgpt</code></td></tr><tr><td><a href="/api-targets/pt-br/llms-and-ai/perplexity.md"><strong>Perplexity</strong></a></td><td><code>universal</code></td><td><code>perplexity</code></td></tr><tr><td><a href="/api-targets/pt-br/e-commerce/walmart.md"><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="/api-targets/pt-br/e-commerce/tiktok.md"><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="/api-targets/pt-br/e-commerce/ebay.md"><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="/api-targets/pt-br/e-commerce/etsy.md"><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="/api-targets/pt-br/e-commerce/bestbuy.md"><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="/api-targets/pt-br/e-commerce/bedbathandbeyond.md"><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="/api-targets/pt-br/e-commerce/bodega-aurrera.md"><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="/api-targets/pt-br/e-commerce/instacart.md"><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="/api-targets/pt-br/e-commerce/kroger.md"><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="/api-targets/pt-br/e-commerce/lowes.md"><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="/api-targets/pt-br/e-commerce/publix.md"><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="/api-targets/pt-br/e-commerce/target.md"><strong>Alvo</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="/api-targets/pt-br/e-commerce/grainger.md"><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="/api-targets/pt-br/e-commerce/costco.md"><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="/api-targets/pt-br/e-commerce/menards.md"><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="/api-targets/pt-br/e-commerce/petco.md"><strong>Petco</strong></a></td><td><code>universal</code></td><td><code>petco_search</code></td></tr><tr><td><a href="/api-targets/pt-br/e-commerce/staples.md"><strong>Staples</strong></a></td><td><code>universal</code></td><td><code>staples_search</code></td></tr><tr><td><a href="/api-targets/pt-br/e-commerce/allegro.md"><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="/api-targets/pt-br/e-commerce/idealo.md"><strong>Idealo</strong></a></td><td><code>universal</code></td><td><code>idealo_search</code></td></tr><tr><td><a href="/api-targets/pt-br/e-commerce/mediamarkt.md"><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="/api-targets/pt-br/e-commerce/cdiscount.md"><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="/api-targets/pt-br/e-commerce/alibaba.md"><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="/api-targets/pt-br/e-commerce/aliexpress.md"><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="/api-targets/pt-br/e-commerce/indiamart.md"><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="/api-targets/pt-br/e-commerce/avnet.md"><strong>Avnet</strong></a></td><td><code>universal</code></td><td><code>avnet_search</code></td></tr><tr><td><a href="/api-targets/pt-br/e-commerce/lazada.md"><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="/api-targets/pt-br/e-commerce/rakuten.md"><strong>Rakuten</strong></a></td><td><code>universal</code></td><td><code>rakuten_search</code></td></tr><tr><td><a href="/api-targets/pt-br/e-commerce/tokopedia.md"><strong>Tokopedia</strong></a></td><td><code>universal</code></td><td><code>tokopedia_search</code></td></tr><tr><td><a href="/api-targets/pt-br/e-commerce/flipkart.md"><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="/api-targets/pt-br/e-commerce/mercado-libre.md"><strong>MercadoLibre</strong></a></td><td><code>universal</code></td><td><code>mercadolibre_search</code></td></tr><tr><td><a href="/api-targets/pt-br/e-commerce/mercado-livre.md"><strong>Mercado Livre</strong></a></td><td><code>universal</code></td><td><code>mercadolivre_search</code></td></tr><tr><td><a href="/api-targets/pt-br/e-commerce/magazineluiza.md"><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="/api-targets/pt-br/e-commerce/falabella.md"><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="/api-targets/pt-br/e-commerce/dcard.md"><strong>Dcard</strong></a></td><td><code>universal</code></td><td><code>dcard_search</code></td></tr><tr><td><a href="/api-targets/pt-br/real-estate/airbnb.md"><strong>Airbnb</strong></a></td><td><code>airbnb</code></td><td><code>airbnb_product</code></td></tr><tr><td><a href="/api-targets/pt-br/real-estate/zillow.md"><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="https://developers.oxylabs.io/api-targets/pt-br/"><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 solicitaçã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 [**coleção do Web Scraper API para Postman**](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 coletar dados imediatamente.

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

{% 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 fazemos nenhuma declaração e nos isentamos de toda responsabilidade em relação ao 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.