API REST de SeoMap para Agencias y Desarrolladores
Qué se automatiza realmente
Leer resultados de escaneo a mano desde un panel funciona bien con un puñado de clientes. Deja de funcionar en cuanto alguien necesita esos datos en otro sitio — un panel de cara al cliente, una hoja de cálculo que se actualiza sola, un flujo de Zapier o n8n que publica un mensaje en Slack cuando el SoLV de una palabra clave cae. Todos esos casos necesitan lo mismo: una forma de extraer los propios datos de SeoMap de forma programática, en lugar de copiarlos a mano. Para eso está la API REST, y nada más — es una vía de lectura, no una forma de manejar el producto a distancia.
Qué incluye realmente
Cuatro endpoints, todos GET, todos en JSON: una lista de los proyectos de una cuenta, los escaneos de un proyecto concreto, el detalle de un escaneo y los puntos de rejilla individuales detrás de un escaneo — ranking, estado y coordenadas de cada punto medido. Este último importa más de lo que parece: son los mismos datos por punto que renderiza el propio mapa de calor, disponibles como filas planas en vez de píxeles — justo lo que hace posible una visualización propia o un formato de informe específico para cada cliente sin tener que reconstruir un escaneo.
La autenticación es un token portador — una clave que se genera y revoca desde Ajustes, mostrada una única vez al crearla, como en cualquier interfaz sensata de claves de API. Cada respuesta está limitada al propietario de la clave; pedir un proyecto que pertenece a otra cuenta devuelve un simple «no encontrado», no un error que confirme que el ID existe pero que no se puede ver. Los datos internos — coste, créditos cobrados, estado BYOK — deliberadamente no se devuelven a través de la API, el mismo límite de datos de facturación que ya trazan los enlaces públicos para compartir.
Para quién es esto realmente
Dos grupos sacan un partido directo e inmediato. Las agencias que gestionan una cartera de clientes con SeoMap pueden volcar ARP/ATRP/SoLV directamente en el sistema de informes que ya usan para sus clientes, en vez de pedirles que revisen otra herramienta más — una sola fuente de datos, allí donde ya vive el reporting real de la agencia. Los desarrolladores y freelancers con perfil técnico obtienen la ventaja más directa: conectar SeoMap a Zapier, n8n o Make mediante su módulo HTTP genérico requiere una clave de API y unos minutos, no una integración nativa que primero tenga que existir. Una caída de ranking en un punto concreto, un escaneo programado que se completa — cualquiera de los dos puede disparar un flujo por webhook en cuanto el dato existe, sin tener que ir comprobando un panel para enterarse.
Lo que deliberadamente no hace
Vale la pena ser precisos con el límite, porque «API» invita a suponer más de lo que la función promete. Es de solo lectura — no hay ningún endpoint para iniciar un escaneo, crear un proyecto o cambiar una programación; ese hueco encaja de forma natural con los escaneos recurrentes, que se encargan de disparar los escaneos según su propio calendario, mientras la API se usa solo para recoger lo que producen. Tampoco hay un endpoint de exportación masiva más allá de lo que ya devuelven los cuatro recursos — para un CSV completo puntual de los puntos de un escaneo, el botón de exportación integrado en el propio escaneo sigue siendo más rápido que programar una consulta.
En resumen
La API no es una función nueva que aprender — son los mismos datos que cualquier usuario de SeoMap ya ve en la aplicación, disponibles como HTTP plano en vez de atados al panel. Para una agencia que alimenta su propio reporting, o un desarrollador que conecta cambios de ranking a un flujo de automatización ya existente, ese es todo el punto: llevar los números de SeoMap a donde de verdad hacen falta, sin pedirle a nadie que revise una pestaña más.