API REST

Référence API

Accès HTTP direct à toutes les fonctionnalités de Baseline Labs. Authentifiez-vous avec votre clé API et appelez depuis n'importe quel langage.

URL de base

https://baselinelabs.ai/api/

Authentifiez-vous avec l'en-tête X-API-Key: bl_your_key sur chaque requête.

Projets

GET /api/geo/saves

Listez tous vos projets.

{
  "saves": [
    { "id": 42, "name": "My Brand", "url": "https://mybrand.com" }
  ]
}

POST /api/geo/saves

Créez un nouveau projet.

{ "name": "My Brand", "url": "https://mybrand.com" }

Recherche

POST /api/geo/search

Exécutez une recherche sur Google, GPT, Perplexity, Gemini, Google AI Mode, Claude et DeepSeek. Coûte des crédits.

{
  "save_id": 42,
  "queries": ["best project management tools", "top PM software 2026"]
}

Retourne un ID de recherche. Interrogez pour obtenir les résultats :

GET /api/geo/search/{search_id}

Obtenez les résultats de recherche une fois le traitement terminé.

Rapports de visibilité

GET /api/geo/reports/templates

Listez vos modèles de rapport.

POST /api/geo/reports/run

Exécutez un rapport de visibilité à partir d'un modèle. Coûte des crédits.

{ "template_id": 12 }

GET /api/geo/reports/{report_id}

Obtenez les résultats du rapport incluant les classements par requête.

Mentions de marque

POST /api/geo/mentions/scan

Créez une analyse de mention de marque. Coûte des crédits.

{ "save_id": 42, "brand_name": "My Brand" }

GET /api/geo/mentions/{scan_id}

Obtenez les résultats de l'analyse et les enregistrements de mentions individuelles.

Schema.org

POST /api/geo/schema/generate

Générez schema.org JSON-LD pour n'importe quelle URL en utilisant l'inférence GPU.

{ "url": "https://example.com/page" }

Réponse :

{
  "url": "https://example.com/page",
  "schema_url": "https://schema.baselinelabs.ai/abc123.json",
  "cached": true,
  "inference_ms": 12
}

GET /api/geo/schema/status/{job_id}

Vérifiez l'état du travail de génération de schéma asynchrone (pour les travaux >5s).

Réponses d'erreur

Toutes les erreurs retournent du JSON avec un champ detail.

401 Clé API manquante ou invalide

402 Crédits insuffisants

429 Limite de débit dépassée

404 Ressource non trouvée