Développeurs

Référence de l’API

Auditez n’importe quelle URL, récupérez scores et anomalies, et suivez les citations par programmation. L’API SearchAudit est disponible sur l’offre Agency.

Introduction

L’API est organisée autour de REST. Toutes les requêtes utilisent HTTPS et renvoient du JSON. L’URL de base est :

bash

https://searchaudit.io/api/v1

Authentification

Authentifiez-vous avec un jeton bearer. Créez des clés API dans Réglages → API. Gardez-les secrètes — ne les committez jamais dans le code source.

bash

curl https://searchaudit.io/api/v1/audits \
  -H "Authorization: Bearer sa_live_••••••••"

Lancer un audit

POST/api/v1/audits

Soumettez une URL à auditer. Renvoie un objet audit avec un score et des anomalies détaillées une fois l’analyse terminée (généralement en moins de 60 secondes).

bash

curl -X POST https://searchaudit.io/api/v1/audits \
  -H "Authorization: Bearer sa_live_••••••••" \
  -H "Content-Type: application/json" \
  -d '{"url": "acme.lovable.app"}'

json · 201 Created

{
  "audit": {
    "id": "3f2b9c14-8d5e-4a71-b0c9-2e6f7a1d4b83",
    "url": "acme.lovable.app",
    "builder": "Lovable",
    "score": 31,
    "status": "complete",
    "category_scores": [{ "name": "Crawlability", "score": 18 }],
    "scanned_at": "2026-06-18T12:00:00Z",
    "issues": [
      { "severity": "critical", "category": "Crawlability",
        "title": "No server-rendered content detected",
        "detail": "AI crawlers receive an empty HTML shell.", "position": 0 }
    ]
  }
}

Récupérer un audit

GET/api/v1/audits/{id}

Récupérez un audit déjà exécuté, avec la ventilation complète par catégorie et chaque anomalie.

bash

curl https://searchaudit.io/api/v1/audits/3f2b9c14-8d5e-4a71-b0c9-2e6f7a1d4b83 \
  -H "Authorization: Bearer sa_live_••••••••"

Suivi des citations

GET/api/v1/citations

Renvoie les résultats de citation pour vos prompts suivis sur ChatGPT, Perplexity, Gemini, Claude et les AI Overviews de Google.

json

{
  "prompt": "best AC repair near Bangkok",
  "engine": "ChatGPT",
  "cited": true,
  "checked_at": "2026-06-07T09:14:00Z"
}

Erreurs et limites de débit

L’API utilise des codes de statut HTTP standard. 429 indique que vous avez dépassé la limite de 10 audits par minute.

json

{
  "error": "Rate limit: max 10 audits per minute."
}