For the complete documentation index, see llms.txt. This page is also available as Markdown.

Web Search

Scraper completo de Google Search con datos analizados de resultados orgánicos, anuncios, fragmentos, paneles de conocimiento, noticias destacadas y más.

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

Ejemplos de solicitud

En los ejemplos siguientes, hacemos una solicitud para obtener 2 páginas de resultados, desde el número 11 hasta el número 12 , para el término de búsqueda adidas. 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,
    }'

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

Valores de los parámetros de solicitud

General

Configuración básica y opciones de personalización para extraer resultados de búsqueda web de Google.

Parámetro
Descripción
Valor predeterminado

source

Establece el scraper.

google_search

query

La palabra clave o frase que se va a 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. Explore la 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í.

escritorio

- parámetro obligatorio

Operadores avanzados de búsqueda de Google

Al extraer datos, 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 específicos. Explore estos comandos especiales aquí y aquí. Vea un ejemplo a continuación.

Localización

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

Parámetro
Descripción
Valor predeterminado

geo_location

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

-

locale

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

-

Paginación

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

Parámetro
Descripción
Valor predeterminado

start_page

Número de página inicial.

1

pages

Número de páginas a recuperar.

1

limit

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

10

context:limit_per_page

Extraiga varias páginas usando la misma dirección IP y sesión (cookie establecida). Al especificar los números de página en un arreglo JSON con la page clave y al indicar el número de resultados orgánicos por página usando la limit clave, puede minimizar la posibilidad de ver resultados orgánicos superpuestos entre páginas (por ejemplo, que el último resultado orgánico de la primera página sea el mismo que el primer resultado orgánico de la segunda página). Ver ejemplo.

-

Compatibilidad con desplazamiento continuo

Web Scraper API es totalmente compatible con el desplazamiento continuo de Google Search. Detecta automáticamente diseños de desplazamiento continuo y carga de forma eficiente los resultados orgánicos solicitados sin necesidad de parámetros adicionales.

Límite por página

Para usar esta función, incluya un arreglo JSON con objetos JSON que contengan los siguientes datos:

Parámetro
Descripción
Ejemplo

page

El número de la página que desea extraer. Cualquier valor entero mayor que 0 funcionará

1

limit

El número de resultados en la página en cuestión. Cualquier valor entero entre 1 y 100 (inclusive) funcionará.

90

Ejemplo de solicitud

Filtrado

Opciones para filtrar y refinar los resultados de búsqueda según varios criterios. Aprenda a usar los parámetros context aquí.

Parámetro
Descripción
Valor predeterminado

context: filter

Establecer el valor de este parámetro en 0 le permite ver resultados que de otro modo quedarían excluidos por su similitud con otros resultados.

1

context: safe_search

Búsqueda segura. Establézcalo en true para activarlo.

false

context: udm

udm 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 aquí.

-

context: tbm

De coincidencia o tbm parámetro. Los valores aceptados son: app, blg, bks, dsc, isch, nws, pts, plcs, rcp, lcl

-

context: tbs

Este parámetro es como un contenedor para parámetros de google más poco comunes, como limitar/ordenar resultados por fecha, así como otros filtros, algunos de los cuales dependen del tbm (p. ej. tbs=app_os:1 solo está disponible con tbm valor app). Más información aquí.

-

Otro

Configuraciones y controles avanzados adicionales para requisitos especializados.

Parámetro
Descripción
Valor predeterminado

context: fpstate

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

-

context: nfpr

true desactivará la autocorrección ortográfica

false

Parámetros de contexto

Todos los parámetros de contexto deben agregarse al context arreglo como objetos con clave y valor pares, por ejemplo:

Datos estructurados

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

google_search salida estructurada

La composición de los elementos puede variar en función de si fue una escritorio o móvil búsqueda.

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

Diccionario de datos de salida

Navegue por los detalles usando la navegación de la derecha o desplazándose hacia abajo en la página.

Estructura JSON

La salida estructurada de Google Web Search incluye campos como URL, page, results, 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 dato. La tabla también incluye algunos metadatos.

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

Nombre de la clave
Descripción
Tipo

url

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

