circle-check
Documentation has been updated: see help center and changelog in one place.

Búsqueda web

Scraper integral de Google Search con datos parseados para resultados orgánicos, anuncios, snippets, paneles de conocimiento, historias destacadas y más.

El google_search la fuente está diseñada para recuperar resultados de Google Search (SERP) y Google AI Overviews. Esta subpágina presenta específicamente información relacionada con la búsqueda web de Google. Para explorar otros tipos de resultados, lea Búsqueda de imágenes o Búsqueda de noticias.

Ejemplos de solicitud

En los ejemplos a continuación, hacemos una solicitud para obtener 2 páginas de resultados, desde el número 11 al número 12 , para el término de búsqueda adidas. El SERP se filtrará para contener solo resultados en francés. La API devolverá resultados parseados.

curl 'https://realtime.oxylabs.io/v1/queries' \
--user 'USERNAME:PASSWORD' \
-H 'Content-Type: application/json' \
-d '{
        "source": "google_search",
        "query": "adidas",
        "start_page": 11,
        "pages": 2,
        "parse": true,
        "context": [
            {
                "key": "results_language",
                "value": "fr"
            }
        ]
    }'

Usamos el método de integración síncrono Realtime en nuestros ejemplos. Si desea usar Proxy Endpoint o la integración asíncrona Push-Pull consulte los métodos de integración sección.

Valores de parámetros de la solicitud

Genérico

Opciones básicas de configuración y personalización para raspar resultados de la búsqueda web de Google.

Parámetro
Descripción
Valor predeterminado

source

Establece el scraper.

google_search

query

La palabra clave o frase para buscar.

-

render

Activa el renderizado de JavaScript cuando se establece en html. Más información.

-

parse

Devuelve datos parseados cuando se establece en true. Explorar diccionario de salida diccionario de datos.

false

callback_url

URL a su endpoint de callback. Más información.

-

user_agent_type

Tipo de dispositivo y navegador. La lista completa se puede encontrar aquí.

desktop

- parámetro obligatorio

Operadores avanzados de búsqueda de Google

Al raspar, puede resultar útil combinar operadores avanzados de búsqueda de Google con su consulta. Le permite personalizar el alcance de la búsqueda, asegurando que los resultados sean más relevantes y focalizados. Explore estos comandos especiales aquíarrow-up-right y aquíarrow-up-right. Vea un ejemplo abajo.

Localización

Adapte los resultados de búsqueda a ubicaciones geográficas, configuraciones regionales y idiomas específicos.

Parámetro
Descripción
Valor predeterminado

geo_location

La ubicación geográfica para la que se deben adaptar los resultados. Usar este parámetro correctamente es extremadamente importante para obtener los datos adecuados. Para más información, lea sobre nuestras sugeridas geo_location estructuras de parámetros aquí.

-

locale

Valor del encabezado Accept-Language que cambia el idioma de la interfaz web de la página de búsqueda de Google. context Más información.

-

results_language: Idioma de los resultados. La lista de idiomas de Google compatibles se puede encontrar

. Aprenda cómo usar los parámetros de contexto aquíPaginación aquí.

-

Controles para gestionar la paginación y la recuperación de resultados de búsqueda.

Nota:

circle-exclamation
Parámetro
Descripción
Valor predeterminado

Número de página inicial.

pages

1

Número de páginas a recuperar.

limit

1

Número de resultados a recuperar en cada página.

limit_per_page

10

results_language:Raspe múltiples páginas usando la misma dirección IP y sesión (conjunto de cookies). Al especificar los números de página en una matriz JSON con la

page clave e indicando el número de resultados orgánicos por página usando la clave, puede minimizar la posibilidad de ver resultados orgánicos superpuestos entre páginas (p. ej., el último resultado orgánico de la primera página siendo el mismo que el primer resultado orgánico de la segunda página). Número de resultados a recuperar en cada página. Ver ejemplo Soporte de desplazamiento continuo.

-

Web Scraper API admite completamente el desplazamiento continuo de Google Search. Detecta automáticamente los diseños de desplazamiento continuo, cargando eficientemente los resultados orgánicos solicitados sin parámetros adicionales requeridos.

Límite por página

Debido a los recientes cambios de límites de Google, hemos ajustado el comportamiento de Web Scraper API. El número máximo de resultados por página coincidirá con la salida orgánica de Google, que normalmente es de 10 resultados.

circle-exclamation

Ejemplo

Parámetro
Descripción
El número de la página que desea raspar. Cualquier valor entero mayor que

clave e indicando el número de resultados orgánicos por página usando la

funcionará 0 El número de resultados en la página en cuestión. Cualquier valor entero entre

1

Número de resultados a recuperar en cada página.

(inclusive) funcionará. 1 y 100 Ejemplo de solicitud

90

"key": "limit_per_page",

Opciones para filtrar y refinar los resultados de búsqueda según varios criterios. Aprenda cómo usar los parámetros de contexto

filter aquí.

Parámetro
Descripción
Valor predeterminado

results_language: Establecer el valor de este parámetro en

le permite ver resultados que de otro modo serían excluidos debido a similitud con otros resultados. 0 safe_search

1

results_language: Búsqueda segura. Establezca en

para activarla. true udm

false

results_language: el parámetro permite cambiar entre diferentes pestañas de búsqueda, como imágenes, lugares o videos, para personalizar el tipo de resultados mostrados. Encuentre los valores aceptados

