API de Google News
Google News reúne artículos de medios de comunicación. search devuelve hasta 20 artículos recientes de una consulta con título, enlace, medio, extracto, fecha de publicación e imagen.
Los resultados siguen la edición elegida con country y language (por defecto us y en). Limita la antigüedad con time_window. La palabra clave acepta operadores de Google como site:cnn.com, OR y -palabra. La llamada cuesta lo mismo con 1 que con 20 artículos, y Google News a veces devuelve menos de los pedidos.
Disponibilidad de la plataforma
- Salud 24 h
- Normal
Últimos 30 días
Funciones disponibles
Cada acción de Google News, qué hace, su precio y su salud en las últimas 24 horas. Abre una acción para ver sus parámetros, campos de respuesta y ejemplos de código.
| Capacidad | Qué hace | Por 1.000 | Salud en 24 horas |
|---|---|---|---|
Buscar noticias en Google Newssearch | Envía una keyword para listar hasta 20 artículos de Google News con title, url, source, text, published_at e image_url. | $0.79 por 1.000 solicitudes | Normal |
Abre una capacidad para ver sus parámetros, campos de respuesta, ejemplos de código y prueba.
¿Qué acepta cada acción de Google News?
Cada respuesta enlaza una acción ejecutable con sus entradas reales. El significado y los valores permitidos pertenecen a esa acción; un nombre parecido no conserva automáticamente el mismo sentido en otra plataforma.
Las fuentes oficiales se enlazan solo para precisar el término de la plataforma indicado a su lado. No implican autorización ni respaldo y no añaden a EveryInfra funciones del sitio oficial.
| Acción | Obligatorios | Opcionales | Entrega | Límite | Por 1.000 | Campos de respuesta |
|---|---|---|---|---|---|---|
searchBuscar noticias en Google News Envía una | keyword | country, language, time_window | Entrega síncrona | El catálogo declara defaultLimit = 20 y maxLimit = 20 para el límite de esta acción. Según la acción, la unidad puede aplicarse a una página, a cada elemento padre o a otra unidad propia de la acción; no es necesariamente el total final de filas de toda la solicitud. | $0.79 por 1.000 solicitudes | rank · title · url · source · text · published_at · image_url · platform |
¿Qué significan los parámetros de Google News search?
Envía una keyword para listar hasta 20 artículos de Google News con title, url, source, text, published_at e image_url. Filtra con country, language y time_window (hour, day, week, month o year). No incluye el texto completo del artículo.
keywordObligatorio- Término de búsqueda de noticias, como
OpenAI. Admite operadores de Google:site:cnn.com,ORy-palabrapara excluir. Hasta 500 caracteres.Ayuda de Google: operadores para afinar las búsquedas — La ayuda de Google Search explica operadores como `site:` para limitar a un sitio, `-` para excluir palabras y las comillas para frases exactas, escritos sin espacio entre el operador y el término. La fuente solo describe la sintaxis de búsqueda de Google; que `keyword` de esta API acepte esos operadores en Google News y los filtros `country`, `language` y `time_window` los define EveryInfra, y la fuente no garantiza resultados ni cantidades. · Consultada countryOpcional- Código de país de dos letras, como
us,gbode, de la edición de Google News (por defectous). languageOpcional- Código de idioma de dos letras, como
en,esode, de la edición (por defectoen). time_windowOpcional- Solo artículos de este periodo:
hour,day,week,monthoyear. Sin él, no hay límite de fecha.
Cómo usar la API de Google News
- 01Consulta el catálogo público y elige una acción de la plataforma.
- 02Envía los parámetros platform y action, junto con los campos obligatorios, a POST /api/v1/social.
- 03Procesa el resultado síncrono o consulta el identificador de trabajo cuando la acción se ejecute de forma asíncrona.
- 04Guarda los campos de la respuesta estructurada que necesita tu aplicación.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"google_news","action":"search","params":{"keyword":"<keyword>"}}'
Preguntas sobre la API de Google News
¿Cómo llamo a la API de Google News?
Envía POST /api/v1/social con platform igual a google_news, elige uno de los identificadores de acción indicados e incluye sus parámetros obligatorios.
¿Qué devuelve la API de Google News?
Devuelve JSON estructurado. Por ejemplo, el esquema de search incluye rank, title, source y text. Cada acción tiene su propia lista de campos; que un campo esté declarado no garantiza que todos los registros tengan un valor.
¿Qué matiz de la documentación oficial conviene conservar al usar datos de Google News?
La ayuda de Google Search explica operadores como site: para limitar a un sitio, - para excluir palabras y las comillas para frases exactas, escritos sin espacio entre el operador y el término. La fuente solo describe la sintaxis de búsqueda de Google; que keyword de esta API acepte esos operadores en Google News y los filtros country, language y time_window los define EveryInfra, y la fuente no garantiza resultados ni cantidades.
¿Qué parámetros son obligatorios?
Depende de la acción. search requiere keyword.
¿Las acciones de Google News responden de inmediato?
Las acciones marcadas como asíncronas devuelven un identificador de trabajo que se consulta por sondeo. Cualquier otra acción también puede ejecutarse de forma asíncrona: añade "mode": "async" al cuerpo de la solicitud para recibir el identificador de inmediato, útil para tareas lentas o límites altos.