Proporcionado por DataForSEO
Consultar el volumen de búsqueda mensual y el CPC de una lista de palabras clave (DataForSEO)
Consulta las cifras de Google Ads para una lista de palabras clave en una ubicación y un idioma: el número mensual de búsquedas, el nivel de competencia de los anunciantes y el intervalo de pujas de coste por clic. Indica las palabras clave que ya tienes. Paga por solicitud, sin plan. Google Ads rechaza toda la solicitud cuando alguna palabra clave contiene un símbolo no permitido, como un emoji, paréntesis o una raya; cada palabra clave puede tener como máximo 80 caracteres y 10 palabras. language_code debe ser un código de la lista de idiomas de Google Ads de DataForSEO; un código que no figure en ella se rechaza con Invalid Field (observado: el código de idioma independiente zh).
Cómo ejecutarlo
Paso 1Configurar
Una vez: pega esto en el chat de tu agente. Skill instala el CLI e inicia sesión por sí solo. Si tu agente no puede usar un shell, conéctalo mediante MCP en su lugar.
set up https://glasser.ai/SKILL.md
Show me how to use the DataForSEO endpoint /v3/keywords_data/google_ads/search_volume/live on Glasser.glasser run -p dataforseo -e '/v3/keywords_data/google_ads/search_volume/live' -i '{"keywords":["coffee roaster","espresso machine"],"language_code":"en","location_code":2840}' --endpoint-version 2Usa la versión de endpoint 2. Comprueba el precio actual antes de ejecutar. Instala e inicia sesión primero en Comenzar.
Una vez por Run:
IDEMPOTENCY_KEY=$(uuidgen)Ejecútalo y copia este mismo bloque para volver a enviarlo:
curl -X POST https://api.glasser.ai/v1/runs \
-H "Authorization: Bearer gl_..." \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-H "Content-Type: application/json" \
-d '{"provider":"dataforseo","endpoint":"/v3/keywords_data/google_ads/search_volume/live","input":{"keywords":["coffee roaster","espresso machine"],"language_code":"en","location_code":2840},"endpoint_version":2}'Reutiliza la misma Idempotency-Key para volver a enviarlo: el segundo envío es una lectura del primer Run. Una clave nueva crea un Run y un Charge nuevos. Usa la versión de endpoint 2; comprueba el precio actual antes de ejecutar.
Paso 2Prueba una tarea de ejemplo específica
Cuando necesites priorizar una lista breve de palabras clave, puedes comparar las métricas de volumen de búsquedas para comprender la demanda de los temas que estás considerando.
Copia este prompt en tu agente para revisar la demanda de búsqueda de tu lista breve de palabras clave.
Use dataforseo:/v3/keywords_data/google_ads/search_volume/live on Glasser.
Check demand for my keyword shortlist using the search-volume metrics actually returned.Estructura del endpoint
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"keywords"
],
"properties": {
"tag": {
"type": "string"
},
"date_to": {
"type": "string"
},
"sort_by": {
"type": "string"
},
"keywords": {
"type": "array",
"items": {
"type": "string",
"pattern": "^(?:(?!(?:site|inurl|intitle|allintitle|allinurl|filetype|related|cache):).)*$",
"maxLength": 700,
"minLength": 1
},
"maxItems": 100,
"minItems": 1
},
"date_from": {
"type": "string"
},
"language_code": {
"type": "string",
"pattern": "^[a-z]{2}$"
},
"language_name": {
"type": "string"
},
"location_code": {
"type": "integer",
"maximum": 99999999,
"minimum": 1
},
"location_name": {
"type": "string"
},
"search_partners": {
"type": "boolean"
},
"location_coordinate": {
"type": "string"
},
"include_adult_keywords": {
"type": "boolean"
}
},
"additionalProperties": false
}{
"keywords": [
"coffee roaster",
"espresso machine"
],
"language_code": "en",
"location_code": 2840
}Este endpoint no publica ningún esquema de salida. Recibes el cuerpo de respuesta propio del proveedor de datos, sin cambios — no garantizamos una estructura que no podemos asegurar.
Cómo funcionan los precios
| Datos devueltos o sin coincidencias | El mismo precio con o sin datos coincidentes. | $0.09 |
|---|---|---|
| Error del proveedor de datos | El proveedor de datos no pudo responder. | $0.00 |
| Tiempo de espera agotado | El Run superó su límite de tiempo. | $0.00 |
| Error interno | Un error interno impidió completar la operación. | $0.00 |