cadena

page

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

entero

results

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

objeto

results.pla

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

objeto

results.paid

Una lista de resultados patrocinados con sus respectivos detalles.

arreglo

results.images

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

objeto

results.flights

Una lista de vuelos con sus respectivos detalles.

objeto

results.organic

Una lista de listados no pagados con sus respectivos detalles.

arreglo

results.organic_videos

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

arreglo

results.top_sights

Una lista de lugares emblemáticos o atracciones destacadas con sus respectivos detalles.

arreglo

results.jobs

Una lista de ofertas de empleo con sus respectivos detalles.

objeto

results.local_service_ads

Una lista de proveedores de servicios locales patrocinados.

objeto

results.video_boxes

Cajas de video en la SERP con sus respectivos detalles.

arreglo

results.recipes

Una lista de recetas con sus respectivos detalles.

objeto

results.twitter

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

arreglo

results.knowledge

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

objeto

results.local_pack

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

objeto

results.item_carousel

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

objeto

results.videos

Una lista de videos con sus respectivos detalles.

objeto

results.hotels

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

objeto

results.apps

Una lista de aplicaciones con sus respectivos detalles.

arreglo

results.finance

Un resumen de datos financieros de empresas, incluidos precios de acciones, capitalización bursátil y otras métricas clave.

objeto

results.sports_games

Información sobre partidos deportivos recientes, con detalles de marcadores, equipos, tipos de juego y aspectos destacados.

objeto

results.discussions_and_forums

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

objeto

results.featured_snippet

Una lista de resultados específicos recuperados de la parte orgánica de las SERP.

arreglo

results.top_stories

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

objeto

results.popular_products

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

objeto

results.related_searches

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

arreglo

results.related_questions

Una lista de consultas de búsqueda interrogativas relacionadas con sus respectivos detalles.

objeto

results.what_people_are_saying

Una lista de hilos de discusión y publicaciones de foros con URLs, títulos, fuentes, comentarios principales, nivel de interacción y marcos temporales.

arreglo

results.search_information

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

objeto

total_results_count

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

cadena

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 al desplazarse).

entero

parse_status_code

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

entero

created_at

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

marca de tiempo

updated_at

La marca de tiempo cuando terminó el trabajo de scraping.

marca de tiempo

job_id

El ID del trabajo asociado con el trabajo de scraping.

cadena

status_code

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

entero

parser_type

El tipo de parser usado para descomponer el contenido HTML.

cadena

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

Anuncios de listado de productos (PLA)

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

Clave (results.pla)
Descripción
Tipo
Diseño

items

Todos los PLA disponibles dentro de la página.

arreglo

Escritorio y móvil

items.pos

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

entero

Escritorio y móvil

items.title

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

cadena

Escritorio y móvil

items.url

La URL del producto

cadena

Escritorio y móvil

items.price

El precio del producto en el anuncio de listado.

cadena

Escritorio y móvil

items.seller

El vendedor del producto en el anuncio de listado.

cadena

Escritorio y móvil

items.url_image

La URL de la imagen del producto.

cadena

Escritorio

items.image_data

La miniatura del producto codificada en base64.

cadena

Escritorio y móvil

pos_overall

Una indicación de la posición de la característica PLA de la SERP dentro de la SERP.

entero

Escritorio y móvil

Pagado

La paid la sección se refiere a anuncios impulsados por Google Ads, que suelen aparecer sobre los resultados orgánicos (no pagados).

Clave (results.paid)
Descripción
Tipo
Diseño

pos

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

entero

Escritorio y móvil

url

La URL del resultado pagado.

cadena

Escritorio y móvil

desc

Una breve descripción del resultado pagado.

cadena

Escritorio y móvil

title

El título del resultado pagado.

cadena

Escritorio y móvil

data_rw

URL de redirección del resultado pagado.

cadena

Escritorio y móvil

enlaces de sitio

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

objeto

Escritorio y móvil

enlaces de sitio.inline/expanded

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

arreglo

Escritorio y móvil

enlaces de sitio.inline.url

La URL del sitio vinculado.

cadena

Escritorio y móvil

enlaces de sitio.inline.title

