Empezando
Aprenda a realizar su primera solicitud de API y comience a obtener datos de noticias
¡Bienvenido a AllNewsAPI! Esta guía te explicará los conceptos básicos del uso de nuestra API para obtener noticias de todo el mundo.
1. Obtenga su clave API
Primero, necesitarás una clave API para autenticar tus solicitudes. Crea una cuenta gratuita para obtener tu clave API al instante.
2. Haz tu primera solicitud
Una vez que tengas tu clave API, puedes realizar tu primera solicitud. Aquí tienes un ejemplo sencillo para buscar noticias:
3. Comprenda la respuesta
La API devuelve una respuesta JSON que contiene una matriz de artículos de noticias. Cada artículo incluye las siguientes propiedades:
Nombre | Tipo | Valor predeterminado | Descripción |
|---|---|---|---|
totalArticles | integer | — | El número total de artículos que coinciden con su consulta de búsqueda |
currentPage | integer | — | El número de página actual en los resultados paginados |
nextPage | integer | — | El número de página siguiente (nulo si está en la última página) |
articles | array | — | Una matriz de objetos de artículos que coinciden con sus criterios de búsqueda |
articles[].title | string | — | El título del artículo de noticias |
articles[].description | string | — | La descripción o resumen de la noticia |
articles[].category | string | — | La categoría a la que pertenece el artículo |
articles[].content | string | — | El contenido completo de la noticia (función premium) |
articles[].country | string | — | El código del país donde se publicó el artículo (ISO 3166-1 alpha-2) |
articles[].region | string | — | La región geográfica donde se publicó el artículo |
articles[].lang | string | — | El código de idioma del artículo (ISO 639-1) |
articles[].sentiment | string | — | El sentimiento general del artículo (positivo, negativo, neutral) analizado mediante IA |
articles[].sentimentScores | object | — | Puntuaciones de sentimiento detalladas con valores numéricos para sentimientos negativos, neutrales y positivos |
articles[].url | string | — | La URL directa al artículo original |
articles[].image | string | — | La imagen principal o URL en miniatura del artículo |
articles[].publishedAt | string | — | La fecha y hora de publicación del artículo en formato ISO 8601 (UTC) |
articles[].source.name | string | — | El nombre del editor o fuente de noticias |
articles[].source.url | string | — | La URL de la página de inicio de la fuente de noticias |
El plan gratuito incluye acceso a noticias en tiempo real, hasta 100 solicitudes diarias y 7 días de datos históricos. ¡No se requiere tarjeta de crédito!
Próximos pasos
Ahora que ha realizado su primera solicitud, explore estas guías para obtener más información: