Início rápido: Web Scraper API

Comece a usar o 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 tudo-em-um que lida com rotação de proxy, renderização JavaScript e sistemas antibot automaticamente. 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 passo a passo em vídeo:

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á para a seção "Web Scraper API" à esquerda e selecione a aba "Users".
4. Armazene suas credenciais: Estas 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

O universal fonte funciona para qualquer site público. Abra seu terminal e execute este comando para extrair dados do nosso site sandbox:

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

3

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 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
source	cadeia de caracteres	Obrigatório. O mecanismo de scraping (por exemplo, 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 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 documentação do Web Scraper API documentação ou alvos da API 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 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ó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 API Targets seção para guias dedicados sobre Amazon, Google, eBay e muitos outros sites populares.
• Precisa de recursos avançados? Visite a Products área para saber mais sobre Custom Parsing, Scheduler, entrega para 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.
• Diferentes integrações? Usamos integração Realtime síncrona em nossos exemplos. Você pode encontrar Proxy Endpoint ou integração assíncrona Push-Pull na página de métodos de integração .