API v1 Quickstart

Hier findest du die wichtigsten Endpunkte der SEOFuxx API v1 und ein paar Beispiele, mit denen du schnell testen kannst.

Basis

• Basis-URL: https://www.seofuxx.com/api/v1
• Die Spezifikation liegt als openapi.yaml im Projekt
• Viele Endpunkte erwarten application/x-www-form-urlencoded

Die wichtigsten Endpunkte

• POST /account: Stammdaten und Profilaktionen
• POST /password: Passwort aktualisieren
• POST /domains-projekte: Domain, Keywords und Auto Crawl speichern
• POST /filemerger: CSS/JS analysieren oder zusammenführen
• POST /favicon: Favicons aus einem Upload erzeugen
• POST /favicon/ai-image: KI-Bild erzeugen
• POST /favicon/from-ai: Favicons aus einem KI-Bild erzeugen
• GET /ai-visibility: Kennzahlen der AI Visibility lesen (per API-Key)
• POST /api-keys: API-Keys anlegen, auflisten und widerrufen

Beispiel: Filemerger analysieren

curl -X POST "https://www.seofuxx.com/api/v1/filemerger" \
  -d "action=analyze" \
  -d "domain=https://example.com"

Beispiel: Filemerger mergen

curl -X POST "https://www.seofuxx.com/api/v1/filemerger" \
  -d "action=merge" \
  -d "domain=https://example.com" \
  -d "jsfiles[]=/assets/js/app.js" \
  -d "cssfiles[]=/assets/css/app.css" \
  -d "shrink=1"

Authentifizierung

Die meisten Endpunkte hängen an einer aktiven Session, du musst also eingeloggt sein. Das betrifft zum Beispiel account, password, domains-projekte und filemerger. Die Beispiele oben funktionieren deshalb nur mit dem Cookie einer angemeldeten Sitzung.

Für automatische Abrufe gibt es API-Keys. Du legst sie im Konto auf dem Tab API-Keys an. Der Key wird nur einmal im Klartext angezeigt, kopiere ihn also gleich. Verlierst du ihn oder vermutest Missbrauch, widerrufst du ihn dort wieder. Mit dem Key sendest du den Header Authorization: Bearer sfx_..., zum Beispiel an GET /ai-visibility (siehe AI Visibility Tracking) und an den MCP-Endpunkt.

Fehlercodes

• 400: Parameter ungültig oder fehlen
• 401: nicht angemeldet
• 403: Zugriff nicht erlaubt
• 429: Limit erreicht, etwa bei Analysen ohne Konto
• 500: interner Fehler

Alle Felder und die Antwortschemas stehen vollständig in der openapi.yaml, nimm für Details am besten die.