PersonativPersonativ
Anmelden Kostenlos testen
DE
DeutschEnglishEspañolItaliano
Personativ API v1
OpenAPI

Die Personativ API

Automatisiert euren Content-Workflow: ein Input, pro Kanal ein eigenständig getexteter, kanal-nativer Post in eurer Markenstimme. DSGVO-konform, EU-souverän, per REST.

Basis-URL: https://personativ.de/api/v1

Authentifizierung

Jede Anfrage authentifiziert sich über den Workspace-API-Key im Header X-API-Key. Den Key erzeugst du in den Einstellungen unter „Auslieferung / API". Behandle ihn wie ein Passwort.

curl https://personativ.de/api/v1/me \
  -H "X-API-Key: dein_workspace_api_key"

Endpunkte

GET
/api/v1/me

Workspace-Info und aktuelles Credit-Guthaben.

GET
/api/v1/channels

Verbundene Social-Kanäle.

GET
/api/v1/trends

Aktuelle Trend-Radar-Treffer inkl. Relevanz-Score.

GET
/api/v1/articles

Veröffentlichte Artikel auflisten.

GET
/api/v1/articles/{slug}

Einzelnen Artikel abrufen (inkl. HTML).

POST
/api/v1/articles

Artikel-Entwurf anlegen.

POST
/api/v1/compose

Flaggschiff: ein Input, pro Kanal ein kanal-nativer Post.

Beispiel: einmal erfassen, kanal-nativ ausspielen

Ein Fachartikel als Input, daraus je Kanal ein eigenständiger Post. Verbraucht Credits (Erfassen plus je Kanal einen KI-Text).

curl -X POST https://personativ.de/api/v1/compose \
  -H "X-API-Key: dein_workspace_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "text",
    "title": "5 Fehler bei der E-Rechnung",
    "input": "Kurzer Fachtext oder Stichpunkte ...",
    "platforms": ["linkedin", "twitter", "mastodon"]
  }'

Antwort (gekürzt):

{
  "articleId": "…",
  "title": "5 Fehler bei der E-Rechnung",
  "results": [
    { "platform": "linkedin", "content": "…", "hashtags": ["ERechnung"] },
    { "platform": "twitter",  "content": "…", "hashtags": ["…"] }
  ],
  "creditsCharged": 4,
  "credits": { "available": 196 }
}

JavaScript / Node

const res = await fetch("https://personativ.de/api/v1/compose", {
  method: "POST",
  headers: {
    "X-API-Key": process.env.CONTENTFLOW_API_KEY,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    input: "Euer Fachtext ...",
    platforms: ["linkedin", "twitter"]
  })
});
const data = await res.json();

Gut zu wissen

  • Rate-Limit: 60 Anfragen pro Minute je API-Key.
  • Abrechnung über dasselbe Credit-Modell wie in der App.
  • KI-Verarbeitung EU-souverän aktivierbar (Sovereign-Modus), sonst einmalige EU-Bestätigung nötig.
  • Fehler kommen als JSON mit error und code.

Noch keinen Workspace?

14 Tage kostenlos, API inklusive.

Kostenlos starten

Häufige Fragen

Wie authentifiziere ich mich an der API?+

Über den Workspace-API-Key im Header X-API-Key. Den Key erzeugst du in den Einstellungen unter Auslieferung / API. Behandle ihn wie ein Passwort.

Was macht der /compose-Endpunkt?+

Ein Input, pro Kanal ein eigenständig getexteter, kanal-nativer Post in eurer Markenstimme. Verbraucht Credits (Erfassen plus je Kanal einen KI-Text).

Gibt es ein Rate-Limit?+

Ja, 60 Anfragen pro Minute je API-Key. Abgerechnet wird über dasselbe Credit-Modell wie in der App.

Ist die API DSGVO-konform?+

Ja. Die KI-Verarbeitung ist EU-souverän aktivierbar (Sovereign-Modus), sonst ist eine einmalige EU-Bestätigung nötig.

Gibt es eine OpenAPI-Beschreibung?+

Ja, unter /api/v1/openapi.json. Fehler kommen als JSON mit den Feldern error und code.