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://api.searchaudit.io/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://api.searchaudit.io/v1/audits \
  -H "Authorization: Bearer sk_live_••••••••"

Lancer un audit

POST/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://api.searchaudit.io/v1/audits \
  -H "Authorization: Bearer sk_live_••••••••" \
  -d url="acme.lovable.app"

json

{
  "id": "aud_7Hx2",
  "url": "acme.lovable.app",
  "status": "complete",
  "score": 31,
  "builder": "Lovable",
  "issues": [
    { "severity": "critical", "category": "Crawlability",
      "title": "No server-rendered content detected" }
  ]
}

Récupérer un audit

GET/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://api.searchaudit.io/v1/audits/aud_7Hx2 \
  -H "Authorization: Bearer sk_live_••••••••"

Suivi des citations

GET/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é votre limite de 600 requêtes/minute sur Agency.

json

{
  "error": { "type": "rate_limit_exceeded",
             "message": "Too many requests. Retry after 30s." }
}