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

Búsqueda web

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

El google_search la fuente 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, lee 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 hasta el 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 deseas usar Proxy Endpoint o la integración asíncrona Push-Pull consulta 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 scrapear 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 a buscar.

-

render

Activa el renderizado JavaScript cuando se establece en html. Más info.

-

parse

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

false

callback_url

URL a tu endpoint de callback. Más info.

-

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 hacer scraping, puede ser útil combinar los operadores avanzados de búsqueda de Google con tu consulta. Te permite personalizar el alcance de la búsqueda, asegurando que los resultados sean más relevantes y enfocados. Explora estos comandos especiales aquíarrow-up-right y aquíarrow-up-right. Ve un ejemplo abajo.

Localización

Adapta los resultados de búsqueda a ubicaciones geográficas, locales e idiomas específicos.

Parámetro
Descripción
Valor predeterminado

geo_location

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

-

locale

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

-

context: results_language

Idioma de los resultados. La lista de idiomas de Google soportados se puede encontrar aquí. Aprende cómo usar parámetros de context aquí.

-

Paginación

Controles para gestionar la paginación y 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

Raspa 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 indicar el número de resultados orgánicos por página usando la limit clave, puedes 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.

-

Soporte de desplazamiento continuo

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

Límite por página

circle-exclamation

Para usar esta función, incluye una matriz JSON con objetos JSON que contengan los siguientes datos:

Parámetro
Descripción
Ejemplo

page

El número de la página que te gustaría raspar. 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 resultados de búsqueda basados en varios criterios. Aprende cómo usar parámetros de context aquí.

Parámetro
Descripción
Valor predeterminado

context: filter

Establecer el valor de este parámetro en 0 te permite ver resultados que de otro modo serían excluidos debido a similitud con otros resultados.

1

context: safe_search

Búsqueda segura. Establecer en true para habilitarla.

false

context: udm

udm 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. Encuentra los valores aceptados aquíarrow-up-right.

-

context: tbm

Parámetro To-be-matched o tbm Aceptados: 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 oscuros, como limitar/ordenar resultados por fecha así como otros filtros, algunos de los cuales dependen del tbm parámetro (p. ej. tbs=app_os:1 está disponible solo con tbm value app). Más info aquíarrow-up-right.

-

circle-exclamation

Otros

Configuraciones avanzadas adicionales y controles para requisitos especializados.

Parámetro
Descripción
Valor predeterminado

context: fpstate

Establecer el fpstate valor en aig hará que Google cargue más apps. 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 context

Todos los parámetros de context deben añadirse al context array como objetos con pares y value key

"value": "0"

Datos estructurados

chevron-rightgoogle_search Web Scraper API es capaz de extraer ya sea 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.hashtag
circle-info

La composición de los 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, page, resultados, y otros. La tabla a continuación presenta una lista detallada de cada característica 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 según la consulta de búsqueda.

Nombre clave
Descripción
Tipo

url

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

string

page

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 emblemáticos o atracciones 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 artículos 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, incluidos 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 partidos y momentos destacados.

object

results.discussions_and_forums

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

object

results.featured_snippet

Una lista de resultados específicos extraídos de la parte orgánica de las 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 participación y marcos 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 mediante desplazamiento).

integer

parse_status_code

El código de estado del trabajo de análisis. Puede ver los códigos de estado del analizador 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 el trabajo 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 analizador utilizado 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 disponible para el tipo de resultado.

Anuncios de listado de productos (PLA)

El pla Esta 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 un formato de carrusel.

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

elementos

Todas las PLAs 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 característica SERP PLA dentro del SERP.

integer

Escritorio y Móvil

Pagado

El paid esta sección se refiere a anuncios impulsados por Google Ads, que suelen aparecer 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 debajo del 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

Imágenes

El images esta sección se refiere a 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 notar que la estructura de los datos raspados de los resultados de Búsqueda de Google puede diferir de la de los datos raspados de los resultados de Búsqueda de Imágenes de Google.

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 característica SERP Imágenes dentro del SERP.

integer

Escritorio y Móvil

Orgánico

