API de GenPosts

lockAutenticación

Todas las peticiones requieren tu clave de API en la cabecera Authorization.

Authorization: Bearer YOUR_API_KEY

También puedes usar la cabecera X-Api-Key: YOUR_API_KEY

apiEndpoints

Método	Endpoint	Descripción
POST	`/generate`	Genera contenido con una herramienta y devuelve el resultado.
GET	`/tools`	Lista las herramientas disponibles y sus campos.
GET	`/me`	Devuelve tu cuenta: saldo de palabras/créditos, plan y límite de peticiones.

terminalEjemplo: generar contenido

Envía la herramienta y sus campos; se factura por las palabras producidas.

curl -X POST https://genposts.app/api/v1/generate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"tool":"article","fields":{"title":"Guía de email marketing","keywords":"email marketing, automatización","article_type":"guide","intent":"informational","tone":"professional","length":"2000"},"language":"es"}'

import requests

r = requests.post(
    "https://genposts.app/api/v1/generate",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={"tool": "article",
          "fields": {"title": "Guía de email marketing",
                     "keywords": "email marketing, automatización",
                     "article_type": "guide", "intent": "informational",
                     "tone": "professional", "length": "2000"},
          "language": "es"},
)
print(r.json())

const res = await fetch("https://genposts.app/api/v1/generate", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    tool: "article",
    fields: { title: "Guía de email marketing", keywords: "email marketing",
             article_type: "guide", intent: "informational",
             tone: "professional", length: "2000" },
    language: "es",
  }),
});
console.log(await res.json());

$ch = curl_init("https://genposts.app/api/v1/generate");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => [
        "Authorization: Bearer YOUR_API_KEY",
        "Content-Type: application/json",
    ],
    CURLOPT_POSTFIELDS => json_encode([
        "tool"     => "article",
        "fields"   => ["title" => "Guía de email marketing", "keywords" => "email marketing",
                       "article_type" => "guide", "intent" => "informational",
                       "tone" => "professional", "length" => "2000"],
        "language" => "es",
    ]),
]);
echo curl_exec($ch);

tuneCampos del artículo

Campos aceptados por la herramienta "article" en "fields". Solo "title" es obligatorio; el resto son opcionales.

Campo	Tipo	Obligatorio	Valores admitidos
`title`	text	✓	—
`keywords`	text	—	—
`article_type`	select	—	`guide`, `review`, `listicle`, `tutorial`, `blog_post`, `case_study`, `comparison`, `pillar_page`
`intent`	select	—	`commercial`, `informational`, `transactional`
`note`	textarea	—	—
`tone`	select	—	`casual`, `formal`, `friendly`, `humorous`, `persuasive`, `informative`, `professional`, `authoritative`, `inspirational`, `conversational`
`length`	select	—	`1000`, `2000`, `3000`

Consulta los campos de cualquier herramienta con GET /tools.

data_objectRespuesta

La API devuelve JSON con el resultado y las palabras consumidas.

{
  "ok": true,
  "tool": "article",
  "result": "<h1>…</h1>",
  "words_used": 1240,
  "words_balance": 8760,
  "generation_id": 482
}

errorErrores

Código	Significado
`401`	Clave de API ausente o inválida.
`402`	No te quedan palabras suficientes.
`403`	Tu plan no permite el acceso a la API.
`422`	Parámetros faltantes o inválidos.
`429`	Demasiadas peticiones; espera un momento.