> 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/documentation/pt-br/comecar/inicio-rapido-web-scraper-api.md). # Início rápido: Web Scraper API {% hint style="success" %} Já está familiarizado com o básico? Confira [a documentação do Web Scraper API](/products/pt-br/web-scraper-api.md) ou nosso prático [Hub de integração](/integrations/pt-br/integracoes-do-web-scraper-api.md). {% endhint %} Oxylabs [Web Scraper API](https://oxylabs.io/products/scraper-api/web) é uma solução completa que lida automaticamente com rotação de proxy, renderização de JavaScript e sistemas anti-bot. Este guia levará você de um terminal vazio a dados da web em tempo real em apenas alguns minutos. Siga os passos detalhados abaixo ou assista a um rápido passo a passo em vídeo: {% embed url="" %} {% stepper %} {% step %} ### Configuração e credenciais Antes de enviar sua primeira requisição, você precisa autorizar seu acesso: 1. **Crie uma conta:** Cadastre-se no [Painel da Oxylabs](https://dashboard.oxylabs.io/). 2. **Escolha um plano:** Escolha um teste gratuito para testar ou uma assinatura imediatamente. 3. **Crie um usuário da API:** Vá para a seção "Web Scraper API" à esquerda e selecione a aba "Users". 4. **Guarde suas credenciais:** Essas credenciais específicas da API (não seu login do painel) são necessárias para todas as requisições. {% endstep %} {% step %} ### Sua primeira requisição O `universal` source funciona para qualquer site público. Abra seu terminal e execute este comando para extrair dados do nosso site sandbox: ```bash curl 'https://realtime.oxylabs.io/v1/queries' \\ --user 'USERNAME:PASSWORD' \\ -H 'Content-Type: application/json' \\ -d '{ "source": "universal", "url": "https://sandbox.oxylabs.io/products" }' ``` {% endstep %} {% step %} ### Obtendo dados estruturados Se você estiver extraindo dados de um domínio compatível (como Amazon ou Google), a API pode retornar JSON estruturado em vez de HTML bruto. Basta definir o `source` para um alvo dedicado e usar `"parse": true`. Por exemplo, vamos extrair dados de um produto da Amazon: ```bash curl 'https://realtime.oxylabs.io/v1/queries' \\ --user 'USERNAME:PASSWORD' \\ -H 'Content-Type: application/json' \\ -d '{ "source": "amazon_product", "query": "B07FZ8S74R", "parse": true }' ``` {% endstep %} {% endstepper %} ### Parâmetros essenciais Estes são os parâmetros mais comuns usados para personalizar sua requisição: | Parâmetro | Tipo | Descrição | | --------------- | -------- | ------------------------------------------------------------------------------------------ | | `source` | texto | Obrigatório. O mecanismo de extração (por exemplo, `universal`, `amazon`, `google`, etc.). | | `url` / `query` | texto | O link de destino ou a palavra-chave/ID para alvos dedicados. | | `parse` | booleano | Defina como `true` para resultados JSON estruturados em domínios compatíveis. | | `render` | texto | Defina como `HTML` para habilitar um Headless Browser para sites com muito JavaScript. | | `geo_location` | texto | Localize seus resultados (por exemplo, `Estados Unidos` ou `90210`). | Você pode encontrar mais parâmetros personalizáveis na Web Scraper API [documentação](/products/pt-br/web-scraper-api.md) ou [Alvos da API](/api-targets/pt-br/qualquer-dominio.md) seção. ### Códigos de resposta comuns | Código | Status | Descrição | | ------ | -------------------- | ----------------------------------------------------- | | `200` | `OK` | Sucesso. Seus dados estão no `results` objeto. | | `401` | `Não autorizado` | Verifique as credenciais do usuário da API no painel. | | `429` | `Muitas requisições` | Você excedeu seu limite de concorrência. | Você pode encontrar a [lista completa de códigos de resposta](/products/pt-br/web-scraper-api/response-codes.md) na seção de produto do Web Scraper API. ### Próximos passos Agora que você enviou sua primeira consulta, explore o restante da nossa documentação conforme suas necessidades: * **Procurando domínios específicos?** Vá para a [Alvos da API](https://developers.oxylabs.io/api-targets/pt-br/) seção com guias específicos para Amazon, Google, eBay e muitos outros sites populares. * **Precisa de recursos avançados?** Visite o [Produtos](/products/pt-br/web-scraper-api.md) espaço para aprender sobre Custom Parsing, Scheduler, entrega em Cloud Storage e muito mais. * **Escalar com IA?** Confira [soluções para fluxos de trabalho de IA](/products/pt-br/web-scraper-api/solutions-for-ai-workflows.md) ou veja como [OxyCopilot](/products/pt-br/web-scraper-api/web-scraper-api-playground/oxycopilot.md) pode automatizar sua lógica de parsing usando inglês simples. * **Integrações diferentes?** Usamos integração Realtime síncrona em nossos exemplos. Você pode encontrar integração Proxy Endpoint ou Push-Pull assíncrona na [página de métodos de integração](/integrations/pt-br/integracoes-do-web-scraper-api.md) página. --- # 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/documentation/pt-br/comecar/inicio-rapido-web-scraper-api.md?ask=&goal= ``` `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.