el parámetro permite cambiar entre diferentes pestañas de búsqueda, como imágenes, lugares o videos, para personalizar el tipo de resultados mostrados. Encuentre los valores aceptados tbm aquíarrow-up-right.

-

results_language: Parámetro To-be-matched o

. Valores aceptados: Parámetro To-be-matched o app blg, bks, dsc, isch, nws, pts, plcs, rcp, lcl, tbs

-

results_language: Este parámetro es como un contenedor para parámetros de Google más oscuros, como limitar/ordenar resultados por fecha, así como otros filtros, algunos de los cuales dependen del

parámetro (p. ej. Parámetro To-be-matched o tbs=app_os:1 solo está disponible con valor Parámetro To-be-matched o ). Más información blglos parámetros de contexto no pueden usarse juntos en una única solicitud de scraping; seleccione solo uno. Usarlos simultáneamente puede causar conflictos o comportamientos inesperados. aquíarrow-up-right.

-

circle-exclamation

Configuraciones avanzadas adicionales y controles para requisitos especializados.

fpstate

Parámetro
Descripción
Valor predeterminado

results_language: Establecer el

valor en Establecer el aig hará que Google cargue más aplicaciones. Este parámetro solo es útil si se usa junto con el parámetro. render nfpr

-

results_language: desactivará la autocorrección ortográfica

true Parámetros de contexto

false

Todos los parámetros de contexto deben añadirse al

array como objetos con results_language pares key y ). Más información , por ejemplo:

Datos estructurados

Web Scraper API es capaz de extraer ya sea un objeto HTML o JSON que contiene los resultados de búsqueda de Google, ofreciendo datos estructurados sobre varios elementos de la página de resultados.

chevron-rightgoogle_search salida estructuradahashtag
circle-info

La composición de elementos puede diferir según si fue una desktop o móvil búsqueda.

Para ayudarle a identificar ciertos elementos, consulte los diccionarios de datos para cada tipo de resultado de búsqueda de Google, ya sea obtenido desde búsquedas de escritorio o móviles.

Diccionario de datos de salida

Navegue por los detalles usando la navegación del lado derecho o desplazándose hacia abajo en la página.

Ejemplo HTML

Estructura JSON

La salida estructurada de Google Web Search incluye campos como URL, clave e indicando el número de resultados orgánicos por página usando la, resultados, y otros. La tabla siguiente presenta una lista detallada de cada función de SERP que analizamos, junto con su descripción y tipo de datos. La tabla también incluye algunos metadatos.

circle-info

El número de elementos y campos para un tipo de resultado específico puede variar dependiendo de la consulta de búsqueda.

Nombre clave
Descripción
Tipo

url

La URL de la página de búsqueda de Google.

string

clave e indicando el número de resultados orgánicos por página usando la

Número de página relativo a la paginación del SERP de Google.

integer

resultados

Un diccionario que contiene los resultados de la búsqueda.

object

results.pla

Una lista de anuncios de listado de productos con sus detalles respectivos.

object

results.paid

Una lista de resultados patrocinados con sus detalles respectivos.

array

results.images

Una lista de resultados de imágenes con sus detalles respectivos.

object

results.flights

Una lista de vuelos con sus detalles respectivos.

object

results.organic

Una lista de listados no pagados con sus detalles respectivos.

array

results.organic_videos

Una lista de videos orgánicos con sus detalles respectivos.

array

results.top_sights

Una lista de lugares de interés o atracciones notables con sus detalles respectivos.

array

results.jobs

Una lista de ofertas de empleo con sus detalles respectivos.

object

results.local_service_ads

Una lista de proveedores de servicios locales patrocinados.

object

results.video_box

Un único elemento de video con sus detalles respectivos.

object

results.recipes

Una lista de recetas con sus detalles respectivos.

object

results.twitter

Una lista de resultados de Twitter (X) con sus detalles respectivos.

array

results.knowledge

Una lista de información relevante obtenida del panel de conocimiento.

object

results.local_pack

Una lista que contiene listados de negocios locales relevantes para la búsqueda.

object

results.item_carousel

Una lista de elementos ilustrativos para consultas informativas con sus detalles respectivos.

object

results.videos

Una lista de videos con sus detalles respectivos.

object

results.related_searches_categorized

Una lista de búsquedas relacionadas que otras personas han realizado.

array

results.hotels

Una lista de hoteles relevantes para la ubicación utilizada en la consulta de búsqueda.

object

results.apps

Una lista de aplicaciones con sus detalles respectivos.

array

results.finance

Un resumen de datos financieros de empresas, incluyendo precios de acciones, capitalización de mercado y otras métricas clave.

object

results.sports_games

Información sobre juegos deportivos recientes, detallando puntuaciones, equipos, tipos de juego y aspectos destacados.

object

results.discussions_and_forums

Una lista de hilos de discusión y publicaciones de foros con URL, títulos, fuentes y recuento de comentarios.

object

results.featured_snippet

Una lista de resultados específicos obtenidos de la parte orgánica de los SERP.

array

results.top_stories

Una lista de artículos con sus detalles respectivos cuando una consulta de búsqueda se identifica como orientada a noticias.

object

results.popular_products

Una lista de exhibiciones orgánicas y no pagadas de listados de productos de Google Shopping con sus detalles respectivos.

object

