● API v2 — story-centric

Las noticias, entendidas como historias, no como artículos sueltos.

NewsPulse.io agrupa miles de fuentes globales en historias rankeadas por relevancia, detecta sesgo y sentimiento por artículo, y lo entrega todo en una API REST limpia y predecible.

5recursos REST
1,000requests/día en el plan Starter
60sTTL de caché en listados
cURL
JavaScript
Python
# Top headlines en Colombia, ranking multi-factor
curl "https://api.newspulse.io/v2/top-headlines?country=CO&limit=3" \
  -H "Authorization: Bearer mmn_live_••••••••••"
const res = await fetch(
  "https://api.newspulse.io/v2/top-headlines?country=CO&limit=3",
  { headers: { Authorization: "Bearer mmn_live_••••••••••" } }
);
const { stories } = await res.json();
import requests

r = requests.get(
    "https://api.newspulse.io/v2/top-headlines",
    params={"country": "CO", "limit": 3},
    headers={"Authorization": "Bearer mmn_live_••••••••••"},
)
print(r.json())
RESPUESTA →
{
  "stories": [{
    "title": "Colombia anuncia nuevo marco de política climática",
    "status": "developing",
    "headlineScore": 7.42,
    "uniqueSources": 14,
    "sentimentDistribution": { "neutral": 0.6, … }
  }],
  "meta": { "period": "24h", "country": "CO" }
}

Ejemplos en vivo

Así se ve un request real.

Cinco formas distintas de consultar la misma API — copia cualquiera de estos requests y pruébalo tú mismo.

Titulares en Colombia, rankeados por autoridad, velocidad y cobertura

GET https://api.newspulse.io/v2/top-headlines?country=CO&limit=3
Authorization: Bearer mmn_live_••••••••••
{
  "stories": [
    {
      "title": "Colombia anuncia nuevo marco de política climática",
      "status": "developing",
      "headlineScore": 7.42,
      "uniqueSources": 14,
      "countries": ["CO", "US"]
    },
    { … }
  ],
  "meta": { "limit": 3, "period": "24h", "country": "CO" }
}

Historias acelerando más rápido en las últimas 3 horas

GET https://api.newspulse.io/v2/trending?limit=5
Authorization: Bearer mmn_live_••••••••••
{
  "stories": [
    {
      "title": "Banco central sorprende con recorte de tasas",
      "velocityScore": 4.86,
      "velocityBreakdown": {
        "recentVelocity": 4.86,
        "acceleration": 1.46
      },
      "articleCount": 23
    },
    { … }
  ]
}

Búsqueda full-text sobre inteligencia artificial, solo en español

GET https://api.newspulse.io/v2/search?q=inteligencia+artificial&language=es
Authorization: Bearer mmn_live_••••••••••
{
  "results": [
    {
      "article": {
        "title": "Cómo la IA generativa está transformando la industria del software",
        "source": { "name": "El Tiempo" }
      },
      "relevanceScore": 0.83
    }
  ],
  "relatedStories": [
    { "title": "Regulación de IA avanza en el Congreso" }
  ],
  "meta": { "limit": 20, "took_ms": 34 }
}

Artículos de Reuters y AP de la última semana

GET https://api.newspulse.io/v2/articles?sources=reuters.com,apnews.com&date_from=2026-08-06
Authorization: Bearer mmn_live_••••••••••
{
  "items": [
    {
      "title": "Mercados globales cierran mixtos tras datos de inflación",
      "source": { "name": "Reuters", "domain": "reuters.com" },
      "publishedAt": "2026-08-13T09:12:00Z"
    },
    { … }
  ],
      "total": 214
}

Artículos de sentimiento positivo de EE.UU. en los últimos ocho meses

GET https://api.newspulse.io/v2/articles?sentiment=positive&limit=10&country=US&date_from=2026-08-01&date_to=2026-08-30
Authorization: Bearer mmn_live_••••••••••
{
  "items": [
    {
      "title": "Los mercados repuntan mientras la inflación baja a su nivel más bajo en dos años",
      "sentiment": "positive",
      "source": { "name": "AP", "domain": "apnews.com" },
      "publishedAt": "2026-08-28T14:05:00Z"
    },
    { … }
  ],
  "total": 47
}

