Escolher o Endpoint Certo

FourA oferece três endpoints de API, cada um otimizado para diferentes cenários. Escolher o correto economiza tempo, reduz custos e melhora as taxas de sucesso.

Guia de Decisão Rápida

Use o endpoint single quando:

• A página de destino é renderizada no servidor (sem necessidade de JavaScript)
• Você precisa de velocidade máxima (geralmente abaixo de 1 segundo)
• Você está coletando dados de APIs ou páginas HTML estáticas

Use o endpoint browser quando:

• A página depende de JavaScript para renderizar o conteúdo
• O conteúdo é carregado dinamicamente após o carregamento inicial da página
• Você precisa do DOM totalmente renderizado

Use o endpoint proxy quando:

• O site de destino bloqueia ativamente as requests
• Você precisa rotacionar por múltiplos endereços de IP
• Tentativas anteriores retornaram páginas 403 ou CAPTCHA

Comparação de Endpoints

Single (POST /api/single/)

A opção mais rápida. Envia uma request HTTP com características de rede realistas semelhantes às de um navegador, sem iniciar um processo de navegador.

curl -X POST https://eu.api.foura.ai/api/single/ \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"method": "GET", "url": "https://example.com/api/products", "unblocker": true}'

Tempo de response típico: 200ms a 2s Melhor para: APIs, sites de notícias, blogs, páginas de produtos estáticas

Browser (POST /api/browser/)

Abre sua URL em uma instância do navegador Chrome. A página é carregada completamente, o JavaScript é executado e você obtém o HTML renderizado final.

curl -X POST https://eu.api.foura.ai/api/browser/ \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/spa-app",
    "timeout_ms": 15000,
    "checkText": "data-table"
  }'

Tempo de response típico: 2s a 10s Melhor para: Single-page apps (SPAs), sites com lazy loading, conteúdo renderizado por JavaScript

Proxy (POST /api/proxy/)

Combina requests HTTP com rotação automática de proxy. Se a primeira tentativa falhar ou for bloqueada, o FourA tenta novamente através de diferentes proxies.

curl -X POST https://eu.api.foura.ai/api/proxy/ \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "maxTries": 5,
    "request": {
      "method": "GET",
      "url": "https://example.com/pricing",
      "unblocker": true
    }
  }'

Tempo de response típico: 1s a 5s Melhor para: Monitoramento de preços de e-commerce, agregadores de viagens, sites com detecção de bots

Quando Combinar Abordagens

Alguns fluxos de trabalho se beneficiam do uso de múltiplos endpoints:

1. Comece com o single: teste se a página retorna dados úteis sem um navegador.
2. Recorra ao browser: se a response estiver vazia ou com conteúdo ausente, mude para a renderização de browser.
3. Adicione proxy: se você estiver sendo bloqueado (403/captcha), envolva sua request no endpoint proxy para rotação automática de IP.

Esta abordagem progressiva mantém os custos baixos enquanto maximiza as taxas de sucesso.

Dicas de Desempenho

• Use o endpoint single por padrão e faça o upgrade apenas quando necessário
• Defina checkText em requests de browser para evitar esperar por conteúdo desnecessário
• Defina maxTries em requests de proxy para controlar o comportamento de repetição (o padrão é 5, o máximo é 90)
• Mantenha os valores de timeout_ms razoáveis: 10 a 15 segundos para a maioria das páginas

Próximos Passos

• API Endpoints: Referência completa de parâmetros
• Extrair Dados de um Website Dinâmico: Guia passo a passo de request de browser
• Início Rápido: Sua primeira request em 30 segundos