results.related_searches

Una lista de uno o más bloques de búsquedas relacionadas presentados en diferentes posiciones en la página de búsqueda.

array

results.related_questions

Una lista de consultas interrogativas relacionadas con sus detalles respectivos.

object

results.what_people_are_saying

Una lista de hilos de discusión y publicaciones de foros con URL, títulos, fuentes, comentarios destacados, nivel de compromiso y periodos de tiempo.

array

results.search_information

Una lista de detalles para la consulta de búsqueda enviada.

object

total_results_count

El número total de resultados encontrados para la consulta de búsqueda.

string

last_visible_page

Valor que identifica el número máximo de página visible en la página de resultados de la consulta de búsqueda. (-1 cuando la carga de más resultados se inicia por desplazamiento).

integer

parse_status_code

El código de estado del trabajo de análisis. Puede ver los códigos de estado del parser descritos aquíarrow-up-right.

integer

created_at

La marca de tiempo cuando se creó el trabajo de scraping.

timestamp

updated_at

La marca de tiempo cuando se finalizó el trabajo de scraping.

timestamp

job_id

El ID del trabajo asociado con la tarea de scraping.

string

status_code

El código de estado del trabajo de scraping. Puede ver los códigos de estado del scraper descritos aquí.

integer

parser_type

El tipo de parser usado para descomponer el contenido HTML.

string

circle-info

En las secciones siguientes, los fragmentos de código JSON analizados se acortan cuando hay más de un elemento para el tipo de resultado disponible.

Anuncios de listado de productos (PLA)

El pla La sección de resultados de búsqueda se refiere a los Anuncios de Listado de Productos, también conocidos como Google Shopping Ads, mostrados de forma destacada en la parte superior de la página de búsqueda en formato carrusel.

Clave (results.pla)
Descripción
Tipo
Disposición

elementos

Todos los PLA disponibles dentro de la página.

array

Escritorio y Móvil

items.pos

Un indicador que denota la posición de un elemento dado entre los resultados PLA.

integer

Escritorio y Móvil

items.url

La URL del producto.

string

Escritorio y Móvil

items.price

El precio del producto en el anuncio de listado.

string

Escritorio y Móvil

items.title

El título del producto en el anuncio de listado.

string

Escritorio y Móvil

items.seller

El vendedor del producto en el anuncio de listado.

string

Escritorio y Móvil

items.url_image

La URL de la imagen del producto.

string

Escritorio

items.image_data

La miniatura del producto codificada en base64.

string

Escritorio y Móvil

pos_overall

Una indicación de la posición de la función PLA dentro del SERP.

integer

Escritorio y Móvil

El paid La sección se refiere a anuncios impulsados por Google Ads, que generalmente aparecen por encima de los resultados orgánicos (no pagados).

Clave (results.paid)
Descripción
Tipo
Disposición

pos

Un indicador que denota la posición de un elemento dado entre los resultados pagados.

integer

Escritorio y Móvil

url

La URL del resultado pagado.

string

Escritorio y Móvil

desc

Una breve descripción del resultado pagado.

string

Escritorio y Móvil

title

El título del resultado pagado.

string

Escritorio y Móvil

data_rw

URL de redirección del resultado pagado.

string

Escritorio y Móvil

sitelinks

Un objeto que contiene información sobre enlaces internos a un sitio web que aparece bajo el primer resultado de búsqueda en Google.

object

Escritorio y Móvil

sitelinks.inline/expanded

Una lista de URLs con sus detalles respectivos. El nombre de la clave (`inline`/`expanded`) especifica el tipo del sitelinks elemento.

array

Escritorio y Móvil

sitelinks.inline.url

La URL del sitio enlazado.

string

Escritorio y Móvil

sitelinks.inline.title

El título del sitio enlazado.

string

Escritorio y Móvil

sitelinks.inline.description

Una breve descripción del sitio enlazado.

string

Escritorio

url_shown

La URL abreviada visible justo debajo de la descripción.

string

Escritorio y Móvil

pos_overall

Una indicación de la posición del resultado pagado dentro del SERP.

integer

Escritorio y Móvil

Images

El images La sección se refiere a resultados de imágenes mostrados en diferentes secciones en una página SERP, ya sea como una sección dedicada o en la parte superior. Es importante notar que la estructura de los datos raspados de los resultados de Google Search puede diferir de la de los resultados de Google Image Search.

Clave (results.images)
Descripción
Tipo
Disposición

elementos

Una lista de imágenes con sus detalles respectivos.

array

Escritorio y Móvil

items.alt

El texto alt de la imagen.

string

Escritorio y Móvil

items.pos

Un indicador único que denota la posición de la imagen en la lista.

integer

Escritorio y Móvil

items.url

La URL de la página web que contiene la imagen.

string

Escritorio y Móvil

pos_overall

Una indicación de la posición de la función Images dentro del SERP.

integer

Escritorio y Móvil

Organic

El organic La sección se refiere a listados no pagados en los resultados orgánicos de búsqueda de Google, determinados por la relevancia según el algoritmo de Google. Estos listados aparecen debajo de los anuncios pagados en las páginas de búsqueda.

Ejemplo 1

Ejemplo 2

Clave (results.organic)
Descripción
Tipo
Disposición

pos

Un indicador que denota la posición de un elemento dado entre los resultados orgánicos.

integer

Escritorio y Móvil

