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 Buscar.
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
}'import requests
from pprint import pprint
# Estructurar payload.
payload = {
'source': 'google_ads',
'domain': 'nl',
'query': 'adidas',
'parse': True
}
# Obtener respuesta.
response = requests.request(
'POST',
'https://realtime.oxylabs.io/v1/queries',
auth=('USERNAME', 'PASSWORD'),
json=payload,
)
# Imprimir la respuesta formateada en stdout.
pprint(response.json())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.
source
Establece el scraper.
google_ads
query
La palabra clave o frase a buscar.
-
parse
Devuelve datos parseados cuando se establece en true. Explore la salida diccionario de datos.
false
- parámetro obligatorio
Localización
Adapte los resultados de búsqueda a ubicaciones geográficas específicas, dominios y idiomas.
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í.
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.
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.
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í.
-
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í.
-
Otros
Configuraciones avanzadas adicionales y controles para requisitos especializados.
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.
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í.
integer
Última actualización
¿Te fue útil?

