Saltar al contenido principal
Google SERP (Search Engine Results Page) es la página de resultados que los usuarios ven después de ingresar una consulta en el motor de búsqueda de Google. Muestra resultados de búsqueda orgánicos, anuncios, fragmentos destacados, gráficos de conocimiento y diversos contenidos como imágenes y videos, con el objetivo de proporcionar a los usuarios la información más relevante. Este artículo presentará en detalle Google SERP API, que puede proporcionar resultados al ingresar consultas en el motor de búsqueda de Google; el contenido de los resultados también incluye muchos tipos, como fragmentos destacados, gráficos de conocimiento e imágenes, entre muchos otros resultados. Este documento presentará las instrucciones de integración de Google SERP API.

Proceso de solicitud

Para usar Google SERP API, primero obtenga su API Token en la consola de Ace Data Cloud y guárdelo para uso posterior. Si aún no ha iniciado sesión o no se ha registrado, será redirigido automáticamente a la página de inicio de sesión para invitarlo a registrarse e iniciar sesión; al finalizar, regresará automáticamente a la página actual. Un API Token puede invocar todos los servicios de la plataforma, sin necesidad de solicitar uno por separado para cada servicio. La primera solicitud incluye créditos gratuitos, que pueden usarse para una experiencia gratuita; cuando los créditos sean insuficientes, puede recargar saldo general en la consola.
📘 Documentación completa: Google SERP API →

Uso básico

Ingrese palabras clave y el tipo de recurso de búsqueda para obtener resultados: use query para transmitir las palabras clave y type para seleccionar tipos de búsqueda como páginas web, imágenes, noticias, etc.; esta interfaz no requiere transmitir model. Por ejemplo, para buscar: información sobre “apple inc”, a continuación podemos completar el contenido correspondiente en la interfaz, como se muestra en la imagen:

Aquí podemos ver que configuramos los Request Headers, incluidos:
  • accept: qué formato de respuesta se desea recibir; aquí se completa como application/json, es decir, formato JSON.
  • authorization: la clave para invocar la API, que puede seleccionarse directamente en el menú desplegable después de solicitarla.
Además, configuramos el Request Body, incluido:
  • type: el tipo de recurso de búsqueda; actualmente solo se admiten seis tipos, y el valor predeterminado es search.
  • query: las palabras clave de búsqueda.
  • country: el país donde se encuentran los resultados de búsqueda personalizados; el valor predeterminado es Estados Unidos (US).
  • language: el idioma de los resultados de búsqueda personalizados; el valor predeterminado es inglés (en).
  • range: el rango de tiempo de los resultados de búsqueda personalizados; el valor predeterminado es sin límite.
  • number: el tamaño de página de la paginación de los resultados de búsqueda personalizados; el valor predeterminado es 10.
  • page: el número de página de la paginación de los resultados de búsqueda personalizados; el valor predeterminado es 1.
Después de seleccionar, se puede observar que también se genera el código correspondiente en el lado derecho, como se muestra en la imagen:

Haga clic en el botón «Try» para realizar la prueba; como se muestra en la imagen anterior, aquí obtenemos los siguientes resultados:
El resultado devuelto contiene varios campos, que se presentan a continuación:
  • knowledge_graph, el grafo de conocimiento de los resultados de búsqueda.
  • organic, la información detallada de los resultados de búsqueda.
  • people_also_ask, las preguntas relacionadas con las palabras clave de búsqueda.
  • related_searches, las búsquedas relacionadas con las palabras clave de búsqueda.
Se puede ver que hay un campo organic en los resultados devueltos aquí, que contiene principalmente los resultados de las palabras clave de búsqueda. Además, si desea generar el código de integración correspondiente, puede copiarlo y generarlo directamente; por ejemplo, el código CURL es el siguiente:
El código de integración de Python es el siguiente:

Tipo de búsqueda personalizado

Si personaliza el tipo de recursos de búsqueda, podemos modificar el parámetro type, que incluye respectivamente recursos normales search, recursos de imágenes images, recursos de noticias news, recursos de mapas maps, recursos de regiones places y recursos de videos videos; este artículo utilizará los recursos de videos videos como demostración. A continuación, demostraremos las operaciones específicas. Primero, establezca el parámetro type en videos y pase el parámetro query normalmente, como se muestra en la imagen:

El código correspondiente es el siguiente:
Se puede obtener la siguiente respuesta:
El resultado devuelto contiene varios campos, que se presentan a continuación:
  • news, lista de información de vídeos en los resultados de búsqueda.
Se puede ver que hay un campo videos en los resultados devueltos aquí, que contiene principalmente los resultados de las palabras clave de búsqueda.

Personalizar el país donde se encuentran los recursos de búsqueda

Esta interfaz también permite limitar el país donde se encuentran los resultados de búsqueda. Podemos añadir el parámetro country para limitar el país. El parámetro introducido es la abreviatura del país, por ejemplo, cn (China), us (Estados Unidos). Este artículo utilizará China como el siguiente ejemplo; a continuación se muestra la información específica:

El efecto de salida es el siguiente:
Se puede ver que, en los resultados, se encuentran los resultados de búsqueda del país China, y el contenido específico es similar al anterior.

Idioma personalizado de los resultados de búsqueda

También podemos personalizar el idioma de los resultados de búsqueda. Aquí añadimos adicionalmente el campo language, con el contenido zh-cn, donde se refiere al idioma chino simplificado. También admite otros idiomas, pero se debe introducir la abreviatura del idioma, como en (English), fr (French), zh-cn (Chinese(Simplified)), etc., como se muestra en la imagen:

El código correspondiente es el siguiente:
El resultado de ejecución es el siguiente:
Se puede ver que los resultados mostrados aquí están todos en chino simplificado, y el contenido de los resultados es similar al anterior.

Personalizar el intervalo de tiempo de los resultados de búsqueda

Este artículo también puede personalizar el intervalo de tiempo de los resultados de búsqueda, incluyendo cinco tipos: qdr:h (la última hora), qdr:d (el último día), qdr:w (la última semana), qdr:m (el último mes) y sin restricciones de forma predeterminada. Podemos pasar el intervalo de tiempo correspondiente mediante range; por ejemplo, aquí se establece como qdr:d, lo que indica la búsqueda de resultados del último día, por lo que la entrada es la siguiente:

El código correspondiente es el siguiente:
El resultado de la ejecución es el siguiente:
Se puede ver que hemos obtenido correctamente los resultados de búsqueda del último día, y el contenido de los resultados es similar al anterior.

Personalizar la paginación de los resultados de búsqueda

Esta API también admite la visualización paginada personalizada de los resultados de búsqueda. number y page representan el tamaño de página y el número de página de la paginación. En este artículo se configurará la paginación con 20 resultados de búsqueda por página; la información específica se muestra en la imagen:

Nota: cuando los resultados por página superen los 10, los créditos deducidos se duplicarán.
El código es el siguiente:
El resultado de ejecución es el siguiente:
Se puede ver que aquí presenta los resultados de búsqueda paginados, mostrando 20 resultados en una página, y el contenido de los resultados es similar al anterior.