url

La URL del resultado orgánico.

string

Escritorio y Móvil

desc

Una breve descripción del resultado orgánico.

string

Escritorio y Móvil

title

El título del resultado orgánico.

string

Escritorio y Móvil

images

Las miniaturas codificadas en base64 del resultado orgánico.

string

Escritorio y Móvil

sitelinks

El objeto contiene `expanded` o `inline` con más detalles sobre los sitelinks.

object

Escritorio y Móvil

sitelinks.expanded/inline

Una lista de sitelinks del resultado orgánico. El nombre de la clave (inline/expanded) especifica el tipo del elemento sitelinks.

array

Escritorio y Móvil

sitelinks.expanded.url

La URL del sitio enlazado.

string

Escritorio y Móvil

sitelinks.expanded.title

El título del sitio enlazado.

string

Escritorio y Móvil

url_shown

La URL abreviada visible justo debajo de la descripción.

string

Escritorio y Móvil

pos_overall

Una indicación de la posición del resultado orgánico dentro del SERP.

integer

Escritorio y Móvil

favicon_text

El texto o nombre asociado con el favicon (icono del sitio web).

string

Escritorio

rating

La calificación promedio del producto o contenido.

float

Escritorio

review_count

El número de reseñas asociadas con el producto o contenido.

integer

Escritorio

additional_info

Contiene detalles sobre precios, disponibilidad, calificaciones de productos, opciones de entrega, políticas de devolución.

lista de strings

Escritorio

Organic Videos

El results.organic_videos contiene una matriz de listados de videos que se muestran de forma orgánica en los resultados de búsqueda, lo que significa que no son anuncios pagados. Cada listado de video incluye detalles relevantes como el título del video, URL, descripción.

Clave (results.organic_videos)
Descripción
Tipo
Disposición

pos

Un indicador que denota la posición de un elemento dado entre los resultados de Organic Videos.

integer

Escritorio

url

La URL del video.

string

Escritorio

desc

Descripción corta del video.

string

Escritorio

title

El título del video.

string

Escritorio

pos_overall

Una indicación de la posición del resultado de Organic Video dentro del SERP.

integer

Escritorio

Top Sights

El results.top_sights contiene una lista de monumentos o atracciones prominentes típicamente asociadas con la ubicación o el tema de búsqueda. Cada elemento incluye detalles como la posición en la lista y el título.

Clave (results.top_sights)
Descripción
Tipo
Disposición

elementos

Una lista de principales atracciones con sus detalles respectivos.

array

Escritorio

items.pos

La posición del resultado Top Sights dentro de la función Top Sights del SERP.

integer

Escritorio

items.title

El título del sitio de la atracción turística.

string

Escritorio

pos_overall

Una indicación de la posición del resultado Top Sights dentro del SERP.

integer

Escritorio

Jobs

El results.jobs contiene listados de empleo extraídos de los resultados de búsqueda. Cada oferta incluye detalles como la URL que dirige a la publicación del trabajo, título del puesto, fuente, empleador y ubicación. Los listados provienen de varios portales de empleo, sitios de carrera y otras plataformas indexadas por Google.

Clave (results.jobs)
Descripción
Tipo
Disposición

listings

Una matriz de todos los listados de empleo disponibles dentro de la página.

array

Escritorio

listings.url

La URL al listado completo del trabajo.

string

Escritorio

listings.title

El título del puesto de trabajo.

string

Escritorio

listings.source

La fuente que contiene la publicación original del trabajo.

string

Escritorio

listings.employer

La organización que contrata para el puesto identificado.

string

Escritorio

listings.location

La ubicación para el puesto.

string

Escritorio

pos_overall

Una indicación de la posición de la función Jobs dentro del SERP.

integer

Escritorio

Twitter (X)

El twitter La función aparece con frecuencia para marcas, películas, músicos y otras celebridades, típicamente posicionada directamente bajo el resultado de búsqueda del sitio web de la marca. Esta función ofrece un enlace directo al feed de Twitter de la marca, mostrando un carrusel de sus tweets más recientes.

Clave (results.twitter)
Descripción
Tipo
Disposición

pos

Un indicador que denota la posición de un elemento dado entre los resultados orgánicos.

integer

Escritorio

url

La URL del perfil que contiene las publicaciones de Twitter (X).

string

Escritorio

elementos

Una lista de publicaciones de Twitter (X) con sus detalles respectivos.

array

Escritorio

items.pos

Un indicador que denota la posición de un tweet dado dentro de la función Twitter (X) del SERP.

string

Escritorio

items.url

La URL de la publicación de Twitter (X).

string

Escritorio

items.content

Una breve descripción que denota todo el texto de la publicación relevante de Twitter (X).

string

Escritorio

items.timeframe

Describe cuánto tiempo hace desde que se creó el tweet.

string

Escritorio

title

El título del perfil de Twitter (X).

string

Escritorio

pos_overall

Una indicación de la posición del resultado de Twitter dentro del SERP.

integer

Escritorio

Knowledge

El knowledge La sección dentro de los resultados de búsqueda muestra datos del Panel de Conocimiento de Google en el lado derecho cuando se busca personas, lugares, organizaciones o entidades integradas en el Knowledge Graph.

Clave (results.knowledge)
Descripción
Tipo
Disposición

title

El título del panel de conocimiento.

string

Escritorio y Móvil

images

