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, top stories 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 la búsqueda web de Google. Para explorar otros tipos de resultados, lea Búsqueda de imágenes o Búsqueda de noticias.

Muestras 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 Realtime sincrónico en nuestros ejemplos. Si desea usar Proxy Endpoint o la integración asincrónica 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 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 a buscar.

-

render

Habilita 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 data dictionary.

false

callback_url

URL de 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 hacer scraping, puede ser útil combinar los 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 a continuación.

Localización

Adapte los resultados de búsqueda a ubicaciones geográficas específicas, locales y lenguajes.

Parámetro
Descripción
Valor predeterminado

geo_location

La ubicación geográfica para la cual se deben adaptar los resultados. Usar este parámetro correctamente es extremadamente importante para obtener los datos correctos. Para más información, lea sobre nuestras sugeridas geo_location estructuras 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 información.

-

context: results_language

Idioma de los resultados. La lista de idiomas de Google compatibles se puede encontrar aquí. Aprenda cómo usar parámetros de contexto aquí.

-

Paginación

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

circle-exclamation
Parámetro
Descripción
Valor predeterminado

start_page

Número de página de inicio.

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 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 un array JSON con la page clave e indicando el número de resultados orgánicos por página usando la limit key, 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). Vea ejemplo.

-

Soporte de desplazamiento continuo

Web Scraper API soporta 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

circle-exclamation

Para usar esta función, incluya un array 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

Muestra de solicitud

Filtrado

Opciones para filtrar y refinar los resultados de búsqueda basados en varios criterios. Aprenda cómo usar parámetros de contexto 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 serían excluidos debido a similitud con otros resultados.

1

context: safe_search

Búsqueda segura. Establezca en true para activarla.

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

-

context: tbm

Parámetro to-be-matched o tbm Aceptación. Los valores aceptados son: app, blg, bks, dsc, isch, nws, pts, plcs, rcp, lcl

-

context: tbs

Este parámetro actúa como un contenedor para parámetros de Google más obscuros, 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 información aquíarrow-up-right.

-

circle-exclamation

Otros

Configuraciones y controles avanzados adicionales para requisitos especializados.

Parámetro
Descripción
Valor predeterminado

context: fpstate

Establecer el fpstate 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 añadirse al context array como objetos con key y value pares, p. ej.:

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 un desktop o mobile search.

Para ayudarle a identificar ciertos elementos, consulte los diccionarios de datos para cada tipo de resultado de búsqueda de Google, ya sea obtenido de 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, results, y otros. La tabla siguiente 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

results

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

object

results.pla

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

object

results.paid

Una lista de resultados patrocinados con sus respectivos detalles.

array

results.images

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

object

results.flights

Una lista de vuelos con sus respectivos detalles.

object

results.organic

Una lista de listados no pagados con sus respectivos detalles.

array

results.organic_videos

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

array

results.top_sights

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

array

results.jobs

Una lista de ofertas de empleo con sus respectivos detalles.

object

results.local_service_ads

Una lista de proveedores de servicios locales patrocinados.

object

results.video_box

Un solo elemento de video con sus respectivos detalles.

object

results.recipes

Una lista de recetas con sus respectivos detalles.

object

results.twitter

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

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 respectivos detalles.

object

results.videos

Una lista de videos con sus respectivos detalles.

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 respectivos detalles.

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 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 obtenidos de la parte orgánica de las SERP.

array

results.top_stories

Una lista de artículos con sus respectivos detalles 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 respectivos detalles.

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 respectivos detalles.

object

results.what_people_are_saying

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

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 desplazándose).

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 terminó 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 analizador utilizado para descomponer el contenido HTML.

string

circle-info

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

Product Listing Ads (PLA)

El pla La sección de resultados de búsqueda se refiere a los Product Listing Ads, también conocidos como anuncios de Google Shopping, que se muestran 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
Diseño

items

Todos los 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 imagen en miniatura codificada en base64 del producto.

string

Escritorio y Móvil

pos_overall

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

integer

