Saltar al contenido
Idioma — actual: Español
Tema — actual: Según el sistema

Google News

engine=google_news

Devuelve resultados de Google Search como JSON estructurado, desde el mismo endpoint que responde por cada motor.

Petición

GET
Restablecer

Parámetros

Enviar este parámetro Clave Valor Descripción
Autorización
api_keyobligatorio

SearchApi.io API key; alternatively send 'Authorization: Bearer <key>'.

Esta es la clave de SearchApi del propio autor, dejada aquí a propósito para que puedas ejecutar esta página de verdad sin registrarte. Sustitúyela por la tuya para ejecutar contra tu propia cuenta — la clave que esté en esta fila es la que gasta créditos al ejecutar en vivo, y la que llevan la dirección de arriba y cada muestra de código, así que una clave pegada aquí también viaja en un enlace que compartas. Ejecutar, junto a ella, responde desde una grabación y no gasta nada.

api_key_preset
por defecto

Qué clave de demostración enviar. La clave operativa resuelve la muestra grabada; las otras dos resuelven los sobres 401 y 429 grabados, de modo que el camino a un estado de error es el camino real de quien llama.

Requerido
qobligatorio

Search query; most engines accept native operators and advanced filters.

Segmentación Solo se envía lo que estableces. Devolverle a la API sus propios valores por defecto enviaría una docena de parámetros que nunca elegiste y enterraría los que sí.
google_domain
por defecto

Google domain to query, e.g. google.com, google.de.

gl
por defecto

Country of the search (two-letter country code).

hl
por defecto

Interface language of the search (two-letter language code).

location

Geographic origin of the search; canonical names come from the Locations API.

Tiempo
time_period

Restricts results by recency; custom uses time_period_min/max.

time_period_min

Start date for time_period=custom (MM/DD/YYYY).

time_period_max

End date for time_period=custom (MM/DD/YYYY).

Paginación
page
por defecto

Page number of the results.

num

Number of results per page.

Más Todo lo demás que este motor acepta, en el orden del catálogo.
uule

Encoded location cookie; alternative to `location` (do not use both).

sort_by

Order of the news results.

news_language

Restricts results to specific news languages.

JSON

Aún no se ha ejecutado nada. Envía la petición para ver la respuesta grabada.

Ejecutar responde desde una grabación servida desde disco. Para llamar a la API de verdad, pega tu propia clave en la ejecución en vivo de abajo.

Código

cURL
curl "https://www.searchapi.io/api/v1/search?engine=google_news&q=coffee&api_key=E5oa7LbhkKN7YUyj4CwXppK8"

Solo se envían los parámetros requeridos y los que tú estableces — la petición nunca repite a la API sus propios valores por defecto.

Úsalo desde un agente

Todos los motores del catálogo son accesibles desde un agente que ya tienes abierto. Conéctalo una vez y luego pregunta con palabras.

Conectar

claude mcp add searchapi "<YOUR_MCP_URL>" --transport http

Crea tu MCP URL en https://www.searchapi.io/integrations/mcp y pégala sobre el marcador de posición. El flujo de conexión es OAuth, así que tu clave de API nunca entra en la configuración de tu cliente.

Preguntar

Usando el motor Google News de SearchApi, ejecuta esta búsqueda y resume los resultados: q = "coffee"

Sigue a la petición de arriba — cambia un parámetro y esto cambia con él.

Llamar

Ambos describen la petición que construye el formulario de arriba.

El servidor MCP de SearchApi se consultó el 2026-08-11: remoto sobre Streamable HTTP, más de 80 herramientas, conexión OAuth. Qué motores cubre su lista de herramientas no se verificó aquí.

Parámetros

13 parámetros, leídos del catálogo al renderizar.

Parámetros que acepta el motor google_news
Parámetro Tipo Descripción
qobligatorio string

Search query; most engines accept native operators and advanced filters.

google_domain string

Google domain to query, e.g. google.com, google.de.

por defecto: google.com

gl enum

Country of the search (two-letter country code).

  • us (por defecto)
  • af
  • al
  • dz
  • as
  • ad
  • ao
  • ai
  • aq
  • ag
  • ar
  • am

227 valores más

hl enum

Interface language of the search (two-letter language code).

  • en (por defecto)
  • af
  • ak
  • sq
  • am
  • ar
  • hy
  • az
  • eu
  • be
  • bem
  • bn

134 valores más

location string

Geographic origin of the search; canonical names come from the Locations API.

uule string

Encoded location cookie; alternative to `location` (do not use both).

sort_by enum

Order of the news results.

  • relevance
  • date
  • source
news_language string

Restricts results to specific news languages.

time_period enum

Restricts results by recency; custom uses time_period_min/max.

  • last_hour
  • last_day
  • last_week
  • last_month
  • last_year
  • custom
time_period_min string

Start date for time_period=custom (MM/DD/YYYY).

time_period_max string

End date for time_period=custom (MM/DD/YYYY).

page integer

Page number of the results.

por defecto: 1

num integer

Number of results per page.

Toda petición también lleva

Tres parámetros están en todos los motores del catálogo: el motor que se llama, la clave que autentica la llamada y el interruptor de retención enterprise.

Parámetros comunes a todos los motores
Parámetro Tipo Descripción
engineobligatorio string

Engine that retrieves the data; fixed per API (see Apis::BY_ENGINE keys).

api_keyobligatorio string

SearchApi.io API key; alternatively send 'Authorization: Bearer <key>'.

zero_retention boolean

Enterprise-only: disables all logging and persistent storage of the search.

por defecto: false