API de Articulia

Genera artículos SEO por IA desde tus propias herramientas, scripts o integraciones (Zapier, Make, n8n, etc.). Necesitas una API key, disponible en Mi cuenta → Integraciones.

Autenticación

Todas las peticiones requieren tu API key en la cabecera Authorization:

Authorization: Bearer art_live_xxxxxxxxxxxxxxxx

Generar un artículo

POST https://articulia.com/api/v1/articulos

curl -X POST https://articulia.com/api/v1/articulos \
  -H "Authorization: Bearer art_live_xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "keyword": "mejores auriculares bluetooth",
    "tono": "profesional",
    "longitud": "media"
  }'

Parámetros:

• keyword (obligatorio) — la keyword sobre la que generar el artículo.
• tono (opcional) — profesional, seo, periodistico, divulgativo o blog. Por defecto profesional.
• longitud (opcional) — corta, media o larga. Por defecto media.

Respuesta:

{
  "success": true,
  "articulo": {
    "id": "uuid",
    "keyword": "mejores auriculares bluetooth",
    "contenido": "# Los mejores auriculares...",
    "seo": { "titulo": "...", "meta": "...", "slug": "...", "keywords": [...] },
    "faq": { "faqs": [...], "schema": "..." },
    "intencion": { "intencion": "comercial", "descripcion": "...", "enfoque": "..." }
  },
  "uso": { "usados": 4, "limite": 50, "plan": "pro" }
}

Límites y errores

Cada petición consume palabras de tu cuota mensual según tu plan (2.000 en el plan gratis, 20.000 en Pro, 350.000 en Empresa). Además, cada API key está limitada a 10 peticiones por minuto. Si superas la cuota mensual recibirás un 403; si superas el límite de peticiones por minuto, un 429.

Webhooks (Zapier, Make, n8n)

Si prefieres recibir un aviso automático cada vez que se genera un artículo desde el dashboard, configura una URL de webhook en Mi cuenta → Integraciones. Articulia enviará un POST con { evento, keyword, id, creado_en } cada vez que generes un artículo.