Un input. Per canale un post proprio.
Programmabile, nella voce del vostro brand.
L'API di Personativ porta il fiore all'occhiello «crea una volta, nativo ovunque» direttamente nei vostri sistemi. Inviate un testo, un URL o dei punti chiave, e ottenete per canale un post nativo scritto in modo autonomo, nella voce del vostro brand. Conforme al GDPR e con una semplice chiamata REST.
14 giorni gratis · Una chiave per workspace · Rate limit 60/min
Perché l'API di Personativ
Non l'ennesimo strumento di cross-posting, ma creazione nativa per canale come componente per i vostri sistemi.
Un input, molti canali nella voce del brand
Un'unica chiamata /compose genera per ogni canale scelto un post autonomo, non lo stesso testo adattato più volte. Posizionamento, pubblico e no-go dal vostro profilo di brand confluiscono in automatico.
Conforme al GDPR e sovrana in UE
L'elaborazione e progettata per la sovranità dei dati europea. Per i testi IA vale lo stesso avviso UE dell'app, oppure attivate la modalità Sovereign, e allora i workspace sovrani passano in automatico.
Dati sulle tendenze in modo programmatico
GET /trends fornisce i risultati attuali del radar delle tendenze con punteggio di rilevanza direttamente come JSON. Così alimentate piano editoriale, dashboard o automazioni con gli stessi segnali che Personativ usa internamente.
Pronta in pochi minuti
Una chiave nell'header, un POST, fatto. Auth basata su header senza flusso OAuth, una descrizione OpenAPI 3.0.3 leggibile dalle macchine ed errori sempre come JSON chiaro con error e code.
Cosa sa fare l'API
URL base https://personativ.de/api/v1, auth tramite l'header X-API-Key.
/meInfo sul workspace, saldo credit attuale e piattaforme disponibili.
/channelsCanali social collegati del workspace.
/trendsRisultati attuali del radar delle tendenze con punteggio di rilevanza (parametro limit, max. 100).
/articlesElenco degli articoli pubblicati (paginato tramite page e limit).
/articles/{slug}Recupero del singolo articolo pubblicato, incl. HTML reso.
/articlesCreazione di una bozza di articolo (titolo e contenuto).
/composeFiore all'occhiello: un input, per canale un post nativo nella voce del brand. Consuma credit.
/openapi.jsonDescrizione OpenAPI 3.0.3 leggibile dalle macchine dell'intera API.
Avvio in tre passi
Genera la chiave, imposta l'header, genera il primo post.
Genera la chiave
Nelle impostazioni sotto «Distribuzione / API» genera la chiave API del workspace. Una chiave per workspace, da trattare come una password.
Invia come header
Ogni richiesta si autentica tramite X-API-Key. Niente OAuth, niente scambio di token.
Prima chiamata /compose
Un input, un elenco di canali, per canale un post restituito.
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"]
}'Risposta (abbreviata, illustrativa)
{
"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);Casi d'uso tipici
Dal collegamento al CMS fino allo script d'agenzia personalizzato.
Collegamento a blog e CMS
Nuovo articolo pubblicato nel CMS? Passate testo o URL a /compose e ricevete in automatico i post giusti per ogni canale, senza riscrittura manuale.
Dashboard propria
Portate saldo, canali collegati e segnali di tendenza nel vostro cockpit e gestite la creazione di contenuti dalla vostra interfaccia abituale.
Automazione d'agenzia
Gestite molti clienti, ognuno con workspace e chiave propri. Uno script genera da un briefing, per cliente e per canale, bozze conformi al brand in pochi secondi.
Workflow IA e no-code
Poiché tutto passa da una chiave nell'header e da un unico POST, /compose si integra in strumenti no-code e pipeline IA: trigger in ingresso, post nativi per canale in uscita.
Buono a sapersi
- Rate limit: 60 richieste al minuto per chiave API. Il superamento risponde con 429 e code RATE_LIMITED.
- Credit: /compose consuma lo stesso saldo dell'app, addebitato solo in caso di successo; il saldo compare in ogni risposta.
- Elaborazione UE: i testi IA richiedono l'avviso UE sull'IA o la modalità Sovereign, altrimenti 428 con code AI_EU_CONSENT_REQUIRED.
- Nessuna auto-pubblicazione tramite l'API: genera contenuti e bozze, la distribuzione avviene nell'app, tramite WordPress/Wix o il webhook di pubblicazione.
Domande frequenti
Come mi autentico?+
Tramite la chiave API del workspace nell'header X-API-Key. La chiave si genera nelle impostazioni sotto «Distribuzione / API». Una chiave per workspace, niente flusso OAuth. Trattatela come una password.
Quanto costa l'uso, come funzionano i credit?+
L'API usa lo stesso modello a credit dell'app. /compose addebita credit per l'acquisizione e per canale per un testo IA, e solo in caso di successo. Il saldo lo recuperate tramite GET /me, inoltre compare in ogni risposta /compose. Gli endpoint in lettura come /trends o /channels non costano credit.
Come stanno le cose con GDPR e protezione dei dati?+
Personativ è progettato per la conformità al GDPR e la sovranità dei dati UE. I testi IA tramite /compose richiedono l'avviso UE sull'IA confermato o la modalità Sovereign attivata; se manca, l'API risponde con 428 invece di elaborare.
Come pubblico i post generati?+
L'API crea contenuti e bozze, non pubblica da sola. La pubblicazione avviene nell'app Personativ o tramite i connettori collegati (WordPress, Wix) e il webhook di pubblicazione in uscita. Così l'approvazione resta a voi, separata dalla generazione.
Pronti a integrare l'API?
Generate la vostra chiave nelle impostazioni e inviate la prima chiamata /compose. 14 giorni gratis, senza carta di credito.