# Schnellstart

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

Von null zur ersten Datenerfassung in unter zwei Minuten.

## Voraussetzungen

- Ein FourA-Konto ([hier registrieren](https://foura.ai))
- Dein API-Key (erstelle einen im [Dashboard](https://foura.ai/dashboard))

## Schritt 1: API-Key abrufen

Melde dich im [Dashboard](https://foura.ai/dashboard) an und erstelle einen API-Key. Er sieht so aus: `pk_live_a1b2c3d4e5f6...`

Kopiere ihn. Du benötigst ihn für jeden Request.

## Schritt 2: Deinen ersten Request ausführen

Öffne ein Terminal und führe diesen Befehl aus (ersetze `YOUR_API_KEY` durch deinen echten Key):

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

Dies sendet einen HTTP-Request an `example.com` und gibt das HTML der Seite zurück.

## Schritt 3: Response auslesen

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

Das `headers`-Feld ist ein Array von Objekten, eines pro Redirect-Hop. Jeder Eintrag enthält ein `result`-Feld mit der Statuszeile und allen Response-Headern, die das Ziel für diesen Hop zurückgegeben hat.

Wichtige Felder:
- `status`: HTTP-Statuscode der Zielseite
- `data`: der Response-Body (HTML, JSON oder Raw Text)
- `total_time`: Request-Dauer in Sekunden

## Schritt 4: Verschiedene Endpoints ausprobieren

FourA bietet vier Endpoints für unterschiedliche Situationen:

| Endpoint | Geschwindigkeit | Verwendung |
|----------|-------|----------|
| `POST /api/auto/` | Variiert (schnell bei warmen Hosts) | Du weißt nicht, welche Engine die Seite benötigt. Übergib eine URL und lass FourA den günstigsten funktionierenden Pfad wählen. |
| `POST /api/single/` | Am schnellsten (200ms-2s) | Statische Seiten, APIs, serverseitig gerenderte Seiten |
| `POST /api/browser/` | Mittel (2s-10s) | JavaScript-lastige Seiten, SPAs, dynamische Inhalte |
| `POST /api/proxy/` | Schnell (1s-5s) | Seiten, die Anfragen prüfen, länderspezifische Inhalte |

Probiere einen Auto-Request (der smarte Standard):

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

Teste einen Browser-Request:

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

Teste einen Proxy-Request (automatische Proxy-Rotation):

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

## Nächste Schritte

- [Authentifizierung](https://foura.ai/docs/getting-started/authentication): API-Schlüssel-Verwaltung und Sicherheit
- [API-Endpunkte](https://foura.ai/docs/api/endpoints): Vollständige Parameter-Referenz für alle vier Endpoints
- [Smart Fetch (Auto)](https://foura.ai/docs/guides/smart-fetch): Wie der Auto-Endpoint Entscheidungen trifft
- [SDKs und Bibliotheken](https://foura.ai/docs/getting-started/sdks-and-libraries): Beispiele in Python, Node.js, Go, Ruby
- [Den passenden Endpoint wählen](https://foura.ai/docs/guides/choosing-task-type): Wann du Auto, Single, Browser oder Proxy wählst
