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

Ads Max

Aprende cómo puedes usar esta fuente para la máxima visibilidad de anuncios pagados.

El google_ads la fuente está optimizada para recuperar resultados de Google Search (SERPs) y Google AI Overviews con anuncios pagados en un máxima tasa de anuncios. La fuente devolverá solo diez resultados por página, asegurando las mayores probabilidades de que aparezcan resultados pagados. Aparte de eso, admite los mismos parámetros que el Web Buscararrow-up-right.

Solicitar ejemplos

En este ejemplo, hacemos una solicitud a google.nl para recuperar resultados de búsqueda para la palabra clave adidas.

curl 'https://realtime.oxylabs.io/v1/queries' \
--user 'USERNAME:PASSWORD' \
-H 'Content-Type: application/json' \
-d '{
        "source": "google_ads", 
        "domain": "nl", 
        "query": "adidas",
        "parse": true
    }'

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

Valores de parámetros de la solicitud

Genérico

Configuración básica y opciones de personalización para scrapear anuncios de Google.

Parámetro
Descripción
Valor predeterminado

source

Establece el scraper.

google_ads

query

La palabra clave o frase a buscar.

-

user_agent_type

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

Localización

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

Parámetro
Descripción
Valor predeterminado

geo_location

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

-

dominio

Localización de dominio para Google. La lista completa de dominios disponibles se puede encontrar aquíarrow-up-right.

com

localidad

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 soportados se puede encontrar aquí.

-

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

Filtrado

Opciones para filtrar y refinar los resultados de búsqueda según varios criterios.

Parámetro
Descripción
Valor predeterminado

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 Acepta los siguientes valores: app, blg, bks, dsc, isch, nws, pts, plcs, rcp, lcl

-

context: tbs

tbs parámetro. Este parámetro es como un contenedor para parámetros más oscuros de google, 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 solo está disponible con tbm value app). Más información aquíarrow-up-right.

-

Otros

Configuraciones avanzadas adicionales y controles para requisitos especializados.

Parámetro
Descripción
Valor predeterminado

context: nfpr

true desactivará la corrección ortográfica automática

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

Ejemplo de salida

Diccionario de salida

google_ads la salida incluye campos como URL, página, resultados y más. La tabla a continuación presenta una lista detallada de cada elemento de Google Ads Max que parseamos, incluyendo descripción, tipo de datos y metadatos relevantes.

circle-info

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

Nombre clave
Descripción
Tipo

url

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

string

page

Número de página.

integer

results

Un objeto que contiene todos los tipos de resultados de búsqueda.

object

results.paid

Lista de resultados de anuncios pagados con detalles como título, descripción, URL y enlaces del sitio.

array

results.organic

Lista de resultados orgánicos (no pagados) con título, descripción, URL y enlaces del sitio.

array

results.images

Resultados de carrusel de imágenes mostrados en la página de búsqueda.

object

results.knowledge

Datos del panel del Knowledge Graph que incluyen título, descripción, imágenes, datos clave y búsquedas relacionadas.

object

results.navigation

Pestañas de navegación para cambiar entre tipos de búsqueda (Imágenes, Videos, Noticias, etc.).

array

results.instant_answers

Funciones especiales o cuadros de respuestas instantáneas mostrados en la página.

array

results.related_searches

Sugerencias de búsqueda relacionadas con sus consultas y posición.

object

results.search_information

Metadatos sobre la búsqueda que incluyen la consulta y el recuento total de resultados.

object

results.total_results_count

Número total estimado de resultados para la consulta.

integer

parse_status_code

Código de estado de la operación de parseo.

integer

created_at

Marca de tiempo cuando se creó el trabajo de scraping.

timestamp

updated_at

Marca de tiempo cuando se finalizó el trabajo de scraping.

timestamp

job_id

ID del trabajo asociado con el trabajo de scraping.

string

status_code

Código de estado del trabajo de scraping. Puedes ver los códigos de estado del scraper descritos aquíarrow-up-right.

integer

Última actualización

¿Te fue útil?