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.
- 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.