Punto final de búsqueda
Busque artículos de noticias utilizando palabras clave, filtros y sintaxis de consulta avanzada.
El punto final de búsqueda le permite buscar artículos de noticias en toda nuestra base de datos utilizando palabras clave, frases y operadores de consulta avanzados. Filtre los resultados por idioma, país, categoría, rango de fechas y más.
https://api.allnewsapi.com/searchParámetros de consulta
Nombre | Tipo | Valor predeterminado | Descripción |
|---|---|---|---|
apikeyRequerido | string | — | Tu clave API para autenticación. Obtén tu clave API desde el panel de control. |
q | string | — | Este parámetro te permite obtener artículos de noticias que coincidan con tu palabra clave. Tus palabras clave ayudan al sistema a encontrar los artículos más adecuados para ti. Puedes usar palabras junto con operadores lógicos, sobre los que puedes obtener más información en el Ejemplos: technology"artificial intelligence"apple AND iphone |
startDate | string | — | Este parámetro le permite filtrar artículos según su fecha de publicación. Puede especificar una fecha y la API solo devolverá los artículos publicados en o después de esa fecha. Ejemplos: 2024-12-15T17:48:56Z2025-05-20 |
endDate | string | — | Este parámetro te permite filtrar artículos según su fecha de publicación. Puedes especificar una fecha y la API solo devolverá los artículos publicados en o antes de esa fecha. Ejemplos: 2024-08-14T17:48:56Z2024-01-23 |
content | boolean | false | Este parámetro le permite recuperar el contenido completo de los artículos. Por defecto, el contenido está recortado. Establézcalo en verdadero para obtener el contenido completo. Ejemplos: truefalse |
lang | string | — | Este parámetro le permite especificar el idioma de los artículos de noticias devueltos por la API. Puede combinar varios idiomas separándolos con una coma. Consulte la lista de Ejemplos: enen,fr,de |
country | string | — | Este parámetro le permite especificar el país donde se publicaron los artículos de noticias devueltos por la API. Puede combinar varios países separándolos con una coma. Consulte la lista completa de Ejemplos: usgb,de,fr |
region | string | — | Este parámetro le permite especificar la región donde se publicaron los artículos de noticias devueltos por la API. Puede combinar varias regiones separándolas con una coma. Consulte la lista completa de Ejemplos: americasafrica,asia |
category | string | — | Este parámetro le permite filtrar los artículos de noticias devueltos por una categoría específica. Puede combinar varias categorías separándolas con una coma. Consulte la lista completa de Ejemplos: financefood,health,hobbies,lifestyle |
max | integer | 5 | Este parámetro le permite especificar la cantidad de artículos de noticias que la API devuelve en una sola solicitud. Los valores válidos están entre 1 y 100, dependiendo de su suscripción. Ejemplos: 1020 |
attributes | string | title,description | Este parámetro permite seleccionar en qué partes de los artículos de noticias se buscarán las palabras clave. Los valores válidos son título , descripción y contenido . Se pueden combinar varios atributos separándolos con una coma. Por ejemplo, "título,descripción" significa que se buscará tanto en el título como en la descripción. Ejemplos: titletitle,description,content |
page | integer | 1 | Este parámetro permite controlar la paginación de los resultados que devuelve la API. Cada página muestra un número determinado de artículos, según el valor de "max". Ejemplos: 120 |
sortby | string | publishedAt | Este parámetro te permite elegir cómo se ordenan los artículos. Hay dos opciones: Ejemplos: publishedAtrelevance |
publisher | string | — | Busca noticias de un editor específico. Puedes combinar varios editores separándolos con una coma. Ejemplos: bbc.comforbes.com,cnn.com,bbc.com |
format | string | json | Este parámetro le permite seleccionar el formato de datos devuelto por la API. Puede elegir entre json, csv, or xlsx Ejemplos: csvxlsx |
ai_sentiment | string | — | Filtrar artículos por valor de sentimiento detectado por IA Ejemplos: positivenegativeneutral |
ai_entity_name | string | — | Filtrar artículos por nombre de entidad extraído (separados por comas si hay varios). Ejemplos: AppleMicrosoft,Google |
ai_entity_type | string | — | Filtrar artículos por tipo de entidad, como PERSONA, ORGANIZACIÓN, UBICACIÓN (separados por comas para múltiples entidades). Ejemplos: ORGPERSON,LOC |
Respuesta
La API devuelve un objeto JSON que contiene una matriz de artículos de noticias que coinciden con sus criterios de búsqueda.
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 |