Una lista de imágenes usadas justo al lado del título.

array

Escritorio

factoids

Una lista de todos los hechos utilizados en el panel de conocimiento.

array

Escritorio y Móvil

factoids.links

Una lista de todos los enlaces relacionados con un elemento de factoid dado.

array

Escritorio y Móvil

factoids.links.href

Un hipervínculo a la página de resultados de Google Search para el factoid dado.

string

Escritorio y Móvil

factoids.links.title

La descripción de cualquier página vinculada relacionada con el factoid.

string

Escritorio y Móvil

factoids.title

El nombre de la sección de factoid.

string

Escritorio y Móvil

factoids.content

La descripción del factoid.

string

Escritorio y Móvil

profiles

Una lista de perfiles de redes sociales listados en el panel de conocimiento.

string

Escritorio

profiles.url

Un enlace al perfil de redes sociales.

string

Escritorio

profiles.title

El título del perfil de redes sociales.

string

Escritorio

subtitle

Una breve explicación sobre la entidad descrita en el título.

string

Escritorio y Móvil

description

Una descripción que indica la información principal sobre la entidad en el panel de conocimiento.

string

Escritorio y Móvil

related_searches

Una lista de búsquedas relacionadas con sus respectivos detalles.

array

Escritorio

related_searches.url

La URL de la página de búsqueda relacionada.

string

Escritorio

related_searches.title

El título de la página de búsqueda relacionada.

string

Escritorio

related_searches.section_title

El nombre de la sección de búsqueda relacionada.

string

Escritorio

Local Pack

El local_pack muestra los tres mejores resultados de búsqueda local en función de la ubicación del usuario o la ubicación de búsqueda especificada, incluyendo un mapa e información adicional.

Clave (results.local_pack)
Descripción
Tipo
Disposición

elementos

Una lista de ubicaciones con sus respectivos detalles.

array

Escritorio y Móvil

items.cid

Un número de identificación único asignado a un listado comercial específico.

string

Escritorio y Móvil

items.pos

La posición del resultado local dentro del local pack.

integer

Escritorio y Móvil

items.title

El título de la entidad local.

string

Escritorio y Móvil

items.rating

La valoración de la entidad local.

integer

Escritorio y Móvil

items.address

La dirección de la entidad local.

string

Escritorio y Móvil

items.rating_count

El número de valoraciones de la entidad local.

integer

Escritorio y Móvil

pos_overall

Una indicación de la posición del resultado Local Pack dentro del SERP.

integer

Escritorio y Móvil

Top Stories

top_stories es una sección dedicada que aparece en Google Search para consultas orientadas a noticias.

Clave (results.top_stories)
Descripción
Tipo
Disposición

elementos

Una lista de artículos de noticias seleccionados con sus respectivos detalles.

array

Escritorio y Móvil

items.pos

La posición del artículo dentro de la función Top Stories del SERP.

integer

Escritorio y Móvil

items.url

La URL al artículo completo.

string

Escritorio y Móvil

items.title

El título del artículo.

string

Escritorio y Móvil

items.section

El nombre de la sección Top Stories.

string

Mobile

items.source

El nombre del sitio donde se publica el artículo.

string

Escritorio y Móvil

items.timeframe

Describe hace cuánto tiempo se publicó el artículo.

string

Escritorio

pos_overall

Indica la posición general de la función Top Stories dentro del SERP.

integer

Escritorio y Móvil

El popular_products La función del SERP presenta un carrusel de varios productos determinados por su popularidad y relevancia para la consulta del usuario. Esto difiere de los Product Listing Ads (PLAs), que están influenciados por anunciantes. Cabe señalar que pueden aparecer múltiples popular_products carruseles en una sola página del SERP.\

Clave (results.popular_products)
Descripción
Tipo
Disposición

elementos

Una lista de productos populares con sus respectivos detalles.

array

Escritorio y Móvil

items.pos

Un indicador único que denota la posición de un producto popular dado dentro de la función Popular Products del SERP.

integer

Escritorio y Móvil

items.price

El precio de un producto popular dado.

string

Escritorio y Móvil

items.title

El título de un producto popular dado.

string

Escritorio y Móvil

items.rating

La valoración de un producto popular dado.

string

Escritorio

items.seller

El vendedor de un producto popular dado.

string

Escritorio

items.image_data

La miniatura del producto codificada en base64.

string

Escritorio

pos_overall

Indica la posición general de la función Popular Products dentro del SERP.

integer

Escritorio y Móvil

El related_searches La función del SERP muestra consultas alternativas relacionadas con la palabra clave inicial, típicamente ubicada en la parte inferior del SERP.

Clave (results.related_searches)
Descripción
Tipo
Disposición

pos_overall

Indica la posición general de este bloque de búsquedas relacionadas dentro de la página de búsqueda.

integer

Escritorio y Móvil

related_searches

Una lista de cadenas de búsqueda relacionadas dentro de este bloque.

array

Escritorio y Móvil

El related_questions la función está posicionada debajo de los resultados de búsqueda principales, presentando una lista de preguntas directamente relacionadas con la consulta original del usuario. Al ofrecer un conjunto curado de preguntas relacionadas, los usuarios pueden explorar diferentes aspectos de su tema, mejorando su experiencia de búsqueda.

Clave (results.related_questions)
Descripción
Tipo
Disposición

elementos