El título del sitio vinculado.

cadena

Escritorio y móvil

enlaces de sitio.inline.description

Una breve descripción del sitio vinculado.

cadena

Escritorio

URL mostrada

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

cadena

Escritorio y móvil

pos_overall

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

entero

Escritorio y móvil

Imágenes

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

Clave (results.images)
Descripción
Tipo
Diseño

items

Una lista de imágenes con sus respectivos detalles.

arreglo

Escritorio y móvil

items.alt

El texto alternativo de la imagen.

cadena

Escritorio y móvil

items.pos

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

entero

Escritorio y móvil

items.url

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

cadena

Escritorio y móvil

pos_overall

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

entero

Escritorio y móvil

Orgánico

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

Ejemplo 1

Ejemplo 2

Clave (results.organic)
Descripción
Tipo
Diseño

pos

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

entero

Escritorio y móvil

url

La URL del resultado orgánico.

cadena

Escritorio y móvil

desc

Una breve descripción del resultado orgánico.

cadena

Escritorio y móvil

title

El título del resultado orgánico.

cadena

Escritorio y móvil

imágenes

Las imágenes miniatura codificadas en base64 del resultado orgánico.

cadena

Escritorio y móvil

enlaces de sitio

El objeto contiene el elemento `expanded` o `inline` con más detalles sobre los enlaces de sitio.

objeto

Escritorio y móvil

enlaces de sitio.expanded/inline

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

arreglo

Escritorio y móvil

enlaces de sitio.expanded.url

La URL del sitio vinculado.

cadena

Escritorio y móvil

enlaces de sitio.expanded.title

El título del sitio vinculado.

cadena

Escritorio y móvil

URL mostrada

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

cadena

Escritorio y móvil

pos_overall

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

entero

Escritorio y móvil

texto del favicon

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

cadena

Escritorio

valoración

La valoración media del producto o contenido.

flotante

Escritorio

número de reseñas

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

entero

Escritorio

información_adicional

Contiene detalles sobre precios, disponibilidad, valoraciones del producto, opciones de entrega y políticas de devolución.

lista de cadenas

Escritorio

Vídeos orgánicos

La results.organic_videos contiene un array de listados de videos que se muestran de forma orgánica en los resultados de búsqueda, es decir, no son anuncios pagados. Cada listado de video incluye detalles relevantes como el título del video, la URL y la descripción.

Clave (results.organic_videos)
Descripción
Tipo
Diseño

pos

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

entero

Escritorio

url

La URL del video.

cadena

Escritorio

desc

Descripción breve del video.

cadena

Escritorio

title

El título del video.

cadena

Escritorio

pos_overall

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

entero

Escritorio

Principales atractivos

La results.top_sights contiene una lista de lugares emblemáticos o atracciones destacadas normalmente 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
Diseño

items

Una lista de atracciones principales con sus respectivos detalles.

arreglo

Escritorio

items.pos

La posición del resultado de Principales atractivos dentro de la función SERP Principales atractivos.

entero

Escritorio

items.title

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

cadena

Escritorio

pos_overall

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

entero

Escritorio

Empleos

La results.jobs contiene listados de empleos extraídos de los resultados de búsqueda. Cada listado incluye detalles como la URL que dirige a la oferta, el título del empleo, la fuente, el empleador y la ubicación. Los listados provienen de varias bolsas de empleo, sitios web de carreras y otras plataformas indexadas por Google.

Clave (results.jobs)
Descripción
Tipo
Diseño

listings

Un array de todos los listados de empleos disponibles dentro de la página.

arreglo

Escritorio

listings.url

La URL del listado completo del empleo.

cadena

Escritorio

listings.title

El título del puesto de trabajo.

cadena

Escritorio

listings.source

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

cadena

Escritorio

listings.employer

La organización que contrata para el puesto identificado.

cadena

Escritorio

listings.location

La ubicación del puesto.

cadena

Escritorio

pos_overall

Una indicación de la posición de la función SERP Empleos dentro de la SERP.

entero

Escritorio

Twitter (X)

La twitter esta función aparece con frecuencia para marcas, películas, músicos y otras celebridades, normalmente situada directamente debajo del 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 tuits más recientes.

