Docs › Erste Schritte › Schnellstart

Schnellstart

Starte von null und erfasse deine ersten Daten in unter zwei Minuten.

Voraussetzungen

Schritt 1: API Key abrufen

Melde dich im 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: Ersten Request senden

Öffne ein Terminal und führe dies aus (ersetze YOUR_API_KEY durch deinen tatsächlichen Key):

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 lesen

{
  "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 Feld headers ist ein Array von Objekten, eines pro Redirect-Hop. Jeder Eintrag hat ein result-Feld mit der Statuszeile und jedem Response-Header, den das Ziel für diesen Hop zurückgegeben hat.

Wichtige Felder:

  • status: HTTP-Statuscode von der Zielseite
  • data: der Response-Body (HTML, JSON oder reiner Text)
  • total_time: Request-Dauer in Sekunden

Schritt 4: Andere Endpoints ausprobieren

FourA bietet vier Endpoints für unterschiedliche Situationen:

Endpoint Geschwindigkeit Verwendung
POST /api/auto/ Variiert (schnell auf 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 mit Bot-Erkennung, geoblockierte Inhalte

Probiere einen Auto-Request (der intelligente Standard):

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

Probiere einen Browser-Request:

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

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

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

Aktualisiert: 1. Juli 2026
Authentifizierung →