Una lista que contiene todas las preguntas relacionadas.

array

Escritorio y Móvil

items.pos

Un indicador único que denota la posición de cualquier pregunta relacionada dentro de la función Related Questions del SERP.

integer

Escritorio y Móvil

items.answer

La respuesta a la pregunta relacionada.

string

Escritorio y Móvil

items.source

Contiene valores que describen la fuente de la respuesta a la pregunta.

object

Escritorio y Móvil

items.source.url

La URL del sitio que se utiliza para obtener la respuesta.

string

Escritorio

items.source.title

El título del sitio que contiene la respuesta.

string

Escritorio

items.source.url_shown

La URL abreviada visible justo debajo de la respuesta.

string

Escritorio y Móvil

items.question

La pregunta de la sección de preguntas relacionadas.

string

Escritorio y Móvil

pos_overall

Indica la posición general de la función Related Questions dentro del SERP.

integer

Escritorio y Móvil

What people are saying

El what_people_are_saying la sección aparece en los resultados de búsqueda de Google cuando hay publicaciones relevantes de foros, redes sociales o plataformas comunitarias relacionadas con la consulta de búsqueda. Esta sección típicamente muestra contenido de plataformas como Reddit, TikTok y otros foros de discusión.

Clave (results.what_people_are_saying)
Descripción
Tipo
Disposición

elementos

Una lista que contiene todos los elementos de contenido de foros de discusión o redes sociales.

array

Escritorio y Móvil

items.url

La URL del hilo de discusión o de la página de contenido de redes sociales.

integer

Escritorio y Móvil

items.title

El título del hilo de discusión o pieza de contenido.

string

Escritorio y Móvil

items.top_comments

El comentario principal del hilo de discusión, si se muestra.

string

Escritorio y Móvil

items.source

El nombre de la plataforma o sitio web que aloja el contenido.

string

Escritorio y Móvil

items.engagement_timeframe

Recuento de comentarios y marco temporal de actividad (p. ej., "45 comments, 2 days ago").

string

Escritorio y Móvil

Search Information

El search_information la función proporciona información estructurada sobre la consulta de búsqueda.

Clave (results.search_information)
Descripción
Tipo
Disposición

query

El término de búsqueda original.

string

Escritorio y Móvil

geo_location *

Indica el área geográfica específica asociada con la búsqueda.

string

Escritorio

showing_results_for

El término de búsqueda para el que se muestran los resultados. `query` y `showing_results_for` pueden diferir si Google autocorrigió el término de búsqueda proporcionado.

string

Escritorio y Móvil

total_results_count

El número total de resultados encontrados para el término de búsqueda.

integer

Escritorio y Móvil

*Funciona solo con renderizado JS

Un carrusel (item_carousel) de imágenes o enlaces relacionados con un tipo específico de elemento se muestra en la parte superior del SERP. El contenido y la disposición varían según la consulta de búsqueda del usuario, mostrando una selección de elementos relevantes. Esto puede abarcar desde productos y noticias hasta imágenes, creando una experiencia visualmente atractiva y personalizada para los usuarios.

Clave (results.item_carousel)
Descripción
Tipo
Disposición

elementos

Una lista de elementos colocados en un carrusel con sus respectivos detalles.

array

Escritorio

items.pos

La posición del elemento dentro del carrusel.

integer

Escritorio

items.href

Un hipervínculo al SERP de Google del elemento en el carrusel.

string

Escritorio

items.title

El nombre/título de la entidad en el carrusel.

string

Escritorio

items.subtitle

Detalles adicionales sobre la entidad en el título.

string

Escritorio

title

El título de la sección del carrusel. El título está relacionado con la consulta de búsqueda.

string

Escritorio

pos_overall

Una indicación de la posición del resultado Item Carousel dentro del SERP.

integer

Escritorio

Recipes

El recipes La función del SERP de Google presenta instrucciones de cocina, ingredientes, valoraciones y fuentes para platos específicos en la parte superior de los resultados de búsqueda.

Clave (results.recipes)
Descripción
Tipo
Disposición

elementos

Una lista de recetas seleccionadas con sus respectivos detalles.

array

Escritorio y Móvil

items.pos

La posición de la receta dentro de la función Recipes del SERP.

integer

Escritorio y Móvil

items.url

La URL a la receta completa.

string

Escritorio y Móvil

items.desc

Una breve descripción de la receta obtenida del artículo original.

string

Escritorio

items.title

El título de la receta.

string

Escritorio y Móvil

items.rating

La valoración de la receta.

integer

Escritorio y Móvil

items.source

El nombre del sitio web donde se encuentra la receta.

string

Escritorio y Móvil

items.duration

El tiempo necesario para preparar el plato.

string

Escritorio y Móvil

pos_overall

Una indicación de la posición del resultado Recipes dentro del SERP.

integer

Escritorio y Móvil

Videos

El videos la función en la página de resultados del motor de búsqueda de Google muestra una selección curada de contenido de video relacionado con la consulta de búsqueda del usuario, incluyendo miniaturas, títulos e información de la fuente.

Clave (results.videos)
Descripción
Tipo
Disposición

elementos

Una lista que contiene todos los resultados de la sección de video.

array

Escritorio y Móvil

items.pos

La posición del video dentro de la lista.

integer

Escritorio y Móvil

items.url

Un enlace al video.

string

Escritorio y Móvil

items.title

