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 permet l'automatisation à grande échelle. Intégrez l'analyse GEO directement dans votre système de gestion de contenu, votre pipeline CI/CD ou vos outils de reporting personnalisés pour surveiller automatiquement la visibilité dans la recherche IA sur l'ensemble de votre site.

Que vous soyez développeur indépendant automatisant votre propre flux de travail ou agence gérant des centaines de sites clients, l'API vous donne un accès programmatique à toutes les fonctionnalités du tableau de bord et plus encore.

Aperçu de l'API

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

URL de base

https://api.bloffee.com/v1

Format de réponse

Toutes les réponses de l'API suivent une structure JSON cohérente avec des codes de statut et des 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

Accédez à 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 en tant que 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"

Endpoints disponibles

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

GET/urls

Récupère 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

Obtient 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

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

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

PUT/urls/:id/refresh

Déclenche une nouvelle analyse d'une URL précédemment analysée.

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

GET/compare

Compare les scores GEO et les détails 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 des langages de programmation populaires. Copiez, collez et personnalisez selon votre cas d'usage.

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 d'envoyer des notifications en temps réel à votre serveur dès qu'un événement important se produit. Au lieu d'interroger l'API pour les mises à jour, configurez une URL webhook et recevez des callbacks instantanés.

Configurer les webhooks

Configurez votre endpoint webhook dans Tableau de bord > Paramètres > Webhooks. Vous pouvez sélectionner les événements qui déclenchent les 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 son traitement et que les résultats sont disponibles.
score.changed Déclenché lorsqu'une URL réanalysée affiche un changement significatif du GEO Score (delta > 5 points).
report.generated Déclenché lorsqu'un rapport planifié 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 sa mise en ligne
•Configurez des notifications Slack lorsqu'une URL suivie passe sous un seuil de GEO Score
•Générez des rapports PDF hebdomadaires et envoyez-les par e-mail à vos clients ou parties prenantes
•Créez un tableau de bord personnalisé qui combine les données GEO Score avec votre plateforme d'analyse
•Déclenchez une réanalyse après les mises à jour de contenu pour mesurer l'impact de vos optimisations
•Créez une checklist de pré-publication exigeant un GEO Score minimum avant la mise en ligne du contenu

Intégrations tierces

GEO-Score s'intègre avec des outils et plateformes populaires pour s'adapter parfaitement à votre flux de travail existant. Utilisez nos intégrations natives ou créez les vôtres avec l'API.

Zapier

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

WordPress

Installez le plugin GEO-Score pour analyser les pages directement depuis l'éditeur WordPress. Visualisez les GEO scores en temps réel pendant l'écriture et la publication.

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 des rapports personnalisés, l'analyse de tendances et le partage facile avec votre équipe.

HubSpot

Enrichissez votre stratégie de contenu HubSpot avec les données GEO Score. Suivez la visibilité IA en parallèle de vos métriques marketing existantes.

Google Analytics

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

Limites de débit

Les limites de débit de l'API dépendent de votre formule d'abonnement. Les requêtes dépassant votre limite reçoivent 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 sont réinitialisées sur une fenêtre glissante d'une heure. Des pics de requêtes jusqu'à 2x votre limite horaire sont autorisés sur de courtes périodes. Contactez le support si vous avez besoin de limites plus élevées.

Étapes suivantes

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 détaillés de requête et de réponse pour chaque endpoint.

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