Integraciones con API y guía para desarrolladores

¿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

https://api.bloffee.com/v1

Formato de respuesta

Todas las respuestas de la API siguen una estructura JSON consistente con códigos de estado y objetos de datos anidados:

{
  "status": "success",
  "data": {
    "url": "https://example.com/page",
    "geoScore": 85,
    "factors": {...}
  }
}

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.

Authorization: Bearer YOUR_API_KEY_HERE

Usar tu API key

Incluye tu API key como un Bearer token en la cabecera Authorization de cada solicitud:

curl -X GET \
  https://api.bloffee.com/v1/urls \
  -H "Authorization: Bearer YOUR_API_KEY"

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:

GET/urls

Obtiene una lista paginada de todas las URLs analizadas en tu cuenta.

GET https://api.bloffee.com/v1/urls?page=1&limit=50

GET/urls/:id

Obtiene los resultados completos del análisis de una URL específica por su ID único.

GET https://api.bloffee.com/v1/urls/abc123

POST/urls

Envía una nueva URL para su análisis GEO. Devuelve el ID del análisis para consultar los resultados.

POST https://api.bloffee.com/v1/urls

PUT/urls/:id/refresh

Lanza un nuevo análisis de una URL ya analizada previamente.

PUT https://api.bloffee.com/v1/urls/abc123/refresh

GET/compare

Compara las puntuaciones GEO y el desglose de factores entre varias URLs lado a lado.

GET https://api.bloffee.com/v1/compare?urls=id1,id2,id3

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)

const fetch = require('node-fetch');

const analyzeURL = async (url) => {
  const response = await fetch('https://api.bloffee.com/v1/urls', {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer YOUR_API_KEY',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({ url })
  });

  const data = await response.json();
  console.log('GEO Score:', data.data.geoScore);
  return data;
};

analyzeURL('https://example.com/my-page');

Python

import requests

def analyze_url(url):
    headers = {
        'Authorization': 'Bearer YOUR_API_KEY',
        'Content-Type': 'application/json'
    }

    response = requests.post(
        'https://api.bloffee.com/v1/urls',
        headers=headers,
        json={'url': url}
    )

    data = response.json()
    print(f"GEO Score: {data['data']['geoScore']}")
    return data

analyze_url('https://example.com/my-page')

PHP

<?php
$url = 'https://example.com/my-page';

$data = array('url' => $url);
$options = array(
    'http' => array(
        'header'  => "Authorization: Bearer YOUR_API_KEY
" .
                     "Content-Type: application/json
",
        'method'  => 'POST',
        'content' => json_encode($data)
    )
);

$context  = stream_context_create($options);
$result = file_get_contents(
    'https://api.bloffee.com/v1/urls',
    false,
    $context
);

$response = json_decode($result, true);
echo "GEO Score: " . $response['data']['geoScore'];
?>

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

{
  "event": "analysis.complete",
  "timestamp": "2025-01-10T12:00:00Z",
  "data": {
    "url_id": "abc123",
    "url": "https://example.com/page",
    "geoScore": 85,
    "previousScore": 78,
    "factors": {
      "readability": 90,
      "comprehensiveness": 82,
      "aiOptimization": 85
    }
  }
}

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 basan en tu plan de suscripción. Las solicitudes que superen tu límite recibirán una respuesta 429 con una cabecera Retry-After indicando cuándo puedes reanudar.

Starter

100

solicitudes por hora

Pro

1,000

solicitudes por hora

Enterprise

Personalizado

contáctanos para conocer los límites

Los límites de uso se reinician en una ventana móvil de una hora. Se permiten ráfagas de hasta 2x tu límite por hora durante períodos cortos. 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.