Clave (results.twitter)
Descripción
Tipo
Diseño

pos

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

entero

Escritorio

url

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

cadena

Escritorio

items

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

arreglo

Escritorio

items.pos

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

cadena

Escritorio

items.url

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

cadena

Escritorio

items.content

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

cadena

Escritorio

items.timeframe

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

cadena

Escritorio

title

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

cadena

Escritorio

pos_overall

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

entero

Escritorio

Conocimiento

La conocimiento la sección dentro de los resultados de búsqueda muestra datos del panel de conocimiento de Google en el lado derecho al buscar personas, lugares, organizaciones o entidades integradas en el Knowledge Graph.

Clave (results.knowledge)
Descripción
Tipo
Diseño

title

El título del panel de conocimiento.

cadena

Escritorio y móvil

imágenes

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

arreglo

Escritorio

factoides

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

arreglo

Escritorio y móvil

factoids.links

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

arreglo

Escritorio y móvil

factoids.links.href

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

cadena

Escritorio y móvil

factoids.links.title

La descripción de cualquier página enlazada relacionada con el factoide.

cadena

Escritorio y móvil

factoids.title

El nombre de la sección de factoides.

cadena

Escritorio y móvil

factoids.content

La descripción del factoide.

cadena

Escritorio y móvil

perfiles

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

cadena

Escritorio

profiles.url

Un enlace al perfil de la red social.

cadena

Escritorio

profiles.title

El título del perfil de la red social.

cadena

Escritorio

subtítulo

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

cadena

Escritorio y móvil

descripción

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

cadena

Escritorio y móvil

related_searches

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

arreglo

Escritorio

related_searches.url

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

cadena

Escritorio

related_searches.title

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

cadena

Escritorio

related_searches.section_title

El nombre de la sección de búsquedas relacionadas.

cadena

Escritorio

Paquete local

La local_pack muestra los tres principales resultados de búsqueda locales según 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
Diseño

items

Una lista de ubicaciones con sus respectivos detalles.

arreglo

Escritorio y móvil

items.cid

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

cadena

Escritorio y móvil

items.pos

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

entero

Escritorio y móvil

items.title

El título de la entidad local.

cadena

Escritorio y móvil

items.rating

La valoración de la entidad local.

entero

Escritorio y móvil

items.address

La dirección de la entidad local.

cadena

Escritorio y móvil

items.rating_count

El número de valoraciones de la entidad local.

entero

Escritorio y móvil

pos_overall

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

entero

Escritorio y móvil

Noticias principales

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

Clave (results.top_stories)
Descripción
Tipo
Diseño

items

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

arreglo

Escritorio y móvil

items.pos

La posición del artículo dentro de la función SERP Noticias principales.

entero

Escritorio y móvil

items.url

La URL del artículo completo.

cadena

Escritorio y móvil

items.title

El título del artículo.

cadena

Escritorio y móvil

items.section

El nombre de la sección de Noticias principales.

cadena

Móvil

items.source

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

cadena

Escritorio y móvil

items.timeframe

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

cadena

Escritorio

pos_overall

Indica la posición general de la función SERP Noticias principales dentro de la SERP.

entero

Escritorio y móvil

Productos populares

La popular_products la función SERP presenta un carrusel de varios productos determinados por su popularidad y relevancia para la consulta del usuario. Esto difiere de los anuncios de listado de productos (PLA), que están influenciados por los anunciantes. Cabe señalar que pueden aparecer varios popular_products carruseles en una sola página SERP.

Clave (results.popular_products)
Descripción
Tipo
Diseño

items

Una lista de productos populares con sus respectivos detalles.

arreglo

Escritorio y móvil

items.pos

Un indicador único para la posición de un producto popular dado dentro de la función SERP Productos populares.

entero

Escritorio y móvil

items.url

La URL de la página de Google Shopping del producto.

cadena

Escritorio y móvil

items.title

El título del producto.

cadena

Escritorio y móvil

items.token

Token del producto (usado con google_shopping_product source para vendedor, precios y detalles del producto).

cadena

Escritorio y móvil

