Docs › Primeiros passos › Início Rápido

Início Rápido

Vá do zero à sua primeira coleta de dados em menos de dois minutos.

Pré-requisitos

Passo 1: Obtenha Sua Chave de API

Faça login no Dashboard e crie uma chave de API. Ela se parece com isto: pk_live_a1b2c3d4e5f6...

Copie-a. Você precisará dela para cada request.

Passo 2: Faça Seu Primeiro Request

Abra um terminal e execute isto (substitua YOUR_API_KEY pela sua chave real):

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"}'

Isso envia um request HTTP para example.com e retorna o HTML da página.

Passo 3: Leia o Response

{
  "status": 200,
  "headers": [
    {
      "result": { "version": "HTTP/2", "code": 200, "reason": "" },
      "content-type": "text/html; charset=UTF-8",
      "content-length": "1256"
    }
  ],
  "data": "<!doctype html><html>...</html>",
  "total_time": 0.45
}

O campo headers é um array de objetos, um por salto de redirecionamento. Cada entrada tem um campo result com a linha de status mais cada header de response que o alvo retornou para aquele salto.

Campos principais:

  • status: código de status HTTP do site alvo
  • data: o corpo do response (HTML, JSON ou texto bruto)
  • total_time: duração do request em segundos

Passo 4: Tente Diferentes Endpoints

A FourA possui quatro endpoints para diferentes situações:

Endpoint Velocidade Quando usar
POST /api/auto/ Variável (rápido em hosts quentes) Você não sabe qual motor o site precisa. Passe uma URL e deixe a FourA escolher o caminho mais barato que funcione.
POST /api/single/ Mais rápido (200ms-2s) Páginas estáticas, APIs, sites renderizados no servidor
POST /api/browser/ Média (2s-10s) Páginas com muito JavaScript, SPAs, conteúdo dinâmico
POST /api/proxy/ Rápida (1s-5s) Sites com detecção de bot, conteúdo com restrição geográfica

Tente um request auto (o padrão inteligente):

curl -X POST https://eu.api.foura.ai/api/auto/ \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/product/42",
    "validate": {"data": {"accept": ["Add to cart"]}}
  }'

Tente um request browser:

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", "timeout_ms": 15000}'

Tente um request proxy (rotação automática de proxy):

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

Próximos Passos

Atualizado em: 1 de julho de 2026
Autenticação →