Início rápido: Web Scraper API

Comece a usar a Web Scraper API da Oxylabs em apenas alguns minutos com um guia simples passo a passo.

Já está familiarizado com o básico? Confira documentação do Web Scraper API ou nosso prático hub de integração.

Oxylabs Web Scraper API é 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 a dados da web em tempo real em apenas alguns minutos.

Siga as etapas detalhadas abaixo ou assista a um rápido vídeo demonstrativo:

1

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.

2. Escolha um plano: Escolha um teste gratuito para testar ou uma assinatura imediatamente.

3. Crie um usuário de API: Vá até a seção "Web Scraper API" à esquerda e selecione a aba "Usuários".

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.

2

Sua primeira solicitação

A origem universal funciona para qualquer site público. Abra seu terminal e execute este comando para coletar dados do nosso site sandbox:

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

3

Obtendo dados estruturados

Se você estiver fazendo scraping de um domínio compatível (como Amazon ou Google), a API pode retornar JSON estruturado em vez de HTML bruto. Basta definir a origem para um alvo dedicado e use "parse": true. Por exemplo, vamos fazer scraping de um produto da Amazon:

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

Parâmetros essenciais

Estes são os parâmetros mais comuns usados para personalizar sua solicitação:

Parâmetro	Tipo	Descrição
origem	cadeia de caracteres	Obrigatório. O mecanismo de scraping (ex.: origem universal, amazon, google, etc.).
url / query	cadeia de caracteres	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	cadeia de caracteres	Defina como HTML para ativar um navegador headless em sites com muito JavaScript.
geo_location	cadeia de caracteres	Localize seus resultados (ex.: Estados Unidos ou 90210).

Você pode encontrar mais parâmetros personalizáveis na documentação ou API Targets seção.

Códigos de resposta comuns

Código	Status	Descrição
200	OK	Sucesso. Seus dados estão no objeto results .
401	Não autorizado	Verifique as credenciais do seu usuário de 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 na seção do produto Web Scraper API.

Próximas etapas

Agora que você enviou sua primeira consulta, explore o restante da nossa documentação conforme sua necessidade:

• Procurando domínios específicos? Acesse a API Targets seção para guias dedicados sobre Amazon, Google, eBay e muitos outros sites populares.

• Precisa de recursos avançados? Visite o Produtos espaço para saber mais sobre Custom Parsing, Scheduler, entrega em Cloud Storage e muito mais.

• Escalar com IA? Confira soluções para fluxos de trabalho de IA ou veja como OxyCopilot 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 Proxy Endpoint ou integração Push-Pull assíncrona na página de métodos de integração .