El título del video.

string

Escritorio y Móvil

items.author

El nombre del perfil donde se subió el video.

string

Escritorio y Móvil

items.source

El nombre de la plataforma que aloja el video.

string

Escritorio y Móvil

pos_overall

Una indicación de la posición del resultado Videos dentro del SERP.

integer

Escritorio y Móvil

El featured_snippet es un resultado de búsqueda único de Google donde se muestra un fragmento conciso que describe una página antes de un enlace a esa página. Estos resultados destacados se muestran de forma prominente en la parte superior de los resultados orgánicos, proporcionando a los usuarios acceso rápido a información relevante.

Clave (results.featured_snippet)
Descripción
Tipo
Disposición

url

La URL del sitio web de la que se obtiene el fragmento que describe la página.

string

Escritorio y Móvil

desc

El fragmento que contiene una descripción para un resultado de búsqueda específico.

string

Escritorio y Móvil

title

El nombre del artículo del que se obtiene el fragmento que describe una página.

string

Escritorio y Móvil

url_shown

La URL del sitio web que contiene el featured snippet visible en el SERP.

string

Escritorio y Móvil

pos_overall

Una indicación de la posición del resultado Featured Snippet dentro del SERP.

integer

Escritorio y Móvil

related_searches_categorized muestra específicamente búsquedas relacionadas con listas. A diferencia de las búsquedas relacionadas generales, que abarcan todas las consultas de los usuarios, esta función proporciona un conjunto enfocado de consultas relacionadas con listas. Normalmente se encuentra en la parte inferior de la página de resultados, y sirve como una fuente dirigida de palabras clave relacionadas con el término de búsqueda principal.

Clave (results.related_searches_categorized)
Descripción
Tipo
Disposición

elementos

Una lista que contiene todos los elementos de búsquedas relacionadas recuperados de un carrusel horizontal dentro del SERP.

array

Escritorio

items.url

La URL de la página de búsqueda relacionada.

string

Escritorio

items.title

El nombre del resultado de búsqueda relacionada renderizado en el navegador.

string

Escritorio

category

Un objeto que contiene más detalles sobre la categoría de los resultados de búsqueda relacionados.

object

Escritorio

category.name

El nombre de la categoría.

string

Escritorio

category.type

El tipo de la sección de búsqueda relacionada.

string

Escritorio

pos_overall

Una indicación de la posición del resultado Related Searches Categorized dentro del SERP.

integer

Escritorio

Hotels

Google hotels es una función que muestra información de hoteles directamente dentro de los resultados de búsqueda. Cuando los usuarios buscan hoteles o consultas relacionadas con alojamiento en Google, el motor de búsqueda puede presentar un módulo dedicado de hoteles en la parte superior de la página de resultados, ofreciendo una visión conveniente y prominente de opciones relevantes.

Clave (results.hotels)
Descripción
Tipo
Disposición

date_to

La fecha de salida (check-out).

string

Escritorio

resultados

Una lista con todos los detalles del hotel.

array

Escritorio

results.price

El precio del hotel.

string

Escritorio

results.title

El nombre del hotel.

string

Escritorio

results.description

Una breve descripción del hotel visible justo debajo del nombre del hotel.

string

Escritorio

date_from

La fecha de entrada (check-in).

string

Escritorio

pos_overall

Una indicación de la posición del resultado Hotels dentro del SERP.

integer

Escritorio

Flights

El flights la función presenta un bloque que contiene opciones de vuelo organizadas asociadas con una consulta de búsqueda relevante, permitiendo a los usuarios comparar opciones directamente en los resultados de búsqueda.

Clave (results.flights)
Descripción
Tipo
Disposición

to

El aeropuerto de llegada.

string

Escritorio y Móvil

from

El aeropuerto de salida.

string

Escritorio y Móvil

date_to

El día de la llegada.

string

Escritorio y Móvil

resultados

Una lista de vuelos seleccionados con sus respectivos detalles.

array

Escritorio y Móvil

results.url

Un enlace a la página de Google Flights que lista todos los vuelos de una sola aerolínea.

string

Escritorio y Móvil

results.type

El tipo de vuelo.

string

Escritorio

results.price

El precio del vuelo.

string

Escritorio y Móvil

results.airline

El nombre de la aerolínea.

string

Escritorio y Móvil

results.duration

La duración del vuelo.

string

Escritorio y Móvil

date_from

La fecha de la salida.

string

Escritorio y Móvil

pos_overall

Una indicación de la posición del resultado Flights dentro del SERP.

integer

Escritorio y Móvil

Video Box

El video_box la función resalta un resultado de video específico en la parte superior de la página de resultados de búsqueda, elegido por Google como el más relevante para la consulta.

Clave (results.video_box)
Descripción
Tipo
Disposición

url

La URL del video.

string

Escritorio y Móvil

title

El título del video.

string

Escritorio y Móvil

pos_overall

Una indicación de la posición del resultado Video Box dentro del SERP.

integer

Escritorio y Móvil

Local Service Ads

El local_service_ads la función permite a profesionales orientados a servicios, como fontaneros, electricistas, cerrajeros y otros proveedores locales, promocionar sus servicios en la página de resultados de Google Search.

Clave (results.local_service_ads)
Descripción
Tipo
Disposición

elementos

Una lista de proveedores de servicios con sus respectivos detalles.

array

Escritorio

items.pos

