Una sola entrada. Una publicacion propia por canal.
Programable, con la voz de tu marca.
La API de Personativ lleva la funcion estrella «crea una vez, nativo por canal en todas partes» directamente a tus sistemas. Envias un texto, una URL o unos puntos clave y recibes, por canal, una publicacion nativa redactada de forma independiente con la voz de tu marca. Conforme al RGPD y mediante una sencilla llamada REST.
14 dias gratis · Una key por espacio de trabajo · Limite de 60/min
Por que la API de Personativ
No es otra herramienta de publicacion cruzada, sino creacion nativa por canal como pieza para tus sistemas.
Una entrada, muchos canales con voz de marca
Una unica llamada /compose genera una publicacion independiente para cada canal elegido, no el mismo texto recortado varias veces. El posicionamiento, la audiencia y las lineas rojas de tu perfil de marca se incorporan en automatico.
Conforme al RGPD y soberana en la UE
El procesamiento esta pensado para la soberania de datos europea. Para los textos de IA rige el mismo aviso de UE que en la app, o activas el modo Sovereign, y entonces los espacios de trabajo soberanos pasan en automatico.
Datos de tendencias por programacion
GET /trends devuelve los resultados actuales del radar de tendencias, con puntuacion de relevancia, directamente como JSON. Asi alimentas tu planificacion editorial, tus paneles o tus automatizaciones con las mismas senales que Personativ usa internamente.
Lista en minutos
Una key en la cabecera, un POST y listo. Autenticacion por cabecera sin flujo OAuth, una descripcion OpenAPI 3.0.3 legible por maquina y los errores siempre como JSON claro con error y code.
Lo que puede la API
URL base https://personativ.de/api/v1, autenticacion mediante la cabecera X-API-Key.
/meInformacion del espacio de trabajo, saldo de creditos actual y plataformas disponibles.
/channelsCanales sociales conectados del espacio de trabajo.
/trendsResultados actuales del radar de tendencias, con puntuacion de relevancia (parametro limit, max. 100).
/articlesListar los articulos publicados (paginado mediante page y limit).
/articles/{slug}Recuperar un articulo publicado concreto, con el HTML renderizado incluido.
/articlesCrear un borrador de articulo (titulo y contenido).
/composeFuncion estrella: una sola entrada y, por canal, una publicacion nativa con voz de marca. Consume creditos.
/openapi.jsonDescripcion OpenAPI 3.0.3 legible por maquina de toda la API.
Empieza en tres pasos
Genera la key, pon la cabecera y crea tu primera publicacion.
Generar la key
Genera la API key del espacio de trabajo en los ajustes, en «Publicacion / API». Una key por espacio de trabajo, tratala como una contrasena.
Enviar como cabecera
Cada peticion se autentica mediante X-API-Key. Sin OAuth, sin intercambio de tokens.
Primera llamada /compose
Una entrada, una lista de canales y, por canal, una publicacion de vuelta.
Peticion
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"]
}'Respuesta (abreviada, ilustrativa)
{
"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);Casos de uso tipicos
Desde la integracion con el CMS hasta tu propio script de agencia.
Integracion con blog y CMS
Has publicado un articulo nuevo en el CMS? Pasa el texto o la URL a /compose y recibe en automatico las publicaciones adecuadas para cada canal, sin reescribir a mano.
Panel propio
Lleva el saldo, los canales conectados y las senales de tendencias a tu propio cockpit y controla la creacion de contenido desde la interfaz de siempre.
Automatizacion de agencia
Atiende a muchos clientes, cada uno con su propio espacio de trabajo y su propia key. Un script genera, a partir de un briefing, borradores acordes a la marca por cliente y canal en segundos.
Flujo con IA y no-code
Como todo funciona con una key en la cabecera y un unico POST, /compose se integra en herramientas no-code y pipelines de IA: entra el disparador, salen publicaciones nativas por canal.
Bueno saberlo
- Limite de peticiones: 60 peticiones por minuto y API key. Al superarlo responde con 429 y code RATE_LIMITED.
- Creditos: /compose consume el mismo saldo que la app y solo se cobra si tiene exito; el saldo aparece en cada respuesta.
- Procesamiento en la UE: los textos de IA requieren el aviso de IA de UE o el modo Sovereign; de lo contrario, 428 con code AI_EU_CONSENT_REQUIRED.
- Sin publicacion automatica a traves de la API: genera contenidos y borradores; la difusion se hace en la app, mediante WordPress/Wix o el webhook de publicacion.
Preguntas frecuentes
Como me autentico?+
Mediante la API key del espacio de trabajo en la cabecera X-API-Key. La key la generas en los ajustes, en «Publicacion / API». Una key por espacio de trabajo, sin flujo OAuth. Tratala como una contrasena.
Cuanto cuesta el uso, como funcionan los creditos?+
La API usa el mismo modelo de creditos que la app. /compose cobra creditos por la creacion y, por cada canal, por un texto de IA, y solo si tiene exito. Tu saldo lo consultas mediante GET /me, y ademas aparece en cada respuesta de /compose. Los endpoints de lectura como /trends o /channels no cuestan creditos.
Que hay del RGPD y la proteccion de datos?+
Personativ esta disenado para cumplir el RGPD y la soberania de datos europea. Los textos de IA mediante /compose requieren el aviso de IA de UE confirmado o el modo Sovereign activado; si falta, la API responde con 428 en lugar de procesar.
Como publico las publicaciones generadas?+
La API crea contenidos y borradores, no publica por si misma. La publicacion la haces en la app de Personativ o mediante los conectores integrados (WordPress, Wix) y el webhook de publicacion saliente. Asi la aprobacion queda en tus manos, separada de la generacion.
Listo para integrar la API?
Genera tu key en los ajustes y envia la primera llamada /compose. 14 dias gratis, sin tarjeta de credito.