El organic esta 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 el elemento `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 del producto, opciones de entrega, políticas de devolución.

lista de strings

Escritorio

Videos orgánicos

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 y 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 Videos orgánicos.

integer

Escritorio

url

La URL del video.

string

Escritorio

desc

Breve descripción del video.

string

Escritorio

title

El título del video.

string

Escritorio

pos_overall

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

integer

Escritorio

Top Sights

El results.top_sights contiene una lista de lugares o atracciones prominentes típicamente asociados con la ubicación o el tema de la 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 atracciones principales con sus detalles respectivos.

array

Escritorio

items.pos

La posición del resultado Top Sights dentro de la característica SERP Top Sights.

integer

Escritorio

items.title

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

string

Escritorio

pos_overall

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

integer

Escritorio

Empleos

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 empleo, título del puesto, fuente, empleador y ubicación. Las ofertas se obtienen 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 empleo.

string

Escritorio

listings.title

El título del puesto de trabajo.

string

Escritorio

listings.source

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

string

Escritorio

listings.employer

La organización que contrata para la posición identificada.

string

Escritorio

listings.location

La ubicación del puesto.

string

Escritorio

pos_overall

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

integer

Escritorio

Twitter (X)

El twitter esta característica aparece frecuentemente para marcas, películas, músicos y otras celebridades, típicamente posicionada directamente debajo del resultado de búsqueda del sitio web de la marca. Esta característica 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 característica SERP de Twitter (X).

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 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

Conocimiento

El knowledge la sección dentro de los resultados de búsqueda muestra los 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
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 usados en el panel de conocimiento.

array

Escritorio y Móvil

factoids.links

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

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 factoids.

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úsquedas relacionadas.

string

Escritorio

Local Pack

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

Key (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 de negocio 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 calificació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 calificaciones de la entidad local.

integer

Escritorio y Móvil

pos_overall

Una indicación de la posición del resultado del 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.

Key (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 del 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 cuánto tiempo hace que 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 múltiples popular_products carruseles pueden aparecer en una sola página del SERP.\

Key (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 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 calificació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 de búsqueda alternativas relacionadas con la palabra clave inicial, típicamente ubicadas en la parte inferior del SERP.

Key (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 se ubica 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.

Key (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 una 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. Esta sección típicamente muestra contenido de plataformas como Reddit, TikTok y otros foros de discusión.

Key (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 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.

Key (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

*Works only with JS rendering

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 del usuario, mostrando una selección de elementos relevantes. Esto puede abarcar desde productos y noticias hasta imágenes, creando una experiencia visual atractiva y personalizada para los usuarios.

Key (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 en Google presenta instrucciones de cocina, ingredientes, calificaciones y fuentes para platos específicos en la parte superior de los resultados de búsqueda.

Key (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 de la receta completa.

string

Escritorio y Móvil

items.desc

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

string

Escritorio

items.title

El título de la receta.

string

Escritorio y Móvil

items.rating

La calificació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 del usuario, incluyendo miniaturas, títulos e información de la fuente.

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

elementos

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

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.

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

url

La URL del sitio web de donde se recupera 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 recupera el fragmento que describe la 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 de búsqueda y sirve como una fuente dirigida de palabras clave relacionadas con el término de búsqueda principal.

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

elementos

Una lista que contiene todos los elementos de búsquedas relacionadas obtenidos 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 relacionado renderizado en el navegador.

string

Escritorio

category

Un objeto que contiene más detalles respecto a 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úsquedas relacionadas.

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 práctica y destacada de opciones relevantes.

Key (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 vuelos organizadas asociadas con una consulta de búsqueda relevante, permitiendo a los usuarios comparar opciones directamente en los resultados de búsqueda.

Key (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 destaca 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.

Key (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.

Key (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 calificació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 proporciona a empresas que pasan un proceso de verificación y revisió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, calificación y más. Esta función sirve como una plataforma valiosa para que los desarrolladores y editores de aplicaciones móviles mejoren la visibilidad y el engagement de sus aplicaciones directamente en la página de resultados de Google Search.

Key (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 información completa sobre la aplicación en el SERP.

string

Mobile

title

El título de la aplicación.

string

Mobile

rating

La calificació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, incluidos precios de acciones, capitalización de mercado y otras métricas clave.

Ejemplo HTML

Key (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 ratio 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

JSON sample

Juegos deportivos

Información sobre juegos deportivos recientes, detallando puntuaciones, equipos, tipos de partidos y momentos 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

games.date

La fecha y hora en que el partido está programado o en que se llevó a cabo

string

Escritorio

games.teams

Los equipos involucrados en el partido

array

Escritorio

games.game_type

El tipo de partido que se juega, como un encuentro de temporada regular, juego de playoff, final, etc.

string

Escritorio

games.highlight

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

string

Escritorio

games.teams.score

Las puntuaciones o puntos obtenidos por cada equipo durante el partido

string

Escritorio

games.teams.winner

Especifica qué equipo ganó el partido

boolean

Escritorio

games.teams.team_name

Muestra los nombres de los equipos involucrados en el partido

string

Escritorio

stage

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

string

Escritorio

league

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

string

Escritorio

JSON sample

Debates y foros

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

Muestra 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 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 período de tiempo 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

JSON sample

Última actualización

¿Te fue útil?