API · v1
La API
Obtén este periódico como datos. Cada artículo publicado con los hechos que cita, más las secciones, el archivo, la búsqueda, la portada, las ediciones en video y una forma de suscribir a un lector. Sin llave. Sin registro.
https://colombia-news.newsroomfloor.com/api/v1Tu primera llamada
Los cinco artículos más recientes. Pega una línea.
curl -s "https://colombia-news.newsroomfloor.com/api/v1/stories?limit=5"const r = await fetch("https://colombia-news.newsroomfloor.com/api/v1/stories?limit=5");
const { stories } = await r.json();
for (const s of stories) console.log(s.headline, s.url);import requests r = requests.get("https://colombia-news.newsroomfloor.com/api/v1/stories", params={"limit": 5}) for s in r.json()["stories"]: print(s["headline"], s["url"])
Endpoints
Elige uno, llena los campos y ejecútalo. Llama a este periódico de verdad, así que lo que ves es lo que recibirá tu código.
Pon un artículo en tu propia página
Elige un artículo y copia el código. Muestra el titular, la imagen y el nombre del periódico, y enlaza de vuelta aquí. No pone cookies.
<iframe src="https://colombia-news.newsroomfloor.com/embed/STORY_ID" title="Story card" width="100%" height="260" style="border:0;width:100%;max-width:640px" loading="lazy"></iframe>
<iframe src="https://colombia-news.newsroomfloor.com/embed/STORY_ID" title="Story card" width="100%" height="260" style="border:0;width:100%;max-width:640px" loading="lazy"></iframe> <script> window.addEventListener("message", function (e) { if (!e.data || e.data.nrfEmbed !== 1) return; var f = document.querySelector('iframe[src*="/embed/STORY_ID"]'); if (f && e.data.height) f.style.height = e.data.height + "px"; }); </script>
https://colombia-news.newsroomfloor.com/story/STORY_ID
La versión simple funciona en cualquier sitio, incluso donde se eliminan los scripts. Usa la altura automática solo en una página que controles.
Qué puedes construir
Cuatro cosas que la gente pide. Cada una indica los endpoints que necesita.
Titulares en tu propio sitio
Trae los artículos más recientes. Muestra el titular, la sección y el enlace. Actualiza con un temporizador.
Un bot que publica el día
Un endpoint devuelve cada artículo ya medido para una publicación: titular, enlace, imagen.
Tu propia lista de correo
Recoge una dirección en tu página y envíala aquí. El lector confirma por correo antes de que salga nada.
Un agente que lee el periódico
Empieza por el índice. Lista cada endpoint. El archivo OpenAPI los describe y cada artículo lleva los hechos en los que se basa.
Quién puede leer qué
Lo que envías decide lo que recibes. No hay nada que configurar en la dirección.
Sin llave
Todo lo que este periódico publica: artículos, sus fuentes, las secciones, el archivo, la búsqueda. No envíes nada más.
Una llave del equipo
Para quienes publican este periódico. Añade borradores, pruebas de fuentes, configuración y la lista de suscriptores. Pídesela a un administrador y envíala como Authorization: Bearer nrf_...
Una llave de lector
Para un lector que inició sesión en este periódico. Añade lo que incluya su suscripción y nada más. La obtiene al iniciar sesión.
Antes de usarla
Uso
Léela, guárdala en caché, publícala, dásela a un modelo. Di de dónde vino y enlaza el artículo que cites.
Con qué frecuencia
El periódico cambia unas pocas veces al día. Llámalo cada varios minutos como mucho. En el endpoint de posts usa since= para recibir solo lo nuevo.
Notas al pie
El texto de un artículo lleva marcas [^1]. La lista cited_facts que lo acompaña dice qué es cada una. Muéstralas. Son la evidencia.
Firmas
Cada artículo se guarda con un hash de contenido y un recibo firmado. Eso prueba quién lo archivó y que no ha cambiado. No prueba que el artículo sea correcto.
Otros formatos
El mismo periódico en las formas que un programa espera.