GET/api/v1/articles
Listado filtrable y paginado de noticias.
Cómo consultar la API REST
Todos los endpoints devuelven JSON. Puedes consultar noticias con filtros combinables y recorrer resultados mediante limit y offset.
URL base: usa el mismo dominio donde está abierto este panel. Por ejemplo,
http://localhost:8080/api/v1/articles. Las lecturas son públicas por defecto; si envías X-API-Key, la llave debe ser válida.
Noticias
GET
GET/api/v1/articles/{id}
Detalle completo, contenido, etiquetas y entidades de una noticia.
GET/api/v1/latest?limit=20
Noticias más recientes. Acepta hasta 50 registros.
GET/api/v1/search?q=agave
Atajo de búsqueda; admite los mismos filtros del listado.
Parámetros de /articles
| Parámetro | Uso | Ejemplo |
|---|---|---|
search o q | Busca en título, resumen y texto. | tequila |
source | Slug exacto de la fuente. | crt |
category | Categoría exacta. | exports |
tag | Etiqueta exacta. | noticias |
language / country | Idioma y país. | es / MX |
date_from / date_to | Rango de fecha. | 2026-09-01 |
sentiment | Sentimiento calculado. | neutral |
importance_min | Score mínimo. | 7 |
limit | Resultados por página, de 1 a 100. | 50 |
offset | Registros que se omiten para paginar. | 100 |
Ejemplos
cURL
curl "http://localhost:8080/api/v1/articles?search=tequila&date_from=2026-09-01&limit=20&offset=0"
JavaScript
const params = new URLSearchParams({
source: 'crt',
importance_min: '7',
limit: '20',
offset: '0'
});
const response = await fetch(`/api/v1/articles?${params}`);
const result = await response.json();
console.log(result.data);
console.log(result.pagination.total);
Respuesta paginada
{
"success": true,
"data": [ ... ],
"pagination": {
"limit": 20,
"offset": 0,
"total": 486
}
}
Fuentes y estado
GET/api/v1/sources
Fuentes configuradas y número de artículos por fuente.
GET/api/v1/sources/{slug}/articles
Noticias de una fuente específica.
GET/api/v1/stats
Totales, actividad y agrupaciones.
GET/api/v1/health
Estado de la base de datos y último rastreo.
Feeds
GET/feed
Feed RSS XML general.
GET/feed/{fuente}
Feed RSS XML de una fuente.
GET/feed.json
Feed en formato JSON.