La posición del anuncio de servicio dentro de la función Local Services Ads del SERP.

integer

Escritorio

items.url

Un enlace al servicio en la página de búsqueda de Local Services.

string

Escritorio

items.title

El título del proveedor de servicios.

string

Escritorio

items.rating

La valoración del proveedor de servicios.

integer

Escritorio

items.reviews_count

El número de reseñas del proveedor de servicios.

integer

Escritorio

items.google_guaranteed

Insignia de Google que se otorga a empresas que pasan un proceso de revisión y verificación de Google. Los valores disponibles son "true" o "false".

boolean

Escritorio

pos_overall

Una indicación de la posición del resultado Local Service Ads dentro del SERP.

integer

Escritorio

Apps

El apps La función del SERP muestra aplicaciones relevantes según la consulta del usuario, proporcionando detalles clave como precio, valoración y más. Esta función sirve como una plataforma valiosa para que desarrolladores y editores de aplicaciones aumenten la visibilidad y el compromiso de sus aplicaciones móviles directamente en la página de resultados de Google Search.

Clave (results.apps)
Descripción
Tipo
Disposición

id

El id de la aplicación dentro de la tienda de aplicaciones disponible.

string

Mobile

url

La URL de la tienda de aplicaciones que contiene la información completa sobre la aplicación en el SERP.

string

Mobile

title

El título de la aplicación.

string

Mobile

rating

La valoración de la aplicación.

integer

Mobile

reviews_count

El número total de reseñas disponibles para el resultado Apps en la tienda de aplicaciones.

integer

Mobile

items.reviews_count

El número de reseñas del proveedor de servicios.

string

Mobile

Finance

Un resumen de datos financieros de empresas, incluyendo precios de acciones, capitalización de mercado y otras métricas clave.

Ejemplo HTML

Clave (results.finance)
Descripción
Tipo
Disposición

low

El precio mínimo para la fecha especificada.

float

Escritorio

date

La fecha en la que se informó el valor neto del activo.

string

Escritorio

high

El precio máximo para la fecha especificada

float

Escritorio

open

El precio de apertura para la fecha especificada

float

Escritorio

source

La URL a la fuente relevante de Google Finance.

string

Escritorio

difference

El cambio entre el valor neto del activo informado más recientemente y el inmediatamente anterior.

string

Escritorio

market_cap

El valor total en dólares de las acciones en circulación de una empresa

string

Escritorio

stock_name

El nombre de la acción.

string

Escritorio

52_week_low

El precio mínimo en 52 semanas

float

Escritorio

52_week_high

El precio máximo en 52 semanas

float

Escritorio

current_price

Cotización de precio en tiempo real.

string

Escritorio

dividend_yield

La relación dividendo-precio de una acción es el dividendo por acción dividido por el precio por acción

float

Escritorio

price_earning_ratio

La relación precio-beneficio de la acción

float

Escritorio

Muestra JSON

Partidos deportivos

Información sobre juegos deportivos recientes, detallando puntuaciones, equipos, tipos de juego y aspectos destacados.

Ejemplo HTML

Clave (results.sports_games)
Descripción
Tipo
Disposición

partidos

Una matriz que proporciona información sobre varios partidos deportivos

array

Escritorio

partidos.fecha

La fecha y hora en que el partido está programado para llevarse a cabo o cuando ocurrió

string

Escritorio

partidos.equipos

Los equipos involucrados en el partido

array

Escritorio

partidos.tipo_de_partido

El tipo de partido que se juega, como un partido de temporada regular, de playoffs, de campeonato, etc.

string

Escritorio

partidos.destacado

Un enlace a los momentos destacados notables del partido, como jugadas clave, goles, etc.

string

Escritorio

partidos.equipos.puntuacion

Las puntuaciones o puntos obtenidos por cada equipo durante el partido

string

Escritorio

partidos.equipos.ganador

Especifica qué equipo ganó el partido

boolean

Escritorio

partidos.equipos.nombre_del_equipo

Muestra los nombres de los equipos involucrados en el partido

string

Escritorio

etapa

La fase o etapa específica de una competición o torneo deportivo.

string

Escritorio

liga

Se refiere a la liga deportiva u organización que supervisa la competición

string

Escritorio

Muestra JSON

Debates y foros

Una lista de hilos de discusión y publicaciones de foros con URL, títulos, fuentes y recuento de comentarios.

Ejemplo HTML

Clave (results.discussions_and_forums)
Descripción
Tipo
Disposición

elementos

Una matriz de elementos o entradas dentro de un foro o hilo de discusión que Google ha indexado

array

Escritorio

items.pos

Un indicador que denota la posición de un elemento dado entre todos los resultados de Debates y Foros.

integer

Escritorio

items.url

El enlace URL a la publicación específica del foro o hilo de discusión

string

Escritorio

items.title

El título o encabezado de la publicación del foro o tema de discusión

string

Escritorio

items.source

La fuente que aloja el foro o la discusión

string

Escritorio

items.timeframe

El marco temporal o la fecha de la publicación del foro o discusión

string

Escritorio

items.comments_count

El número de comentarios o respuestas que ha recibido la publicación del foro o hilo de discusión

string

Escritorio

pos_overall

Una indicación de la posición de la función SERP Debates y Foros dentro del SERP.

integer

Escritorio

Muestra JSON

Última actualización

¿Te fue útil?