items.rating

La valoración de un producto popular dado.

cadena

Escritorio y móvil

items.sellers

Una lista de vendedores que ofrecen el producto, con sus respectivos detalles.

arreglo

Escritorio y móvil

items.sellers.pos

La posición del vendedor dentro de la lista de vendedores.

entero

Escritorio y móvil

items.sellers.price_str

El precio del producto por parte del vendedor.

cadena

Escritorio y móvil

items.sellers.seller_name

El nombre del vendedor del producto.

cadena

Escritorio y móvil

items.currency

El código de moneda del precio listado.

cadena

Escritorio y móvil

items.image_data

La miniatura del producto codificada en base64.

cadena

Escritorio y móvil

items.description

Descripción breve del vendedor del producto.

cadena

Escritorio y móvil

items.rating_count

El número de valoraciones del producto.

entero

Escritorio y móvil

pos_overall

Indica la posición general de la función SERP Productos populares dentro de la SERP.

entero

Escritorio y móvil

Búsquedas relacionadas

La related_searches la función SERP muestra consultas de búsqueda alternativas relacionadas con la palabra clave de búsqueda inicial, normalmente ubicadas en la parte inferior de la SERP.

Clave (results.related_searches)
Descripción
Tipo
Diseño

pos_overall

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

entero

Escritorio y móvil

related_searches

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

arreglo

Escritorio y móvil

Preguntas relacionadas

La related_questions La función se coloca debajo de los resultados principales de búsqueda y presenta una lista de preguntas directamente relacionadas con la consulta original del usuario. Al ofrecer un conjunto seleccionado de preguntas relacionadas, los usuarios pueden explorar diferentes aspectos de su tema, mejorando su experiencia general de búsqueda.

Clave (results.related_questions)
Descripción
Tipo
Diseño

items

Una lista que contiene todas las preguntas relacionadas.

arreglo

Escritorio y móvil

items.pos

Un indicador único que denota la posición de cualquier pregunta relacionada dentro de la función SERP de Preguntas relacionadas.

entero

Escritorio y móvil

items.answer

La respuesta a la pregunta relacionada.

cadena

Escritorio y móvil

items.source

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

objeto

Escritorio y móvil

items.source.url

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

cadena

Escritorio

items.source.title

El título del sitio que contiene la respuesta.

cadena

Escritorio

items.source.url_shown

La URL abreviada visible justo debajo de la respuesta.

cadena

Escritorio y móvil

items.question

La pregunta de la sección de preguntas relacionadas.

cadena

Escritorio y móvil

pos_overall

Indica la posición general de la función SERP de Preguntas relacionadas dentro de la SERP.

entero

Escritorio y móvil

Lo que la gente dice

La 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 normalmente muestra contenido de plataformas como Reddit, TikTok y otros foros de discusión.

Clave (results.what_people_are_saying)
Descripción
Tipo
Diseño

items

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

arreglo

Escritorio y móvil

items.url

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

entero

Escritorio y móvil

items.title

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

cadena

Escritorio y móvil

items.top_comments

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

cadena

Escritorio y móvil

items.source

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

cadena

Escritorio y móvil

items.engagement_timeframe

Número de comentarios y periodo de actividad (por ejemplo, "45 comentarios, hace 2 días").

cadena

Escritorio y móvil

Información de búsqueda

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

Clave (results.search_information)
Descripción
Tipo
Diseño

query

El término de búsqueda original.

cadena

Escritorio y móvil

geo_location *

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

cadena

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 corrigió automáticamente el término de búsqueda proporcionado.

cadena

Escritorio y móvil

total_results_count

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

entero

Escritorio y móvil

*Solo funciona con renderizado JS

Carrusel de elementos

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

Clave (results.item_carousel)
Descripción
Tipo
Diseño

items

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

arreglo

Escritorio

items.pos

La posición del elemento dentro del carrusel.

entero

Escritorio

items.href

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

cadena

Escritorio

items.title

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

cadena

Escritorio

items.subtitle

Detalles adicionales sobre la entidad en el título.

cadena

Escritorio

title

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

cadena

Escritorio

pos_overall

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

