Schnellstart

Diese Seite bringt dich von null zum veröffentlichten Post. Du brauchst ein FeedHorizon-Konto mit mindestens einem verbundenen Social-Konto (öffne im Dashboard Verbindungen).

Base URL:

https://feedhorizon.com/api/v1

Schritt 1 – API-Key anlegen

1. Öffne Dashboard → API & Apps
2. Klick auf API-Key erstellen
3. Gib ihm einen Namen (z. B. „Mein Skript“) und wähle die Berechtigung Lesen & Schreiben
4. Kopier den Key sofort – er wird nur einmal angezeigt

Dein Key sieht so aus:

fh_aee6d4242ae1d2ff857b4a900904f9e5beac1f2168a6c83da9f63053fda8caf8

Schritt 2 – Erste Anfrage stellen

Die Beispiele unten nutzen cURL oder eines der offiziellen SDKs. Für ein SDK installierst du es und setzt den Key als Umgebungsvariable:

npm install @feedhorizon/sdk
export FEEDHORIZON_API_KEY=fh_YOUR_API_KEY

Prüf den Key mit GET /api/v1/me. Die Antwort enthält deine Organisation, deinen Tarif, dein Rate Limit und die Scopes dieses Keys:

curl https://feedhorizon.com/api/v1/me \
  -H "Authorization: Bearer fh_YOUR_API_KEY"

Dann lass dir deine Profile auflisten:

curl -X GET https://feedhorizon.com/api/v1/profiles \
  -H "Authorization: Bearer fh_YOUR_API_KEY"

Du bekommst eine JSON-Antwort:

{
    "data": [
        {
            "id": "prof_2f9c1e4b6a3d4e8b9f0a1c2d3e4f5a6b",
            "name": "My Brand",
            "color": "#f5d76e",
            "timezone": "Europe/Berlin",
            "isDefault": true,
            "queueEnabled": false,
            "createdAt": "2026-11-01T09:00:00.000Z",
            "updatedAt": "2026-11-01T09:00:00.000Z"
        }
    ],
    "nextCursor": null
}

Kopier die id des Profils: Posts werden in einem Profil angelegt. Jedes Objekt steckt in data, jede Liste in data plus nextCursor, und IDs haben ein Präfix wie prof_ oder acc_, das sagt, was sie sind. API-Grundlagen erklärt diese Konventionen, Datenmodell, wie Profile, Konten und Posts zusammenhängen.

Schritt 3 – Post anlegen

curl -X POST https://feedhorizon.com/api/v1/posts \
  -H "Authorization: Bearer fh_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "content": "Hello from the FeedHorizon API!",
    "platforms": ["linkedin"],
    "profileId": "YOUR_PROFILE_ID",
    "publishNow": true
  }'

Die Antwort ist der angelegte Post. Er geht innerhalb von Sekunden von scheduled über publishing zu published. Lass publishNow weg, um einen Entwurf anzulegen, oder schick stattdessen scheduledFor (siehe Planen).

Mit dem Header Idempotency-Key kannst du die Anfrage gefahrlos wiederholen: Bricht die Verbindung ab, schickst du sie mit demselben Key noch einmal und bekommst die erste Antwort zurück statt eines zweiten Posts. Die SDKs setzen diesen Header bei jedem Schreibzugriff und wiederholen für dich.

Schritt 4 – Webhooks einrichten (optional)

Lass dich benachrichtigen, wenn Posts veröffentlicht werden oder fehlschlagen:

curl -X POST https://feedhorizon.com/api/v1/webhooks \
  -H "Authorization: Bearer fh_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "My server",
    "url": "https://your-server.com/webhooks/feedhorizon",
    "events": ["post.published", "post.failed"]
  }'

Wie es weitergeht

• SDKs – Clients für Node.js und Python: Installation, Fehler, Paginierung, Webhooks
• Datenmodell – wie Profile, Konten, Posts und Targets zusammenhängen
• Rezepte – komplette Abläufe mit Code: Bilder, Kunden einrichten, Fehler, Abgleich
• Planen – Entwürfe, geplante Posts, die Warteschlange und Wiederholungen
• Authentifizierung – Formate von API-Keys, Scopes und Sicherheit
• MCP-Server – lass Claude, ChatGPT und andere KI-Assistenten Posts für dich planen
• Fehler – Format von Fehlerantworten, Codes und HTTP-Statuscodes
• Rate Limits – Anfragelimits und Header verstehen
• Idempotenz – Schreibzugriffe sicher wiederholen
• Webhooks – Events und Signaturprüfung