Newsletter
Le entrega a este endpoint una lista sin ordenar de enlaces, titulares o notas que fue guardando durante la semana, y devuelve una edición de newsletter estructurada: secciones agrupadas, resúmenes breves y un orden coherente en vez de una lista plana de URLs. Existe para la parte de producir una newsletter que no es escribir, sino decidir qué va dónde.
Ejecútela online
Ejecute esto en nuestros servidores con su cuenta. Las herramientas gratuitas corren en su navegador; esta cobra de su saldo del KIT según el precio de arriba.
La parte que más tiempo consume
Resumir un solo enlace es rápido; lo lento es mirar cuarenta pestañas guardadas y decidir cuáles cinco importan, cómo agruparlas y qué orden hace que la edición se lea bien en lugar de sentirse como un volcado de enlaces. Este endpoint toma ese montón sin ordenar (enlaces, titulares o notas breves) y lo devuelve organizado en secciones con resúmenes, haciendo la selección editorial que normalmente se come una noche entera cada semana para quien escribe en solitario, o una tarde de viernes apurada para un equipo pequeño.
Cómo es la solicitud
Se hace POST a /text/newsletter con los enlaces o notas recopilados y cualquier preferencia de secciones que quiera que se respete. La tarea corre de forma asíncrona: recibe un task_id de inmediato, y la edición estructurada se entrega por webhook firmado o por un enlace firmado válido durante 24 horas, así que encaja en un flujo de publicación que arma el borrador y solo necesita una revisión humana final antes de enviarlo.
La curaduría como el producto real
El resurgimiento de la newsletter por correo como formato es, en gran medida, una historia de curaduría: la gente se suscribe no porque no pueda encontrar los artículos por su cuenta, sino porque alguien ya hizo el trabajo de filtrarlos y agruparlos en algo que vale diez minutos de lectura. Ese criterio editorial, más que cualquier oración individual, es lo que hace que valga la pena abrir la edición de la semana siguiente también. Automatizar el paso de estructurar no reemplaza ese criterio por completo, pero elimina la parte mecánica de agrupar y resumir, para que el tiempo del editor humano se concentre en las decisiones que realmente requieren buen gusto.
Cómo encaja en un flujo de publicación
Está pensado para escritores independientes que automatizan su rutina semanal, equipos de contenido que curan desde un repositorio compartido de enlaces, y plataformas donde los suscriptores mismos envían enlaces para un resumen comunitario. Como la entrega es asíncrona y por webhook, una herramienta de publicación puede disparar la generación en el momento en que se cierra la ventana de recolección semanal y tener el borrador estructurado listo antes de que el editor se siente a trabajar. El precio es $0.003 por solicitud más $0.0135 por edición, facturado solo cuando la edición se completa; las generaciones fallidas se reintentan automáticamente hasta tres veces sin costo.
Qué puede hacer con ella
Edición semanal en solitario
Quien escribe una newsletter por su cuenta suelta cuarenta enlaces guardados en el endpoint el viernes por la mañana y recibe un borrador por secciones antes del almuerzo, en vez de pasar la noche ordenándolo a mano.
Equipo curando desde un repositorio compartido
Un equipo de contenido recopila enlaces en un documento compartido durante toda la semana y genera la edición estructurada automáticamente al cerrar la ventana de recolección.
Resumen comunitario de enlaces
Una plataforma donde los suscriptores envían sus propios enlaces procesa el lote a través del endpoint para producir un resumen semanal coherente en vez de una lista cruda de aportes.
Boletín de varios temas
Una publicación que cubre distintos frentes envía enlaces etiquetados por tema y recibe una edición ya agrupada en secciones que corresponden a esos frentes.
Preguntas frecuentes
¿Es gratis la API para generar newsletters?
No hay capa gratuita: las capas gratis se abusan y ralentizan a todos. El acceso funciona con un saldo prepago de ForHosting KIT: se recarga desde $10.00 (no caduca) y cada solicitud se cobra a su precio publicado, así que una llamada sin saldo devuelve HTTP 402. Sin suscripción, sin tokens ni créditos inventados, y una tarea fallida no se cobra.
¿Escribe artículos completos o solo resume enlaces?
Estructura y resume lo que envía, agrupando enlaces en secciones con resúmenes breves, en lugar de escribir artículos originales largos desde cero.
¿Puedo controlar cómo se agrupan las secciones?
Sí, incluya sus preferencias de secciones en la solicitud y se respetan al estructurar la edición.
¿Cuántos enlaces puedo enviar en un mismo lote?
No hay un límite fijo en el formato: puede enviar desde unos pocos enlaces hasta un lote mucho más grande, y se organiza en una edición legible.
¿Cómo recibo la edición terminada?
Por webhook firmado, recomendado para flujos de publicación automatizados, o por un enlace firmado válido durante 24 horas si prefiere consultarlo manualmente.
¿Puedo generar varias ediciones en paralelo?
Sí: cada llamada a /text/newsletter es una tarea asíncrona independiente, así que se pueden procesar varias newsletters o varias semanas a la vez.
¿En qué formato viene el resultado?
Una edición estructurada con secciones y resúmenes en el orden que tiene sentido editorial, lista para llevar a su herramienta de envío con una edición final ligera.
¿Se guardan los enlaces que envío después de procesarlos?
No: se eliminan al terminar el periodo de retención y nunca se usan para entrenamiento; el único propósito del endpoint es producir su edición.
Para desarrolladores — acceso por API
Todo lo de esta página está disponible por programación. Esta sección es para equipos que quieren integrarlo en sus sistemas; el resto puede usar la herramienta de arriba sin más.
Endpoint de API
¿Prefiere automatizarlo? Un POST autenticado crea la tarea; el resultado llega por webhook o enlace firmado. La misma capacidad también se ejecuta aquí en la web, y pronto desde nuestra app, el email y Telegram.
Llámela desde su stack
curl -X POST https://api.kit.forhosting.com/text/newsletter \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"input":"…"}'const res = await fetch("https://api.kit.forhosting.com/text/newsletter", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"input": "…"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/text/newsletter",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"input": "…"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/text/newsletter", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"input":"…"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"input":"…"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/text/newsletter", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Ejemplo de solicitud
{
"input": "…"
}Ejemplo de respuesta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "text.newsletter",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}La API es asíncrona: la llamada devuelve un task_id al instante y el resultado llega por webhook. El polling está limitado a 1 req/s por tarea.
Precio
Precio publicado — sin tokens ni créditos inventados. Una tarea fallida no se cobra.
Límites
max_tokens | 20000 |
Errores
| HTTP | Código | Significado |
|---|---|---|
401 | unauthorized | API key ausente o inválida. |
402 | insufficient_balance | El saldo no cubre el precio de la tarea. |
404 | unknown_type | El tipo de tarea no existe. |
429 | rate_limited | Demasiadas peticiones. Use el webhook en vez de sondear. |
422 | task_failed | La tarea falló tras 3 reintentos. No se cobra. |