entero

Escritorio

Recetas

La recipes La función SERP en 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
Diseño

items

Una lista de recetas seleccionadas con sus respectivos detalles.

arreglo

Escritorio y móvil

items.pos

La posición de la receta dentro de la función SERP de Recetas.

entero

Escritorio y móvil

items.url

La URL de la receta completa.

cadena

Escritorio y móvil

items.desc

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

cadena

Escritorio

items.title

El título de la receta.

cadena

Escritorio y móvil

items.rating

La valoración de la receta.

entero

Escritorio y móvil

items.source

El nombre del sitio web donde se encuentra la receta.

cadena

Escritorio y móvil

items.duration

El tiempo que se necesita para preparar el plato.

cadena

Escritorio y móvil

pos_overall

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

entero

Escritorio y móvil

Videos

La videos La función de 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
Diseño

items

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

arreglo

Escritorio y móvil

items.pos

La posición del video dentro de la lista.

entero

Escritorio y móvil

items.url

Un enlace al video.

cadena

Escritorio y móvil

items.title

El título del video.

cadena

Escritorio y móvil

items.author

El nombre del perfil donde se subió el video.

cadena

Escritorio y móvil

items.source

El nombre de la plataforma que aloja el video.

cadena

Escritorio y móvil

pos_overall

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

entero

Escritorio y móvil

Fragmento destacado

La featured_snippet es un resultado de búsqueda único de Google en el que 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 de búsqueda orgánicos, proporcionando a los usuarios acceso rápido a información relevante.

Clave (results.featured_snippet)
Descripción
Tipo
Diseño

url

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

cadena

Escritorio y móvil

desc

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

cadena

Escritorio y móvil

title

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

cadena

Escritorio y móvil

URL mostrada

La URL del sitio web que contiene el fragmento destacado visible en la SERP.

cadena

Escritorio y móvil

pos_overall

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

entero

Escritorio y móvil

Clave (results.related_searches_categorized)
Descripción
Tipo
Diseño

items

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

arreglo

Escritorio

items.url

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

cadena

Escritorio

items.title

El nombre del resultado de búsqueda relacionado que se muestra en el navegador.

cadena

Escritorio

category

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

objeto

Escritorio

category.name

El nombre de la categoría.

cadena

Escritorio

category.type

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

cadena

Escritorio

pos_overall

Una indicación de la posición del resultado de Búsquedas relacionadas categorizadas dentro de la SERP.

entero

Escritorio

Hoteles

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 de hoteles dedicado en la parte superior de la página de resultados, ofreciendo una vista general cómoda y destacada de las opciones relevantes.

Clave (results.hotels)
Descripción
Tipo
Diseño

date_to

La fecha de salida.

cadena

Escritorio

results

Una lista con todos los detalles del hotel.

arreglo

Escritorio

results.price

El precio del hotel.

cadena

Escritorio

results.title

El nombre del hotel.

cadena

Escritorio

results.description

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

cadena

Escritorio

date_from

La fecha de entrada.

cadena

Escritorio

pos_overall

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

entero

Escritorio

Vuelos

La 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
Diseño

to

El aeropuerto de llegada.

cadena

Escritorio y móvil

from

El aeropuerto de salida.

cadena

Escritorio y móvil

date_to

El día de llegada.

cadena

Escritorio y móvil

results

Una lista de vuelos seleccionados con sus respectivos detalles.

arreglo

Escritorio y móvil

results.url

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

cadena

Escritorio y móvil

results.type

El tipo de vuelo.

cadena

Escritorio

results.price

El precio del vuelo.

cadena

Escritorio y móvil

results.airline

El nombre de la aerolínea.

cadena

Escritorio y móvil

results.duration

La duración del vuelo.

cadena

Escritorio y móvil

date_from

La fecha de salida.

cadena

Escritorio y móvil

pos_overall

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

entero

Escritorio y móvil

Caja de video

La video_boxes La matriz incluye resultados de video específicos en la parte superior de la página de resultados de búsqueda, elegidos por Google como los más relevantes para la consulta.

Clave (results.video_boxes)
Descripción
Tipo
Diseño

pos_overall

