# Início Rápido

> URL: https://foura.ai/pt/docs/getting-started/quick-start
> Updated: 2026-09-27
> Index: https://foura.ai/llms.txt

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

## Pré-requisitos

- Uma conta FourA ([cadastre-se aqui](https://foura.ai))
- Sua API key (crie uma no [Dashboard](https://foura.ai/dashboard))

## Passo 1: Obtenha sua API Key

Faça login no [Dashboard](https://foura.ai/dashboard) e crie uma API key. 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):

```bash
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 uma request HTTP para `example.com` e retorna o HTML da página.

## Etapa 3: Ler a Response

```json
{
  "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 possui um campo `result` com a linha de status mais todos os headers de response que o destino retornou para aquele salto.

Campos principais:
- `status`: código de status HTTP do site de destino
- `data`: o body da response (HTML, JSON ou texto bruto)
- `total_time`: duração da request em segundos

## Etapa 4: Testar Diferentes Endpoints

O FourA tem quatro endpoints para diferentes situações:

| Endpoint | Velocidade | Quando usar |
|----------|-------|----------|
| `POST /api/auto/` | Varia (rápido em hosts aquecidos) | Você não sabe de qual engine o site precisa. Envie uma URL e deixe o 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édio (2s-10s) | Páginas com muito JavaScript, SPAs, conteúdo dinâmico |
| `POST /api/proxy/` | Rápido (1s-5s) | Sites que verificam quem está requisitando, conteúdo que varia por país |

Experimente uma request auto (o padrão inteligente):

```bash
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"]}}
  }'
```

Experimente uma request de navegador:

```bash
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}'
```

Experimente uma proxy request (rotação automática de proxy):

```bash
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

- [Autenticação](https://foura.ai/docs/getting-started/authentication): Gerenciamento e segurança de chaves de API
- [Endpoints da API](https://foura.ai/docs/api/endpoints): Referência completa de parâmetros para todos os quatro endpoints
- [Smart Fetch (Auto)](https://foura.ai/docs/guides/smart-fetch): Como o endpoint auto decide o que fazer
- [SDKs e Bibliotecas](https://foura.ai/docs/getting-started/sdks-and-libraries): Exemplos em Python, Node.js, Go, Ruby
- [Escolhendo o Endpoint Correto](https://foura.ai/docs/guides/choosing-task-type): Quando escolher auto, single, browser ou proxy
