AI SEO In Detail › Módulo D · Análisis de SERP › Episodio 27
API SERP de DataForSEO: obtén los resultados de Google en vivo por programación
Obtén resultados de Google en vivo con la API SERP de DataForSEO: parámetros clave, coste por petición, lectura de la respuesta por tipo de elemento y snapshots para comparar.
Vídeo próximamenteEste episodio tiene guion y está en producción. La transcripción de abajo es el guion tal como está escrito; puede cambiar antes de publicar el vídeo.
1,019 palabras · borrador del guion, en revisión.
Introducción
El episodio pasado analizamos diez páginas de resultados a mano. Tomó una hora, y valió la pena.
Ahora tienes cuatrocientas palabras clave. A mano, eso es una semana. Y el próximo mes quieres hacerlo de nuevo, para ver qué cambió.
Tampoco puedes guardar una página de resultados del navegador de forma útil. Una captura no se puede ordenar, filtrar o comparar.
En este episodio extraeremos resultados en vivo de Google vía API de DataForSEO: qué parámetros importan, qué cuesta, cómo leer la respuesta por tipo de elemento, y cómo guardar cada página de resultados como instantánea para comparar después.
El endpoint y sus parámetros
Configuramos la cuenta e hicimos la primera llamada en el episodio tres. Ahora usamos un endpoint específico: SERP, Google, organic, live, advanced. "Live" significa que obtienes la respuesta en la misma solicitud. "Advanced" significa que obtienes cada elemento de la página, no solo los enlaces.
La solicitud es una lista de tareas. Cada tarea describe una búsqueda, con unos pocos parámetros que importan.
La palabra clave, exactamente como una persona la escribiría.
La ubicación. Puedes darla como nombre o código numérico. El código para Estados Unidos es dos mil ochocientos cuarenta. Los resultados difieren mucho entre países, y en temas locales entre ciudades, así que siempre configura esto explícitamente.
El código de idioma, por ejemplo "en".
El dispositivo: escritorio o móvil. Los resultados pueden ser diferentes, y los compararemos correctamente en el episodio treinta y cuatro.
Y la profundidad: cuántos resultados quieres. Diez te da la primera página. Treinta te da las primeras tres páginas.
Cuánto cuesta
La profundidad es la palanca principal de costo. En mi propia facturación, una solicitud live a profundidad diez cuesta un tercio de centavo. A profundidad treinta, casi el doble.
Así que cuatrocientas palabras a profundidad diez son como un dólar veinte. A profundidad treinta, unos dos cuarenta. Barato, pero se acumula si repites cada semana, o si pones la profundidad en cien sin pensar.
Mi regla es simple. Usa profundidad diez para análisis. Usa treinta solo cuando necesites ver páginas dos y tres, como cuando rastreas páginas en distancia de alcance del episodio diez. Y antes de cada ejecución, el script imprime el número de palabras por el precio y espera un sí. Esa es la compuerta de costo del episodio seis.
La respuesta también te dice lo que costó cada tarea. Registra ese número. Es el precio real, y te dice cuándo la lista de precios ha cambiado.
Leer la respuesta
La respuesta está anidada, pero la parte que necesitas es simple. Dentro de tasks, luego result, hay una lista llamada items. Cada item es un elemento en la página de resultados, en el orden que aparece.
Cada item tiene un tipo. "Organic" es un enlace azul normal. Otros son cosas como "featured snippet", "people also ask", "local pack", "video", "images" y "AI overview". El episodio veintiocho explica qué significa cada uno de ellos.
Cada item también tiene dos posiciones, y confundirlas es el error más común. Rank group es la posición dentro de su propio tipo. El tercer resultado orgánico tiene rank group tres. Rank absolute es la posición entre todos los elementos de la página. Si un snippet, una fila de videos y una caja de preguntas vienen primero, ese mismo tercer resultado orgánico podría tener rank absolute seis.
Ninguno coincide exactamente con la posición promedio de Search Console. Search Console promedia muchas búsquedas, dispositivos y días. La API te da una instantánea. Usa la API para ver cómo se ve la página, y Search Console para ver qué pasó realmente.
Para items orgánicos, usarás principalmente el dominio, la URL, el título y la descripción. Eso basta para agrupar, clasificar quién rankea, y para coincidencia de título.
Mi parser hace una cosa simple primero: recorre los items y los ordena en grupos por tipo. Los items orgánicos van a una lista, todo lo demás a una lista de features, con la posición guardada. Nunca asumas que el primer item es el primer resultado orgánico. En muchas páginas de resultados no lo es, y eso solo rompe muchos rastreadores de rankings caseros.
El resultado también lista qué tipos de items aparecen en la página, antes de que abras los items. Esa es una forma rápida de marcar palabras clave con mapa, una fila de videos o un resumen de IA sin analizar nada.
Guardar snapshots
Guarda cada respuesta dos veces.
Primero, la respuesta cruda como archivo en tu carpeta cache, nombrado por palabra, ubicación, dispositivo y fecha. Ese es tu recibo. Si luego quieres un campo que no analizaste, no tienes que pagar de nuevo.
Segundo, los items analizados como filas en una tabla SQLite. Una fila por item, con palabra, ubicación, dispositivo, fecha, tipo, ambas posiciones, dominio, URL y título. Una página de resultados se convierte en una instantánea, diez a treinta filas más las features.
Ahora las preguntas de la hoja se vuelven consultas simples. ¿Quién rankea más a menudo en mis palabras clave? ¿Qué palabras tienen una fila de videos? ¿Dónde empieza el primer resultado orgánico? Y como cada fila tiene fecha, la ejecución del próximo mes se puede comparar con la de este, palabra por palabra.
Un hábito más. Verifica el estado de cada tarea, no solo de toda la solicitud. Una solicitud puede tener éxito mientras una sola tarea falla, por ejemplo por una ubicación mal escrita. Escribe las tareas fallidas en una lista y reintenta solo esas.
Errores habituales
Para resumir las trampas. Olvidar la ubicación, analizando el país equivocado. Usar profundidad alta por defecto y pagar por páginas que nadie lee. Mezclar rank group y rank absolute en el mismo informe. Y comparar instantáneas tomadas con configuraciones diferentes.
Ninguna de estas aparece como errores. Aparecen como conclusiones que están ligeramente equivocadas. Por eso la configuración se guarda en cada fila.
Resumen final
Así que: configura ubicación, idioma, dispositivo y profundidad a propósito, controla costo, y guarda cada página de resultados como instantánea fechada. El script Python para extraer, analizar y guardar está enlazado en la descripción. Próximo episodio: qué significan los otros tipos de items — snippets, cajas de preguntas, local packs y AI Overviews — y qué hacen a tus clics. Nos vemos allí.