Ein Input. Pro Kanal ein eigener Post.
Programmierbar, in eurer Markenstimme.
Die Personativ API bringt das Flaggschiff „einmal erfassen, kanal-nativ überall" direkt in eure Systeme. Ihr schickt einen Text, eine URL oder Stichpunkte, und bekommt pro Kanal einen eigenständig getexteten, kanal-nativen Post zurück, in eurer Markenstimme. DSGVO-konform und per einfachem REST-Call.
14 Tage kostenlos · Ein Key pro Workspace · Rate-Limit 60/min
Warum die Personativ-API
Kein weiteres Cross-Posting-Tool, sondern kanal-native Erstellung als Baustein für eure Systeme.
Ein Input, viele Kanäle in Markenstimme
Ein einziger /compose-Call erzeugt für jeden gewählten Kanal einen eigenständigen Post, nicht denselben Text mehrfach zugeschnitten. Positionierung, Zielgruppe und No-Gos aus eurem Markenprofil fließen automatisch mit ein.
DSGVO-konform und EU-souverän
Die Verarbeitung ist auf europäische Datenhoheit ausgelegt. Für KI-Texte gilt derselbe EU-Hinweis wie in der App, oder ihr aktiviert den Sovereign-Modus, dann laufen souveräne Workspaces automatisch durch.
Trend-Daten programmatisch
GET /trends liefert die aktuellen Trend-Radar-Treffer inklusive Relevanz-Score direkt als JSON. So füttert ihr Redaktionsplanung, Dashboards oder Automationen mit denselben Signalen, die Personativ intern nutzt.
In Minuten startklar
Ein Key im Header, ein POST, fertig. Header-basierte Auth ohne OAuth-Flow, eine maschinenlesbare OpenAPI-3.0.3-Beschreibung und Fehler immer als klares JSON mit error und code.
Was die API kann
Basis-URL https://personativ.de/api/v1, Auth über den Header X-API-Key.
/meWorkspace-Info, aktuelles Credit-Guthaben und verfügbare Plattformen.
/channelsVerbundene Social-Kanäle des Workspace.
/trendsAktuelle Trend-Radar-Treffer inkl. Relevanz-Score (Parameter limit, max. 100).
/articlesVeröffentlichte Artikel auflisten (paginiert über page und limit).
/articles/{slug}Einzelnen veröffentlichten Artikel abrufen, inkl. gerendertem HTML.
/articlesArtikel-Entwurf anlegen (Titel und Inhalt).
/composeFlaggschiff: ein Input, pro Kanal ein kanal-nativer Post in Markenstimme. Verbraucht Credits.
/openapi.jsonMaschinenlesbare OpenAPI-3.0.3-Beschreibung der gesamten API.
Start in drei Schritten
Key erzeugen, Header setzen, ersten Post generieren.
Key erzeugen
In den Einstellungen unter „Auslieferung / API" den Workspace-API-Key erzeugen. Ein Key pro Workspace, wie ein Passwort behandeln.
Als Header senden
Jede Anfrage authentifiziert sich über X-API-Key. Kein OAuth, kein Token-Austausch.
Ersten /compose-Call
Ein Input, eine Liste von Kanälen, pro Kanal ein Post zurück.
Request
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 zur E-Rechnungspflicht ...",
"platforms": ["linkedin", "twitter", "mastodon"]
}'Antwort (gekürzt, illustrativ)
{
"articleId": "a1b2c3d4-...",
"title": "5 Fehler bei der E-Rechnung",
"results": [
{ "platform": "linkedin", "content": "Die E-Rechnungspflicht kommt ...", "hashtags": ["ERechnung"] },
{ "platform": "twitter", "content": "5 typische Fehler bei der E-Rechnung ...", "hashtags": ["ERechnung"] }
],
"creditsCharged": 4,
"credits": { "available": 196 }
}Node / JavaScript (fetch)
const res = await fetch("https://personativ.de/api/v1/compose", {
method: "POST",
headers: {
"X-API-Key": process.env.PERSONATIV_API_KEY,
"Content-Type": "application/json"
},
body: JSON.stringify({
type: "text",
input: "Euer Fachtext oder eure Stichpunkte ...",
platforms: ["linkedin", "twitter"]
})
});
const data = await res.json();
for (const post of data.results) console.log(post.platform, post.content);Typische Use-Cases
Von der CMS-Anbindung bis zum eigenen Agentur-Skript.
Blog- und CMS-Anbindung
Neuer Artikel im CMS veröffentlicht? Übergebt Text oder URL an /compose und erhaltet automatisch die passenden Posts für jeden Kanal, ohne manuelles Nachtexten.
Eigenes Dashboard
Zieht Guthaben, verbundene Kanäle und Trend-Signale in euer eigenes Cockpit und steuert die Content-Erstellung aus eurer gewohnten Oberfläche.
Agentur-Automatisierung
Betreut viele Kunden je mit eigenem Workspace und eigenem Key. Ein Skript erzeugt aus einem Briefing pro Kunde und Kanal markenkonforme Entwürfe in Sekunden.
KI-Workflow und No-Code
Da alles über einen Header-Key und einen einzigen POST läuft, lässt sich /compose in No-Code-Tools und KI-Pipelines einhängen: Trigger rein, kanal-native Posts raus.
Gut zu wissen
- Rate-Limit: 60 Anfragen pro Minute je API-Key. Überschreitung antwortet mit 429 und code RATE_LIMITED.
- Credits: /compose verbraucht dasselbe Guthaben wie die App, nur bei Erfolg gebucht; der Stand steht in jeder Antwort.
- EU-Verarbeitung: KI-Texte setzen den EU-KI-Hinweis oder den Sovereign-Modus voraus, sonst 428 mit code AI_EU_CONSENT_REQUIRED.
- Sperren: 402 mit code DELETION_PENDING, solange der Workspace zur Löschung vorgemerkt ist (scheduledFor nennt den Löschtag), und 402 mit code PLAN_EXPIRED nach Ablauf von Plan oder Testphase.
- Kein Auto-Publish über die API: sie erzeugt Inhalte und Entwürfe, das Ausspielen läuft in der App, über WordPress/Wix oder den Publish-Webhook.
Häufige Fragen
Wie authentifiziere ich mich?
Über den Workspace-API-Key im Header X-API-Key. Den Key erzeugst du in den Einstellungen unter „Auslieferung / API". Ein Key pro Workspace, kein OAuth-Flow. Behandle ihn wie ein Passwort.
Was kostet die Nutzung, wie funktionieren Credits?
Die API nutzt dasselbe Credit-Modell wie die App. /compose bucht Credits fürs Erfassen und je Kanal für einen KI-Text, und zwar nur bei Erfolg. Dein Guthaben rufst du über GET /me ab, außerdem steht es in jeder /compose-Antwort. Lesende Endpunkte wie /trends oder /channels kosten keine Credits.
Wie steht es um DSGVO und Datenschutz?
Personativ ist auf DSGVO-Konformität und EU-Datenhoheit ausgelegt. KI-Texte über /compose setzen den bestätigten EU-KI-Hinweis oder den aktivierten Sovereign-Modus voraus; fehlt er, antwortet die API mit 428 statt zu verarbeiten.
Wie veröffentliche ich die erzeugten Posts?
Die API erstellt Inhalte und Entwürfe, sie postet nicht selbst. Die Veröffentlichung übernimmst du in der Personativ-App oder über die angebundenen Connectoren (WordPress, Wix) sowie den ausgehenden Publish-Webhook. So bleibt die Freigabe bei dir, getrennt von der Erzeugung.
Bereit, die API anzubinden?
Erzeugt euren Key in den Einstellungen und schickt den ersten /compose-Call. 14 Tage kostenlos, ohne Kreditkarte.