DOCUMENTATION API

Intégrez l'analyse multi-perspectives dans vos applications.

L'API The Refract fournit un accès programmatique à nos données d'analyse comparative des médias. Utilisez-la pour construire des tableaux de bord, des outils de recherche ou des applications de veille médiatique.

ENDPOINTS

GET/api/subjects

Lister les sujets

Retourne une liste paginée des sujets analysés avec métadonnées, couverture par pays et scores de divergence.

GET/api/subjects/{slug}

Détail d'un sujet

Retourne un sujet avec toutes ses perspectives, métadonnées et tags.

GET/api/subjects/{slug}/comparison

Données de comparaison

Retourne les données complètes de comparaison incluant scores de divergence, angles morts et méta-analyse.

GET/api/embed/{slug}

Widget intégrable

Retourne un widget HTML autonome pour intégrer des résumés de sujets sur des sites externes.

AUTHENTIFICATION

L'accès à l'API nécessite une authentification via clé API. Incluez votre clé dans le header Authorization.

Authorization: Bearer api_votre_cle_ici

Obtenez votre clé API depuis les paramètres de votre compte, ou contactez-nous pour un accès entreprise.

LIMITES DE DEBIT

FREE

Gratuit : 100 requêtes/jour

PREMIUM

Premium : 1 000 requêtes/jour

ENTERPRISE

Entreprise : Limites personnalisées

Quand la limite est atteinte, l'API retourne HTTP 429 avec l'heure de réinitialisation.

EXEMPLES DE CODE

cURL

curl -H "Authorization: Bearer api_your_key_here" \
  -H "Accept: application/json" \
  https://api.therefract.com/api/subjects

Python

import requests

API_KEY = "api_your_key_here"
BASE_URL = "https://therefract.com/api"

headers = {
    "Authorization": f"Bearer {API_KEY}",
    "Accept": "application/json"
}

# List subjects
response = requests.get(f"{BASE_URL}/subjects", headers=headers)
subjects = response.json()["hydra:member"]

for subject in subjects:
    print(f"{subject['title']} - Divergence: {subject.get('aiDivergenceScore', 'N/A')}%")

# Get comparison data
slug = subjects[0]["slug"]
comparison = requests.get(
    f"{BASE_URL}/subjects/{slug}/comparison",
    headers=headers
).json()

print(f"Divergence score: {comparison['divergenceScore']}%")
print(f"Perspectives: {len(comparison['perspectives'])}")

JavaScript

const API_KEY = "api_your_key_here";
const BASE_URL = "https://therefract.com/api";

const headers = {
  "Authorization": `Bearer ${API_KEY}`,
  "Accept": "application/json"
};

// List subjects
const response = await fetch(`${BASE_URL}/subjects`, { headers });
const data = await response.json();
const subjects = data["hydra:member"];

// Get comparison data for first subject
const slug = subjects[0].slug;
const comparison = await fetch(
  `${BASE_URL}/subjects/${slug}/comparison`,
  { headers }
).then(r => r.json());

console.log(`Divergence: ${comparison.divergenceScore}%`);
console.log(`Countries: ${comparison.perspectives.length}`);

FORMAT DE REPONSE

Toutes les réponses sont en format JSON. Les endpoints de collection utilisent le format de pagination Hydra.

GET /api/subjects

{
  "hydra:member": [
    {
      "id": 1,
      "slug": "us-china-trade-tensions",
      "title": "US-China Trade Tensions Escalate",
      "summary": "...",
      "publishedAt": "2026-03-18T10:00:00+00:00",
      "perspectiveCount": 12,
      "aiDivergenceScore": 78,
      "countries": [
        { "code": "us", "name": "United States", "flag": "..." },
        { "code": "cn", "name": "China", "flag": "..." }
      ]
    }
  ],
  "hydra:totalItems": 150
}

DOCUMENTATION INTERACTIVE

Explorez la spécification complète de l'API avec Swagger UI.

Ouvrir Swagger UI →

OBTENEZ VOTRE CLE API

Prêt à intégrer The Refract dans votre workflow ? Générez une clé API depuis votre compte ou contactez-nous pour un accès entreprise.

MON COMPTE CONTACTEZ-NOUS

import requests API_KEY = "api_your_key_here" BASE_URL = "https://therefract.com/api" headers = { "Authorization": f"Bearer {API_KEY}", "Accept": "application/json" } # List subjects response = requests.get(f"{BASE_URL}/subjects", headers=headers) subjects = response.json()["hydra:member"] for subject in subjects: print(f"{subject['title']} - Divergence: {subject.get('aiDivergenceScore', 'N/A')}%") # Get comparison data slug = subjects[0]["slug"] comparison = requests.get( f"{BASE_URL}/subjects/{slug}/comparison", headers=headers ).json() print(f"Divergence score: {comparison['divergenceScore']}%") print(f"Perspectives: {len(comparison['perspectives'])}")

{ "hydra:member": [ { "id": 1, "slug": "us-china-trade-tensions", "title": "US-China Trade Tensions Escalate", "summary": "...", "publishedAt": "2026-03-18T10:00:00+00:00", "perspectiveCount": 12, "aiDivergenceScore": 78, "countries": [ { "code": "us", "name": "United States", "flag": "..." }, { "code": "cn", "name": "China", "flag": "..." } ] } ], "hydra:totalItems": 150 }