Docs › Dashboard › Dein erster Request

Dein erster Request

Diese Anleitung führt dich durch die Erstellung eines API-Keys und das Senden deines ersten Requests über das FourA Dashboard.

Schritt 1: Dashboard öffnen

Navigiere zum Dashboard und melde dich mit deinem FourA-Konto an.

Schritt 2: API-Key erstellen

Gehe auf die Seite API Keys und klicke auf Create Key.

Gib dem Key einen aussagekräftigen Namen (z. B. "production-scraper" oder "dev-testing"). Der vollständige Key wird nur einmal angezeigt, kopiere ihn also sofort.

Dein Key sieht so aus: pk_live_a1b2c3d4e5f6...

Schritt 3: Endpoint auswählen

FourA bietet drei Endpoints für verschiedene Szenarien:

Single (POST /api/single/)

Sendet einen schnellen HTTP-Request. Bestens geeignet für statische HTML-Seiten und API-Endpoints. Antwortzeit: typischerweise unter 2 Sekunden.

Browser (POST /api/browser/)

Führt eine Chrome-Browser-Instanz aus, um JavaScript zu rendern. Bestens geeignet für SPAs, Lazy-Loading-Inhalte und Seiten, die eine JS-Ausführung erfordern. Antwortzeit: 2 bis 10 Sekunden.

Proxy (POST /api/proxy/)

Leitet den Request über rotierende Proxys mit automatischem Retry weiter. Bestens geeignet für Websites mit Bot-Erkennung oder geografisch eingeschränkten Inhalten.

Schritt 4: Deinen ersten Request senden

Öffne ein Terminal und führe aus:

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

Schritt 5: Response lesen

{
  "status": 200,
  "headers": [["content-type", "text/html"]],
  "data": "<html>...</html>",
  "total_time": 0.45
}

Wichtige Felder:

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

Schritt 6: Browser-Request ausprobieren

Wenn die Zielseite JavaScript zum Rendern von Inhalten verwendet, nutze stattdessen den Browser-Endpoint:

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

Die Browser-Response verwendet body anstelle von data:

{
  "status": 200,
  "headers": {"content-type": "text/html"},
  "body": "<html>...</html>"
}

Häufige Probleme

Problem Lösung
Leerer Inhalt Wechsle vom Single- zum Browser-Endpoint: Die Seite benötigt wahrscheinlich JS-Rendering
Captcha in der Response Wechsle zum Proxy-Endpoint für automatische IP-Rotation
Timeout Erhöhe timeout_ms oder überprüfe, ob die URL korrekt ist

Nächste Schritte

Aktualisiert: 1. Juli 2026
← Dashboard-Übersicht API-Keys verwalten →