> 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 [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 vai levar você de um terminal vazio até dados web em tempo real em apenas alguns minutos. Siga os passos detalhados abaixo ou assista a um rápido vídeo de demonstração: {% embed url="" %} {% stepper %} {% step %} ### Configuração e credenciais Antes de enviar sua primeira solicitaçã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 grátis para testar ou uma assinatura imediatamente. 3. **Crie um usuário de API:** Vá para a seção "Web Scraper API" à esquerda e selecione a aba "Users". 4. **Armazene suas credenciais:** Essas credenciais específicas da API (não seu login do painel) são necessárias para todas as solicitações. {% endstep %} {% step %} ### Sua primeira solicitação O `universal` source funciona para qualquer site público. Abra seu terminal e execute este comando para raspar nosso site sandbox: ```bash curl --user 'USERNAME:PASSWORD' \\ 'https://realtime.oxylabs.io/v1/queries' \\ -H 'Content-Type: application/json' \\ -d '{ "source": "universal", "url": "https://sandbox.oxylabs.io/products" }' ``` {% endstep %} {% step %} ### Obtendo dados estruturados Se você estiver raspando 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 raspar 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 solicitação: | Parâmetro | Tipo | Descrição | | --------------- | -------------------- | ------------------------------------------------------------------------------------------ | | `source` | cadeia de caracteres | Obrigatório. O mecanismo de raspagem (por exemplo, `universal`, `amazon`, `google`, etc.). | | `url` / `query` | cadeia de caracteres | O link de destino ou a palavra-chave/ID para destinos dedicados. | | `parse` | booleano | Defina como `true` para resultados JSON estruturados em domínios compatíveis. | | `render` | cadeia de caracteres | Defina como `html` para ativar um Headless Browser para sites com muito JavaScript. | | `geo_location` | cadeia de caracteres | 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 suas credenciais de usuário da API no painel. | | `429` | `Muitas solicitaçõ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 do produto Web Scraper API. ### Próximos passos Agora que você enviou sua primeira consulta, explore o restante da nossa documentação de acordo com suas necessidades: * **Procurando domínios específicos?** Acesse a [alvos da API](https://developers.oxylabs.io/api-targets/pt-br/) seção para guias dedicados sobre 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 saber mais sobre Análise personalizada, Scheduler, entrega no 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 análise usando inglês simples. * **Integrações diferentes?** Usamos integração Realtime síncrona em nossos exemplos. Você pode encontrar Proxy Endpoint ou integração 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.