API de Personativ v1

La API de Personativ

Automatiza tu flujo de contenido: una sola entrada y, por canal, una publicacion nativa redactada de forma independiente con la voz de tu marca. Conforme al RGPD, soberana en la UE y via REST.

URL base: https://personativ.de/api/v1

Autenticacion

Cada peticion se autentica mediante la API key del espacio de trabajo en la cabecera X-API-Key. La key la generas en los ajustes, en «Publicacion / API». Tratala como una contrasena.

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

Endpoints

GET

/api/v1/me

Informacion del espacio de trabajo y saldo de creditos actual.

GET

/api/v1/channels

Canales sociales conectados.

GET

/api/v1/trends

Resultados actuales del radar de tendencias, con puntuacion de relevancia.

GET

/api/v1/articles

Listar los articulos publicados.

GET

/api/v1/articles/{slug}

Recuperar un articulo concreto (HTML incluido).

POST

/api/v1/articles

Crear un borrador de articulo.

POST

/api/v1/compose

Funcion estrella: una sola entrada y, por canal, una publicacion nativa.

Ejemplo: crea una vez, publica de forma nativa por canal

Un articulo tecnico como entrada y, a partir de el, una publicacion independiente por canal. Consume creditos (la creacion mas un texto de IA por canal).

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"]
  }'

Respuesta (abreviada):

{
  "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();

Bueno saberlo

Limite de peticiones: 60 peticiones por minuto y API key.
Facturacion con el mismo modelo de creditos que en la app.
El procesamiento de IA puede activarse como soberano en la UE (modo Sovereign); de lo contrario, hace falta una confirmacion de UE una sola vez.
Los errores llegan como JSON con error y code.

Aun no tienes un espacio de trabajo?

14 dias gratis, con la API incluida.

Empezar gratis

Preguntas frecuentes

Como me autentico en la API?+

Mediante la API key del espacio de trabajo en la cabecera X-API-Key. La key la generas en los ajustes, en Publicacion / API. Tratala como una contrasena.

Que hace el endpoint /compose?+

Una sola entrada y, por canal, una publicacion nativa redactada de forma independiente con la voz de tu marca. Consume creditos (la creacion mas un texto de IA por canal).

Hay un limite de peticiones?+

Si, 60 peticiones por minuto y API key. Se factura con el mismo modelo de creditos que en la app.

Es la API conforme al RGPD?+

Si. El procesamiento de IA puede activarse como soberano en la UE (modo Sovereign); de lo contrario, hace falta una confirmacion de UE una sola vez.

Hay una descripcion OpenAPI?+

Si, en /api/v1/openapi.json. Los errores llegan como JSON con los campos error y code.