Producto

Todo lo que necesitas de un feed de noticias, en cuatro capas.

No es un scraper con paginación. Es un pipeline de clustering, ranking y análisis que corre sobre cada artículo antes de que llegue a tu request.

01

Clustering de historias

Artículos de distintas fuentes sobre el mismo hecho se agrupan en una sola story, con artículo canónico y cobertura consolidada.

02

Ranking multi-factor

headline_score combina autoridad de fuente, diversidad de cobertura, velocidad, recencia y engagement — con pesos configurables.

03

Sesgo & sentimiento

Distribución de sentimiento y de sesgo político por historia, con detección automática de perspectivas por grupo editorial.

04

Búsqueda híbrida

Full-text con tsvector + similitud por trigramas para tolerar errores de tipeo. Sin Elasticsearch ni infraestructura extra.

Cómo funciona

De miles de fuentes crudas a una historia rankeada.

Paso Uno

Ingesta continua

Se ingestan artículos de miles de fuentes globales, con metadatos de idioma, país y credibilidad de la fuente.

Paso Dos

Cluster & score

Los artículos se agrupan por similitud, se calcula headline_score y velocity_score, y se clasifica el estado del ciclo de vida de la historia.

Paso Tres

Query vía API

Consultas con filtros de país, idioma, categoría, sentimiento o rango de fechas — y recibes JSON listo para tu producto.


Endpoints

Cinco recursos. Una convención consistente.

Todos los endpoints de listado soportan paginación, filtros por país/idioma/categoría/fuente, y devuelven metadata de caché.

GET/v2/articlesArtículos paginados
GET/v2/sourcesDirectorio de fuentes
GET/v2/storiesClusters de historias
GET/v2/stories/:id/timelineEvolución de la historia
GET/v2/top-headlinesRanking multi-factor
GET/v2/trendingVelocidad de cobertura
GET/v2/searchFull-text + trigram
POST/v2/auth/keysCrear API key
Diferencial

Pensada para ir más allá del artículo individual.

CaracterísticaAPIs de noticias tradicionalesNewsPulse.io API
Unidad de contenidoArtículoHistoria (cluster)
RankingPopularidad / fechaMulti-factor: autoridad, velocidad, diversidad, recencia
Relevancia geográficaSolo filtroScoring de relevancia internacional (IRP)
Sesgo & sentimientoNo disponiblePor artículo y por historia
Perspectivas múltiplesNo disponibleDetección automática por grupo de sesgo
Timeline de historiaNo disponibleEvolución con snapshots periódicos
TrendingNo disponibleBasado en velocidad y aceleración
BúsquedaCoincidencia exactaFull-text híbrida + trigram

Infraestructura

Construida sobre piezas aburridas y confiables.

Sin capas innecesarias: Postgres es la única fuente de verdad, Redis cachea lo caliente, y las colas procesan el enriquecimiento en background.

PostgreSQL + pgvector + pg_trgm Fastify 5 sobre Node.js Redis cache & rate limiting BullMQ workers & cron TypeScript estricto de punta a punta OpenAPI 3 + docs interactivas
Precios

Precios simples. Escala cuando lo necesites.

✓ Uso comercial y en producción permitido en todos los planes
Starter
Para empezar
  • 30 requests / minuto
  • 1,000 requests / día
  • 100 búsquedas / día
  • Acceso a historias, timeline y trending
  • Soporte por email
Enterprise
Para escala
Desde $999/mes
  • 1,000+ requests / minuto
  • 100,000+ requests / día
  • Búsquedas ilimitadas
  • Soporte prioritario
  • SLA & soporte dedicado
  • Límites a medida
  • Soporte por email
Solicitar cotización
Test
Para probar
Gratis
  • 10 requests / minuto
  • 100 requests / día
  • Soporte por email
Crear cuenta gratis

Tu primera historia rankeada, a un request de distancia.

Obtener API Key →