¿Por qué usar la API de GEO-Score?
Aunque el panel de GEO-Score es potente para el análisis manual, la API desbloquea la automatización a escala. Integra el análisis GEO directamente en tu sistema de gestión de contenidos, en tu pipeline de CI/CD o en herramientas de reportes personalizadas para monitorear automáticamente la visibilidad en búsqueda con IA en todo tu sitio web.
Tanto si eres un desarrollador independiente automatizando tu propio flujo como una agencia gestionando cientos de sitios de clientes, la API te da acceso programático a todas las funciones disponibles en el panel y más.
Visión general de la API
La API de GEO-Score sigue convenciones RESTful con cuerpos de solicitud y respuesta en JSON. Todos los endpoints requieren autenticación mediante API key y devuelven estructuras de respuesta consistentes.
URL base
Formato de respuesta
Todas las respuestas de la API siguen una estructura JSON consistente con códigos de estado y objetos de datos anidados:
Autenticación
Cada solicitud a la API debe incluir tu API key en la cabecera Authorization. Las API keys están vinculadas a tu cuenta y se pueden gestionar desde la configuración del panel.
Obtener tu API key
Ve a Panel > Configuración > API Keys para generar una nueva clave. Puedes crear varias claves con distintos permisos para distintas integraciones. Cada clave puede revocarse individualmente sin afectar a las demás.
Usar tu API key
Incluye tu API key como un Bearer token en la cabecera Authorization de cada solicitud:
Endpoints disponibles
La API de GEO-Score ofrece endpoints para enviar URLs para análisis, obtener resultados, lanzar nuevos análisis y comparar varias URLs. Aquí tienes un resumen de todos los endpoints disponibles:
Obtiene una lista paginada de todas las URLs analizadas en tu cuenta.
Obtiene los resultados completos del análisis de una URL específica por su ID único.
Envía una nueva URL para su análisis GEO. Devuelve el ID del análisis para consultar los resultados.
Lanza un nuevo análisis de una URL ya analizada previamente.
Compara las puntuaciones GEO y el desglose de factores entre varias URLs lado a lado.
Ejemplos de código
Empieza rápido con estos ejemplos de código listos para usar en lenguajes de programación populares. Copia, pega y adapta a tu caso de uso específico.
JavaScript (Node.js)
Python
PHP
Webhooks
Los webhooks permiten que GEO-Score envíe notificaciones en tiempo real a tu servidor cuando ocurren eventos importantes. En lugar de hacer polling a la API en busca de actualizaciones, configura una URL de webhook y recibe callbacks instantáneos.
Configurar webhooks
Configura tu endpoint de webhook en Panel > Configuración > Webhooks. Puedes seleccionar qué eventos disparan notificaciones y establecer un secreto de firma personalizado para verificar el payload.
analysis.complete
Se dispara cuando un análisis de URL termina de procesarse y los resultados están disponibles.
score.changed
Se dispara cuando una URL re-analizada muestra un cambio significativo en el GEO Score (delta > 5 puntos).
report.generated
Se dispara cuando un reporte programado o bajo demanda está listo para descargar.
url.added
Se dispara cuando se añade una nueva URL a tu cuenta para su seguimiento.
Ejemplo de payload de webhook
Ideas de automatización
Analiza automáticamente cada nueva entrada de blog publicada en tu CMS antes de que salga online
Configura notificaciones de Slack cuando cualquier URL monitoreada caiga por debajo de un umbral de GEO Score
Genera reportes semanales en PDF y envíalos por email a tus clientes o stakeholders
Crea un panel personalizado que combine los datos de GEO Score con tu plataforma de analítica
Lanza un nuevo análisis tras actualizaciones de contenido para medir el impacto de tus optimizaciones
Crea una checklist previa a la publicación que exija un GEO Score mínimo antes de publicar contenido
Integraciones de terceros
GEO-Score se integra con herramientas y plataformas populares para encajar perfectamente en tu flujo de trabajo. Usa nuestras integraciones nativas o crea las tuyas propias usando la API.
Zapier
Conecta GEO-Score con más de 5.000 apps. Dispara Zaps al completarse análisis, ante cambios de puntuación o cuando se añadan nuevas URLs a tu cuenta.
WordPress
Instala el plugin de GEO-Score para analizar páginas directamente desde el editor de WordPress. Visualiza los GEO scores en tiempo real mientras escribes y publicas.
Slack
Recibe notificaciones instantáneas en Slack ante cambios de puntuación, análisis completados y reportes resumen semanales en el canal que elijas.
Google Sheets
Sincroniza automáticamente los datos de GEO Score con Google Sheets para reportes personalizados, análisis de tendencias y compartir fácilmente con tu equipo.
HubSpot
Enriquece tu estrategia de contenidos en HubSpot con datos de GEO Score. Monitorea la visibilidad en IA junto a tus métricas de marketing existentes.
Google Analytics
Correlaciona las mejoras de GEO Score con cambios en el tráfico orgánico. Comprueba cómo la optimización para búsqueda con IA impacta tu tráfico real.
Límites de uso
Los límites de uso de la API se aplican por cuenta y se comparten en todos los planes, desde el nivel Gratis hasta la Suscripción Ilimitada de €29,99/mes. Las solicitudes que superen tu límite recibirán una respuesta 429 con una cabecera Retry-After indicando cuándo puedes reanudar.
Los límites de uso se reinician en una ventana móvil de una hora. Contacta con soporte si necesitas límites más altos.
Próximos pasos
¿Listo para empezar? Genera tu API key desde la página de configuración del panel y prueba los ejemplos de código de arriba. Nuestra documentación de la API incluye esquemas detallados de solicitud y respuesta para cada endpoint.
Para casos de uso avanzados, explora nuestro sistema de webhooks para crear integraciones dirigidas por eventos. Usa el endpoint POST /urls para enviar páginas a análisis y el endpoint GET /urls/:id para obtener resultados detallados.