La posición general de la Caja de video.

entero

Escritorio y móvil

title

El título del video.

cadena

Escritorio y móvil

url

La URL del video.

cadena

Escritorio y móvil

Anuncios de servicios locales

La 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
Diseño

items

Una lista de proveedores de servicios con sus respectivos detalles.

arreglo

Escritorio

items.pos

La posición del anuncio de servicio dentro de la función SERP de Anuncios de servicios locales.

entero

Escritorio

items.url

Un enlace al servicio en la página de búsqueda de Servicios locales.

cadena

Escritorio

items.title

El título del proveedor de servicios.

cadena

Escritorio

items.rating

La valoración del proveedor de servicios.

entero

Escritorio

items.reviews_count

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

entero

Escritorio

pos_overall

Una indicación de la posición del resultado de Anuncios de servicios locales dentro de la SERP.

entero

Escritorio

Apps

La apps La función 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 los desarrolladores y editores de aplicaciones mejoren la visibilidad y la interacción de sus aplicaciones móviles directamente en la página de resultados de búsqueda de Google.

Clave (results.apps)
Descripción
Tipo
Diseño

id

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

cadena

Móvil

url

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

cadena

Móvil

title

El título de la aplicación.

cadena

Móvil

valoración

La valoración de la aplicación.

entero

Móvil

reviews_count

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

entero

Móvil

items.reviews_count

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

cadena

Móvil

Finanzas

Un resumen de datos financieros de empresas, incluidos precios de acciones, capitalización bursátil y otras métricas clave.

Ejemplo HTML

Clave (results.finance)
Descripción
Tipo
Diseño

low

El precio mínimo para la fecha especificada.

flotante

Escritorio

date

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

cadena

Escritorio

high

El precio máximo para la fecha especificada

flotante

Escritorio

open

El precio de apertura para la fecha especificada

flotante

Escritorio

source

La URL del sitio web fuente relevante de Google Finance.

cadena

Escritorio

difference

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

cadena

Escritorio

market_cap

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

cadena

Escritorio

stock_name

El nombre de la acción.

cadena

Escritorio

52_week_low

El precio mínimo de 52 semanas

flotante

Escritorio

52_week_high

El precio máximo de 52 semanas

flotante

Escritorio

current_price

Cotización de precio en tiempo real.

cadena

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

flotante

Escritorio

price_earning_ratio

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

flotante

Escritorio

Muestra JSON

Juegos deportivos

Información sobre partidos deportivos recientes, con detalles de marcadores, equipos, tipos de juego y aspectos destacados.

Ejemplo HTML

Clave (results.sports_games)
Descripción
Tipo
Diseño

juegos

Un arreglo que proporciona información sobre varios juegos deportivos

arreglo

Escritorio

games.date

La fecha y hora en que se programa el partido o en que ocurrió

cadena

Escritorio

games.teams

Los equipos involucrados en el partido

arreglo

Escritorio

games.game_type

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

cadena

Escritorio

games.highlight

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

cadena

Escritorio

games.teams.score

Las puntuaciones o puntos obtenidos por cada equipo durante el partido

cadena

Escritorio

games.teams.winner

Especifica qué equipo ganó el partido

booleano

Escritorio

games.teams.team_name

Muestra los nombres de los equipos involucrados en el partido

cadena

Escritorio

etapa

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

cadena

Escritorio

liga

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

cadena

Escritorio

Muestra JSON

Discusiones y foros

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

Muestra de HTML

Clave (results.discussions_and_forums)
Descripción
Tipo
Diseño

items

Un arreglo de elementos o entradas dentro de un hilo de foro o discusión que Google ha indexado

arreglo

Escritorio

items.pos

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

entero

Escritorio

items.url

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

cadena

Escritorio

items.title

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

cadena

Escritorio

items.source

La fuente que aloja el foro o la discusión

cadena

Escritorio

items.timeframe

El periodo de tiempo o la fecha de la publicación del foro o la discusión

cadena

Escritorio

items.comments_count

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

cadena

Escritorio

pos_overall

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

entero

Escritorio

Muestra JSON

Última actualización

¿Te fue útil?