Escritorio y Móvil

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

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 URL con sus respectivos detalles. 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 señalar que la estructura de los datos raspados de los resultados de Búsqueda de Google puede diferir de la de los resultados de Búsqueda de Imágenes de Google.

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

items

Una lista de imágenes con sus respectivos detalles.

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

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 imágenes en miniatura 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 de 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 (ícono 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 producto, opciones de entrega, políticas de devolución.

lista de strings

Escritorio

Organic Videos

El results.organic_videos contiene un array 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
Diseño

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

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

array

Escritorio

items.pos

La posición del resultado Top Sights dentro de la característica 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 ofertas de empleo extraídas de los resultados de búsqueda. Cada oferta incluye detalles como la URL que dirige a la publicación de empleo, título del puesto, fuente, empleador y ubicación. Las ofertas provienen de diversos portales de empleo, sitios de carrera y otras plataformas indexadas por Google.

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

listings

Una matriz de todas las ofertas de empleo disponibles dentro de la página.

array

Escritorio

listings.url

La URL hacia la oferta de empleo completa.

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 Jobs dentro del SERP.

integer

Escritorio

Twitter (X)

El twitter La característica aparece con frecuencia 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
Diseño

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

items

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

array

Escritorio

items.pos

Un indicador que denota la posición de un tweet dado dentro de la característica 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 representa 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

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

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 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 que aparecen en el panel de conocimiento.

string

Escritorio

profiles.url

Un enlace al perfil de la red social.

string

Escritorio

profiles.title

El título del perfil de la red social.

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 denota 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 mejores 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.

Key (results.local_pack)
Descripción
Tipo
Diseño

items

Una lista de ubicaciones con sus respectivos detalles.

array

Escritorio y Móvil

items.cid

Un número de identificación único asignado a una ficha de negocio específica.

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

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

items

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 múltiples popular_products carruseles pueden aparecer en una sola página de SERP.\

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

items

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 clasificación de un producto popular dado.

string

Escritorio

items.seller

El vendedor de un producto popular dado.

string

Escritorio

items.image_data

La imagen en miniatura codificada en base64 del producto.

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 al final del SERP.

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

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 posiciona debajo de los resultados principales de búsqueda, 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
Diseño

items

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

items

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 la red social.

integer

Escritorio y Móvil

items.title

El título del hilo de discusión o la 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 (por ejemplo, "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
Diseño

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

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

items

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

items

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

items

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

url

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

string

Escritorio y Móvil

desc

El fragmento que contiene una descripción de 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 que es 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 focalizado de consultas relacionadas con listas. Normalmente se encuentra al final 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
Diseño

items

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 relacionado 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 de hoteles dedicado en la parte superior de la página de resultados, ofreciendo una visión conveniente y destacada de opciones relevantes.

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

date_to

La fecha del check-out.

string

Escritorio

results

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

Key (results.flights)
Descripción
Tipo
Diseño

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

results

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

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

items

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 las empresas que superan un proceso de verificación y selección por parte 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 desarrolladores y editores de aplicaciones aumenten la visibilidad y el engagement de sus aplicaciones móviles directamente en la página de resultados de Google Search.

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

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

Ejemplo HTML

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

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 reportado 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 compañía

string

Escritorio

stock_name

El nombre de la acción.

string

Escritorio

52_week_low

El precio mínimo de 52 semanas

float

Escritorio

52_week_high

El precio máximo de 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

JSON sample

Partidos deportivos

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

Ejemplo HTML

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

partidos

Un arreglo que proporciona información sobre varios partidos deportivos

array

Escritorio

partidos.fecha

La fecha y hora en que el partido está programado o en que 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 encuentro de temporada regular, partido de playoff, final, etc.

string

Escritorio

partidos.destacado

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

string

Escritorio

partidos.equipos.marcador

Los puntajes 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_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

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.

Ejemplo HTML

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

items

Un arreglo 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 plazo 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 de la SERP.

integer

Escritorio

JSON sample

Última actualización

¿Te fue útil?