Necesitas implementar una función que obtenga noticias frescas y específicas por sección (por ejemplo: “Tecnología → IA” o “Mundo → Medio Oriente”) sin construir un raspador personalizado o manejar múltiples feeds. Al final de este artículo, sabrás exactamente qué endpoint llamar para obtener noticias de temas por sección, cómo filtrar por país e idioma, y cómo integrarlo en tu aplicación utilizando un fragmento de código en curl o Python que puedas copiar y pegar.
Qué hace esta API y por qué es útil
La API de Datos de Noticias en Tiempo Real en Zyla API Hub proporciona datos de noticias estructurados que puedes consultar de tres maneras:
- Búsqueda: búsqueda basada en palabras clave a través de artículos de noticias.
- Principales Titulares: las últimas historias principales por país (y idioma/límite opcionales).
- Noticias de Temas por Sección: artículos dentro de una sección específica de un tema (por ejemplo, Tecnología) o de una publicación (por ejemplo, CNN, BBC).
Estos endpoints devuelven campos normalizados como título, enlace, fragmento, URLs de medios, autores, detalles de la fuente y una marca de tiempo UTC. Los casos de uso típicos incluyen widgets de noticias personalizadas, paneles editoriales, alertas automatizadas o enriquecimiento para sistemas de recomendación de contenido.
Si eres nuevo en Zyla, es un mercado de API con más de 10,000 APIs públicas y una forma estandarizada de autenticar y suscribirse. Puedes explorar categorías y proveedores directamente en Zyla API Hub, luego conecta la misma clave API en cualquier listado al que te suscribas.
Comenzando en Zyla API Hub
Abre la página de la API de Datos de Noticias en Tiempo Real y comienza una prueba. Zyla utiliza un modelo de suscripción + cuota (no pago por llamada). Para tu primera API, puedes comenzar una prueba de 7 días o 50 solicitudes. No hay Plan Gratuito. Después de suscribirte, recibirás una clave API que se puede usar en los endpoints de esta API.
- Ve al listado: Comienza prueba de 7 días en la API de Datos de Noticias en Tiempo Real
- Haz clic en Suscribirse (o Comenzar Prueba Gratuita si está disponible) y obtén tu clave API.
- Usa Authorization: Bearer YOUR_API_KEY en cada solicitud.
¿Necesitas evaluar otros conjuntos de datos más tarde? Puedes navegar y suscribirte a más listados en zylalabs.com con la misma cuenta y autenticación estándar.
Endpoints que usarás
1) Noticias de Temas por Sección
Usa esto para obtener artículos dentro de una sección específica de un tema (como “Mundo, Deportes, Tecnología”) o de una publicación (como CNN, BBC). Esta es la forma más directa de implementar “API para noticias de temas por sección.”
- Método: GET
- URL: https://zylalabs.com/api/7339/real-time-news-data-api/11656/topic-news-by-section
- Descripción: Obtener artículo de noticias en una sección específica de un tema (Mundo, Deportes, Tecnología, etc.) o publicación (CNN, BBC, etc.).
- Parámetros de solicitud:
- topic (cadena, requerido): por ejemplo, TECNOLOGÍA
- section (cadena, requerido): identificador de sección opaco
- limit (número, opcional): por ejemplo, 500
- country (cadena, opcional): por ejemplo, US
- language (cadena, opcional): por ejemplo, en
Ejemplo de curl (copia y pega y reemplaza YOUR_API_KEY):
curl -s -X GET "https://zylalabs.com/api/7339/real-time-news-data-api/11653/search?query=Elon+Musk" \
-H "Authorization: Bearer YOUR_API_KEY"
Notas:
- Los valores published_datetime_utc son marcas de tiempo ISO-8601 en UTC.
- Filtra por país e idioma si necesitas secciones localizadas o quieres reducir los resultados.
- El parámetro de sección es un identificador opaco requerido. Usa el valor que pretendes dirigir para el tema o publicación elegida.
2) Búsqueda
Encuentra artículos por un término de búsqueda. Útil para validar tu feed basado en secciones o llenar vacíos con contenido que coincida con palabras clave.
- Método: GET
- URL: https://zylalabs.com/api/7339/real-time-news-data-api/11653/search
- Descripción: Buscar artículos de noticias por consulta con una opción para limitar los resultados a un rango de tiempo específico.
- Parámetros de solicitud:
- query (cadena, requerido): por ejemplo, Elon Musk
Ejemplo oficial de curl (copia y pega esto exactamente):
Ejemplo de respuesta oficial (campos que puedes analizar como título, enlace, published_datetime_utc, autores, source_name):
{
"status": "OK",
"request_id": "1254b56e-7238-4807-9fa7-bd9256c0b66c",
"data": [
{
"title": "Cómo las raíces de la ‘mafia de PayPal’ se extienden hasta el apartheid en Sudáfrica",
"link": "https://www.theguardian.com/technology/2025/jan/26/elon-musk-peter-thiel-apartheid-south-africa",
"snippet": "Musk es parte de la “mafia de PayPal” de multimillonarios libertarios con raíces en Sudáfrica bajo el dominio blanco, ahora enormemente influyentes en la tecnología de EE. UU. ...",
"photo_url": "https://i.guim.co.uk/img/media/01d10e660767815cd5799030b4ff658664343b13/1_0_2998_1800/master/2998.jpg?width=465&dpr=1&s=none&crop=none",
"thumbnail_url": "https://news.google.com/api/attachments/CC8iL0NnNXphbFpzWm10S09YQnVSWGxTVFJDWEFoalJBeWdLTWdrQklKcEdIcWtXWndJ=-w200-h200-p-df-rw",
"published_datetime_utc": "2025-01-26T16:00:00.000Z",
"authors": [
"Chris McGreal"
],
"source_url": "https://www.theguardian.com",
"source_name": "The Guardian",
"source_logo_url": "https://lh3.googleusercontent.com/SU8FywVNtcrG-wgjvZ_0D1-3JR_pN9LNSgjULFH74N748KVyEdkF1jdbvP4Lr7_ClbPZxL-iPw",
"source_favicon_url": "https://encrypted-tbn0.gstatic.com/faviconV2?url=https://www.theguardian.com&client=NEWS_360&size=96&type=FAVICON&fallback_opts=TYPE,SIZE,URL",
"source_publication_id": "CAAqBggKMJeqezDfswk",
"related_topics": [
{
"topic_id": "CAAqIggKIhxDQkFTRHdvSkwyMHZNR1ppWm13MUVnSmxiaWdBUAE",
"topic_name": "Chris McGreal"
}
]
},
{
"title": "Bill Gates dice que piensa que es 'una locura' que Elon Musk pueda 'desestabilizar' la política en otros países",
"link": "https://www.businessinsider.com/gates-its-insane-that-musk-can-destabilize-foreign-politics-2025-1",
"snippet": "Bill Gates no le gusta cómo Elon Musk se ha involucrado en la política de países extranjeros como el Reino Unido y Alemania.",
"photo_url": "https://i.insider.com/679751e2eb4be2fff9a22f97?width=700",
"thumbnail_url": "https://news.google.com/api/attachments/CC8iI0NnNVpaRXhyYlRkVE9WRXhTbnB3VFJEZ0F4aUFCU2dLTWdB=-w200-h200-p-df-rw",
"published_datetime_utc": "2025-01-27T09:36:00.000Z",
"authors": [
"Kevin Tan"
],
"source_url": "https://www.businessinsider.com",
"source_name": "Business Insider",
"source_logo_url": "https://lh3.googleusercontent.com/MD0yHuvt1mX8YyHUcdTCsQqMKGubFCwbWmpxzkT1xnE5wZ4aDRmb2zvkgfgG_b0mHNhaSxqO2A",
"source_favicon_url": "https://encrypted-tbn3.gstatic.com/faviconV2?url=https://www.businessinsider.com&c…
Notas de campo que probablemente usarás:
- title, link, snippet: para renderizar la tarjeta o vista previa.
- photo_url, thumbnail_url: activos de imagen cuando estén disponibles.
- published_datetime_utc: marca de tiempo UTC ISO-8601 que puedes convertir a hora local.
- authors, source_name: atribución y etiquetado.
3) Principales Titulares
Obtén rápidamente los últimos titulares por país, con parámetros opcionales de idioma y límite.
- Método: GET
- URL: https://zylalabs.com/api/7339/real-time-news-data-api/11654/top-headlines
- Descripción: Obtener los últimos titulares de noticias/historias principales para un país.
- Parámetros de solicitud:
- limit (número, opcional): por ejemplo, 500
- country (cadena, opcional): por ejemplo, US
- lang (cadena, opcional): por ejemplo, en
Ejemplo de curl:
Ejemplo en Python: obtener noticias de temas por sección
Este script llama al endpoint de Noticias de Temas por Sección, luego imprime los campos esenciales. Reemplaza YOUR_API_KEY con tu clave y ajusta topic/section/country/language para tu caso de uso.
import os
import requests
API_KEY = os.getenv("ZylaApiKey", "YOUR_API_KEY")
url = "https://zylalabs.com/api/7339/real-time-news-data-api/11656/topic-news-by-section"
params = {
"topic": "TECNOLOGÍA",
"section": "CAQiSkNCQVNNUW9JTDIwdk1EZGpNWFlTQldWdUxVZENHZ0pKVENJT0NBUWFDZ29JTDIwdk1ETnliSFFxQ2hJSUwyMHZNRE55YkhRb0FBKi4IACoqCAoiJENCQVNGUW9JTDIwdk1EZGpNWFlTQldWdUxVZENHZ0pKVENnQVABUAE",
"limit": 50,
"country": "US",
"language": "en",
}
headers = {
"Authorization": f"Bearer {API_KEY}"
}
resp = requests.get(url, params=params, headers=headers, timeout=20)
resp.raise_for_status()
data = resp.json()
if data.get("status") == "OK":
for item in data.get("data", []):
title = item.get("title")
link = item.get("link")
published = item.get("published_datetime_utc")
source = item.get("source_name")
print(f"[{published}] {title} — {source} :: {link}")
else:
print("Estado no OK:", data)
Consejos de implementación:
- Cachea las respuestas por un corto período basado en las necesidades de tu interfaz de usuario para evitar búsquedas redundantes cuando los usuarios actualizan con frecuencia.
- Respeta el modelo de suscripción + cuota; evita el polling innecesario en cada vista de página. Distribuye del lado del servidor según sea necesario.
- Las marcas de tiempo están en UTC; conviértelas una vez en tu capa de API/servicio para evitar lógica de zona horaria repetida en el cliente.
Casos de uso prácticos que puedes implementar esta semana
- Páginas de aterrizaje de temas: Dirige secciones de “Tecnología → IA” o “Deportes → Fútbol” desde el endpoint de Noticias de Temas por Sección con filtros de país/idioma para localización.
- Relleno editorial: Cuando una sección tiene menos historias de las esperadas, ejecuta Búsqueda como una alternativa para palabras clave específicas y fusiona los resultados en el feed.
- Monitores de mercado/industria: Combina artículos de la sección de Tecnología con Búsqueda para empresas nombradas para alimentar paneles de inversores.
- Alertas/notificaciones: Consulta secciones relevantes para tus usuarios y envía actualizaciones cuando aparezcan nuevos artículos (compara enlace o título con tu conjunto de última vista).
Llamando a la API desde un agente de IA (MCP)
También puedes llamar a las APIs de Zyla a través de clientes compatibles con MCP (por ejemplo, Claude Code, Cursor, Windsurf) utilizando el endpoint MCP. Apunta tu agente o herramienta a:
https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY
Desde allí, emite las mismas solicitudes HTTP GET mostradas arriba con el encabezado de Autorización. Para más información sobre el transporte MCP, consulta MCP.
Detalles operativos que ahorran tiempo
- Autenticación: Usa el encabezado HTTP Authorization: Bearer YOUR_API_KEY para cada solicitud.
- Marcas de tiempo: published_datetime_utc está en UTC (ISO-8601). Normaliza temprano en tu pipeline.
- Filtrado: Para Noticias de Temas por Sección, topic y section son requeridos. country y language son refinamientos opcionales; usa limit para limitar el tamaño de la carga útil.
- Cuotas: La facturación de Zyla es por suscripción + cuota. Para la primera API, puedes comenzar una prueba de 7 días o 50 solicitudes. Consulta la página de la API para las opciones de acceso actuales y precios después de la prueba.
- Modelo de datos: Los objetos de artículo incluyen source_name, source_url y listas de autores para soportar la atribución adecuada en tu interfaz de usuario.
Flujo de extremo a extremo para implementar la función
- Comienza una prueba de la API de Datos de Noticias en Tiempo Real y obtén tu clave API: Comienza prueba de 7 días en la API de Datos de Noticias en Tiempo Real.
- Elige el tema y el identificador de sección que deseas potenciar (por ejemplo, TECNOLOGÍA + el valor de sección requerido).
- Llama al endpoint de Noticias de Temas por Sección del lado del servidor con Authorization: Bearer YOUR_API_KEY.
- Renderiza título, enlace, fragmento, photo_url/thumbnail_url y source_name. Convierte published_datetime_utc a la zona horaria de tus usuarios.
- Agrega un caché ligero o equivalente a ETag de tu lado para eliminar llamadas redundantes al actualizar.
- Opcionalmente, incorpora Búsqueda para llenar vacíos o crear desgloses por palabra clave.
FAQ
¿Cómo me autentico?
Incluye el encabezado Authorization: Bearer YOUR_API_KEY en cada solicitud.
¿Qué endpoint devuelve noticias de temas por sección?
GET https://zylalabs.com/api/7339/real-time-news-data-api/11656/topic-news-by-section con los parámetros requeridos topic y section. Los parámetros opcionales incluyen limit, country y language.
¿En qué zona horaria están las fechas de publicación?
published_datetime_utc se proporciona en UTC (ISO-8601). Conviértelo en tu cliente o capa de servidor según sea necesario.
¿Puedo también obtener titulares generales por país?
Sí. Usa GET https://zylalabs.com/api/7339/real-time-news-data-api/11654/top-headlines con parámetros opcionales limit, country y lang.
¿Cómo llamo esto desde un asistente o agente de código de IA?
Usa el transporte MCP en https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY en un cliente compatible con MCP, luego emite las mismas solicitudes GET con el encabezado de Autorización. Consulta MCP.
¿Listo para implementar noticias basadas en secciones hoy? Comienza tu prueba, obtén tu clave y conecta el endpoint de Noticias de Temas por Sección aquí: Comienza prueba de 7 días en la API de Datos de Noticias en Tiempo Real.