Integraciones API y Guía para Desarrolladores

¿Por Qué Usar la API de GEO-Score?

Aunque el panel de GEO-Score es poderoso para análisis manual, la API desbloquea automatización a escala. Integre el análisis GEO directamente en su sistema de gestión de contenido, pipeline de CI/CD o herramientas de informes personalizadas para monitorear la visibilidad de búsqueda de IA en todo su sitio web automáticamente.

Ya sea que usted sea un desarrollador individual automatizando su propio flujo de trabajo o una agencia gestionando cientos de sitios de clientes, la API le da acceso programático a cada función disponible en el panel y más.

Descripción General de la API

La API de GEO-Score sigue convenciones RESTful con cuerpos de solicitud y respuesta JSON. Todos los endpoints requieren autenticación mediante clave API y devuelven estructuras de respuesta consistentes.

URL Base

https://api.bloffee.com/v1

Formato de Respuesta

Todas las respuestas de 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 API debe incluir su clave API en el encabezado de autorización. Las claves API están delimitadas a su cuenta y pueden ser gestionadas desde la configuración de su panel.

Obteniendo Su Clave API

Navegue a Panel > Configuración > Claves API para generar una nueva clave. Puede crear múltiples claves con diferentes permisos para diferentes integraciones. Cada clave puede ser revocada individualmente sin afectar a otras.

Authorization: Bearer YOUR_API_KEY_HERE

Usando Su Clave API

Incluya su clave API como un token Bearer en el encabezado de autorización 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 proporciona endpoints para enviar URLs para análisis, recuperar resultados, activar reanálisis y comparar múltiples URLs. Aquí hay un resumen de todos los endpoints disponibles:

GET/urls

Recupere una lista paginada de todas las URLs analizadas en su cuenta.

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

GET/urls/:id

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

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

POST/urls

Envíe una nueva URL para análisis GEO. Devuelve el ID de análisis para sondear resultados.

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

PUT/urls/:id/refresh

Active un nuevo reanálisis de una URL previamente analizada.

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

GET/compare

Compare puntuaciones GEO y desglose de factores entre múltiples URLs lado a lado.

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

Ejemplos de Código

Comience rápidamente con estos ejemplos de código listos para usar en lenguajes de programación populares. Copie, pegue y personalice para su 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 a GEO-Score enviar notificaciones en tiempo real a su servidor cuando ocurren eventos importantes. En lugar de sondear la API para actualizaciones, configure una URL de webhook y reciba devoluciones de llamada instantáneas.

Configurando Webhooks

Configure su endpoint de webhook en Panel > Configuración > Webhooks. Puede seleccionar qué eventos activan notificaciones y establecer un secreto de firma personalizado para verificación de carga útil.

analysis.complete Se activa cuando un análisis de URL termina de procesarse y los resultados están disponibles.
score.changed Se activa cuando una URL reanalizada muestra un cambio significativo en la Puntuación GEO (delta > 5 puntos).
report.generated Se activa cuando un informe programado o bajo demanda está listo para descarga.
url.added Se activa cuando se añade una nueva URL a su cuenta para seguimiento.

Ejemplo de Carga Útil 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

•Analizar automáticamente cada nueva publicación de blog en su CMS antes de que se publique
•Configurar notificaciones de Slack cuando cualquier URL rastreada caiga por debajo de un umbral de Puntuación GEO
•Generar informes PDF semanales y enviarlos por correo electrónico a sus clientes o partes interesadas
•Construir un panel personalizado que combine datos de GEO Score con su plataforma de análisis
•Activar reanálisis después de actualizaciones de contenido para medir el impacto de sus optimizaciones
•Crear una lista de verificación prepublicación que requiera una Puntuación GEO mínima antes de que el contenido se publique

Integraciones de Terceros

GEO-Score se integra con herramientas y plataformas populares para encajar perfectamente en su flujo de trabajo existente. Use nuestras integraciones nativas o construya la suya propia usando la API.

Zapier

Conecte GEO-Score a más de 5,000 aplicaciones. Active Zaps en finalización de análisis, cambios de puntuación o nuevas URLs añadidas a su cuenta.

WordPress

Instale el plugin GEO-Score para analizar páginas directamente desde el editor de WordPress. Vea puntuaciones GEO en tiempo real mientras escribe y publica.

Slack

Reciba notificaciones instantáneas de Slack para cambios de puntuación, análisis completados e informes de resumen semanales en su canal elegido.

Google Sheets

Sincronice automáticamente datos de GEO Score con Google Sheets para informes personalizados, análisis de tendencias y fácil compartición con su equipo.

HubSpot

Enriquezca su estrategia de contenido de HubSpot con datos de GEO Score. Rastree visibilidad de IA junto con sus métricas de marketing existentes.

Google Analytics

Correlacione mejoras de GEO Score con cambios de tráfico orgánico. Vea cómo la optimización de búsqueda de IA impacta su tráfico del mundo real.

Límites de Tasa

Los límites de tasa de API se basan en su plan de suscripción. Las solicitudes que excedan su límite de tasa recibirán una respuesta 429 con un encabezado Retry-After indicando cuándo puede reanudar.

Starter

100

solicitudes por hora

Pro

1,000

solicitudes por hora

Enterprise

Personalizado

contáctenos para límites

Los límites de tasa se restablecen en una ventana rodante de una hora. Se permiten solicitudes de ráfaga hasta 2x su límite por hora por períodos cortos. Contacte a soporte si necesita límites más altos.

Próximos Pasos

¿Listo para comenzar? Genere su clave API desde la página de configuración del panel e intente los ejemplos de código anteriores. Nuestra documentación API incluye esquemas detallados de solicitud y respuesta para cada endpoint.

Para casos de uso avanzados, explore nuestro sistema de webhook para construir integraciones impulsadas por eventos. Use el endpoint POST /urls para enviar páginas para análisis y el endpoint GET /urls/:id para recuperar resultados detallados.