Proporcionado por DataForSEO
Obtener los resultados orgánicos de Google y sus posiciones para una palabra clave (DataForSEO)
Obtén los resultados orgánicos de Google para una palabra clave en una ubicación, cada uno con su número de posición, URL clasificada y descripción, además de los bloques de funcionalidades SERP que ocupan la página. Diseñado para seguir la posición de las páginas. Pago por consulta, sin plan.
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/serp/google/organic/live/advanced on Glasser.glasser run -p dataforseo -e '/v3/serp/google/organic/live/advanced' -i '{"keyword":"coffee roasters seattle","language_code":"en","location_code":2840}' --endpoint-version 7Usa la versión de endpoint 7. 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/serp/google/organic/live/advanced","input":{"keyword":"coffee roasters seattle","language_code":"en","location_code":2840},"endpoint_version":7}'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 7; comprueba el precio actual antes de ejecutar.
Paso 2Prueba una tarea de ejemplo específica
Cuando necesites investigar el panorama de búsquedas de zapatillas para correr en EE. UU., puedes consultar las páginas que aparecen en los resultados orgánicos de Google para identificar competidores que merezca la pena revisar.
Copia este prompt en tu agente para revisar las páginas posicionadas para esta búsqueda.
Use dataforseo:/v3/serp/google/organic/live/advanced on Glasser.
For "running shoes" in the US, show the returned Google organic positions and ranking URLs.Estructura del endpoint
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"keyword"
],
"properties": {
"os": {
"type": "string"
},
"tag": {
"type": "string"
},
"url": {
"type": "string",
"description": "Direct search URL, parsed into the request by DataForSEO. Paging inside it is billed per page."
},
"depth": {
"type": "integer",
"maximum": 200,
"minimum": 1,
"description": "Results to collect (1-200, default 10). DataForSEO bills each page of up to 10 results."
},
"device": {
"type": "string"
},
"target": {
"type": "string"
},
"keyword": {
"type": "string",
"pattern": "^(?:(?!(?:site|inurl|intitle|allintitle|allinurl|filetype|related|cache):).)*$",
"maxLength": 700,
"minLength": 1
},
"se_domain": {
"type": "string"
},
"search_param": {
"type": "string",
"description": "Extra search engine URL parameters. Paging inside them is billed per page by DataForSEO."
},
"language_code": {
"type": "string",
"pattern": "^[a-z]{2}$"
},
"language_name": {
"type": "string"
},
"location_code": {
"type": "integer",
"maximum": 99999999,
"minimum": 1
},
"location_name": {
"type": "string"
},
"find_targets_in": {
"type": "array"
},
"max_crawl_pages": {
"type": "integer",
"description": "Search result pages to crawl (max 100). DataForSEO bills each page crawled."
},
"remove_from_url": {
"type": "array"
},
"ignore_targets_in": {
"type": "array"
},
"target_search_mode": {
"type": "string",
"description": "With stop_crawl_on_match: stop when all targets (all) or any target (any) is found."
},
"location_coordinate": {
"type": "string"
},
"stop_crawl_on_match": {
"type": "array",
"description": "Keep crawling result pages until these targets appear. DataForSEO bills each page crawled."
},
"browser_screen_width": {
"type": "integer"
},
"calculate_rectangles": {
"type": "boolean",
"description": "Pixel position of each result on the page. DataForSEO charges extra for it ($0.002 on most engines)."
},
"browser_screen_height": {
"type": "integer"
},
"group_organic_results": {
"type": "boolean"
},
"load_async_ai_overview": {
"type": "boolean",
"description": "Also load AI overviews that load asynchronously. Adds $0.002, refunded by DataForSEO when there is none."
},
"people_also_ask_click_depth": {
"type": "integer",
"description": "Expand People Also Ask 1-4 levels. Each click adds $0.00015, refunded when the element is absent."
},
"browser_screen_resolution_ratio": {
"type": "integer"
}
},
"additionalProperties": false
}{
"keyword": "coffee roasters seattle",
"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
| Entrada de tamaño predeterminado | Las entradas más grandes y las opciones de pago varían según el uso del proveedor de datos. El mismo precio con o sin datos coincidentes. | $0.004 |
|---|---|---|
| Máximo por Run | El cargo total no superará este importe. | $4.032 |
| 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 |