Intégrations API et Guide Développeur

Pourquoi Utiliser l'API GEO-Score ?

Bien que le tableau de bord GEO-Score soit puissant pour l'analyse manuelle, l'API déverrouille l'automatisation à grande échelle. Intégrez l'analyse GEO directement dans votre système de gestion de contenu, pipeline CI/CD ou outils de reporting personnalisés pour surveiller automatiquement la visibilité de recherche IA sur l'ensemble de votre site web.

Que vous soyez un développeur solo automatisant votre propre workflow ou une agence gérant des centaines de sites clients, l'API vous donne un accès programmatique à chaque fonctionnalité disponible dans le tableau de bord et plus encore.

Vue d'Ensemble de l'API

L'API GEO-Score suit les conventions RESTful avec des corps de requête et de réponse JSON. Tous les points de terminaison nécessitent une authentification via clé API et retournent des structures de réponse cohérentes.

URL de Base

https://api.bloffee.com/v1

Format de Réponse

Toutes les réponses API suivent une structure JSON cohérente avec codes de statut et objets de données imbriqués :

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

Authentification

Chaque requête API doit inclure votre clé API dans l'en-tête Authorization. Les clés API sont liées à votre compte et peuvent être gérées depuis les paramètres de votre tableau de bord.

Obtenir Votre Clé API

Naviguez vers Tableau de Bord > Paramètres > Clés API pour générer une nouvelle clé. Vous pouvez créer plusieurs clés avec différentes permissions pour différentes intégrations. Chaque clé peut être révoquée individuellement sans affecter les autres.

Authorization: Bearer YOUR_API_KEY_HERE

Utiliser Votre Clé API

Incluez votre clé API comme jeton Bearer dans l'en-tête Authorization de chaque requête :

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

Points de Terminaison Disponibles

L'API GEO-Score fournit des points de terminaison pour soumettre des URL pour analyse, récupérer les résultats, déclencher des ré-analyses et comparer plusieurs URL. Voici un résumé de tous les points de terminaison disponibles :

GET/urls

Récupérez une liste paginée de toutes les URL analysées dans votre compte.

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

GET/urls/:id

Obtenez les résultats d'analyse complets pour une URL spécifique par son ID unique.

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

POST/urls

Soumettez une nouvelle URL pour analyse GEO. Retourne l'ID d'analyse pour interroger les résultats.

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

PUT/urls/:id/refresh

Déclenchez une nouvelle ré-analyse d'une URL précédemment analysée.

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

GET/compare

Comparez les scores GEO et les ventilations de facteurs entre plusieurs URL côte à côte.

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

Exemples de Code

Démarrez rapidement avec ces exemples de code prêts à l'emploi dans les langages de programmation populaires. Copiez, collez et personnalisez pour votre cas d'usage spécifique.

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

Les webhooks permettent à GEO-Score de pousser des notifications en temps réel vers votre serveur chaque fois que des événements importants se produisent. Au lieu d'interroger l'API pour les mises à jour, configurez une URL webhook et recevez des rappels instantanés.

Configuration des Webhooks

Configurez votre point de terminaison webhook dans Tableau de Bord > Paramètres > Webhooks. Vous pouvez sélectionner quels événements déclenchent des notifications et définir un secret de signature personnalisé pour la vérification de la charge utile.

analysis.complete Déclenché lorsqu'une analyse d'URL termine le traitement et que les résultats sont disponibles.
score.changed Déclenché lorsqu'une URL ré-analysée montre un changement de Score GEO significatif (delta > 5 points).
report.generated Déclenché lorsqu'un rapport programmé ou à la demande est prêt à être téléchargé.
url.added Déclenché lorsqu'une nouvelle URL est ajoutée à votre compte pour suivi.

Exemple de Charge Utile 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
    }
  }
}

Idées d'Automatisation

•Analysez automatiquement chaque nouvel article de blog publié dans votre CMS avant qu'il ne soit mis en ligne
•Configurez des notifications Slack lorsqu'une URL suivie descend en dessous d'un seuil de Score GEO
•Générez des rapports PDF hebdomadaires et envoyez-les par email à vos clients ou parties prenantes
•Créez un tableau de bord personnalisé qui combine les données GEO-Score avec votre plateforme d'analytique
•Déclenchez une ré-analyse après les mises à jour de contenu pour mesurer l'impact de vos optimisations
•Créez une liste de contrôle pré-publication qui nécessite un Score GEO minimum avant que le contenu ne soit mis en ligne

Intégrations Tierces

GEO-Score s'intègre avec les outils et plateformes populaires pour s'intégrer de manière transparente dans votre workflow existant. Utilisez nos intégrations natives ou créez la vôtre en utilisant l'API.

Zapier

Connectez GEO-Score à plus de 5 000 applications. Déclenchez des Zaps lors de la complétion d'analyse, des changements de score ou de l'ajout de nouvelles URL à votre compte.

WordPress

Installez le plugin GEO-Score pour analyser les pages directement depuis l'éditeur WordPress. Voyez les scores GEO en temps réel pendant que vous écrivez et publiez.

Slack

Recevez des notifications Slack instantanées pour les changements de score, les analyses terminées et les rapports de synthèse hebdomadaires dans le canal de votre choix.

Google Sheets

Synchronisez automatiquement les données GEO-Score vers Google Sheets pour reporting personnalisé, analyse de tendances et partage facile avec votre équipe.

HubSpot

Enrichissez votre stratégie de contenu HubSpot avec les données GEO-Score. Suivez la visibilité IA aux côtés de vos métriques marketing existantes.

Google Analytics

Corrélez les améliorations de Score GEO avec les changements de trafic organique. Voyez comment l'optimisation de recherche IA impacte votre trafic réel.

Limites de Débit

Les limites de débit de l'API sont basées sur votre plan d'abonnement. Les requêtes dépassant votre limite de débit recevront une réponse 429 avec un en-tête Retry-After indiquant quand vous pouvez reprendre.

Starter

100

requêtes par heure

Pro

1,000

requêtes par heure

Enterprise

Personnalisé

contactez-nous pour les limites

Les limites de débit se réinitialisent sur une fenêtre glissante d'une heure. Les rafales de requêtes jusqu'à 2x votre limite horaire sont autorisées pendant de courtes périodes. Contactez le support si vous avez besoin de limites plus élevées.

Prochaines Étapes

Prêt à commencer ? Générez votre clé API depuis la page des paramètres du tableau de bord et essayez les exemples de code ci-dessus. Notre documentation API inclut des schémas de requête et de réponse détaillés pour chaque point de terminaison.

Pour des cas d'usage avancés, explorez notre système de webhooks pour créer des intégrations événementielles. Utilisez le point de terminaison POST /urls pour soumettre des pages pour analyse et le point de terminaison GET /urls/:id pour récupérer les résultats détaillés.