Empezando
Aprende cómo realizar tu primera solicitud a la API y comienza a obtener datos de noticias.
¡Bienvenido a AllNewsAPI! Esta guía te mostrará los aspectos básicos del uso de nuestra API para obtener artículos de noticias de todo el mundo.
1. Obtén tu clave API
Primero, necesitarás una clave API para autenticar tus solicitudes. Regístrate para obtener una cuenta gratuita y consigue tu clave API al instante.
2. Haz tu primera solicitud
Una vez que tengas tu clave API, podrás realizar tu primera solicitud a la API. Aquí tienes un ejemplo sencillo para buscar artículos de noticias:
3. Entender 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 la página siguiente (nulo si está en la última página) |
articles | array | — | Una serie 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 del artículo de noticias |
articles[].category | string | — | La categoría a la que pertenece el artículo |
articles[].content | string | — | El contenido completo del artículo (función premium) |
articles[].country | string | — | El código del país donde se publicó el artículo (ISO 3166-1 alfa-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[].authors | array | — | Lista de nombres de autores de artículos |
articles[].ai_sentiment | string | — | Etiqueta de sentimiento detectada por IA (positiva, negativa o neutral). Solo para planes de pago. |
articles[].ai_sentiment_scores | object | — | Objeto que contiene puntuaciones de confianza para cada categoría de sentimiento. Solo para planes de pago. |
articles[].ai_entities | array | — | Conjunto de entidades con nombre extraídas, con campos de nombre y tipo. Solo para planes de pago. |
articles[].ai_summary | string | — | Resumen del contenido del artículo generado por IA. Solo para planes de pago. |
articles[].url | string | — | La URL directa al artículo original |
articles[].image | string | — | La URL de la imagen principal o miniatura del artículo |
articles[].publishedAt | string | — | 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 principal de la fuente de noticias |
El plan gratuito incluye acceso a noticias en tiempo real, hasta 50 solicitudes diarias y 7 días de datos históricos. ¡No se requiere tarjeta de crédito!
Próximos pasos
Ahora que has realizado tu primera solicitud, consulta estas guías para obtener más información: