DocumentationRéférence de l'API

Sites

Les sites, leur analyse, leur santé et leur accessibilité.

Chaque opération ci-dessous est aussi un outil MCP, sous le même nom. Les opérations marquées Gratuit ne coûtent rien ; celles marquées Facturé utilisent les crédits de l'espace, comme dans l'app (Ce que ça coûte).

OpérationAppel
Lister les sitesGET /sitesGratuit
Créer un sitePOST /sitesGratuit
Récupérer un siteGET /sites/{siteId}Gratuit
Analyser un sitePOST /sites/{siteId}/analyzeFacturé
Lister les connecteurs du siteGET /sites/{siteId}/connectorsGratuit
Modifier un sitePATCH /sites/{siteId}Gratuit
Supprimer un siteDELETE /sites/{siteId}Gratuit
Mettre un site en favoriPATCH /sites/{siteId}/favoriteGratuit
Récupérer la santé du siteGET /sites/{siteId}/healthGratuit
Récupérer l'accessibilité du siteGET /sites/{siteId}/accessibilityGratuit
Récupérer une règle d'accessibilitéGET /sites/{siteId}/accessibility/{ruleId}Gratuit

Lister les sites

GET/sitesGratuit

Tous les sites de l'espace.

Outil MCP list_sites

Requête
curl https://app.semchat.io/api/v1/sites \
  -H "Authorization: Bearer sk_live_…"
Réponse · 200
{
  "data": [
    {
      "id": "01a08133-4de0-7b5b-87f5-c4c169f01517",
      "name": "Alpha Conseil",
      "site_url": "https://alpha.example.com",
      "analysis_status": "ready",
      "created_at": "2026-09-08T13:26:58.000Z"
    },
    {
      "id": "01a0ce72-b1e0-738d-9205-34630681ef77",
      "name": "Beta Shop",
      "site_url": "https://beta.example.com",
      "analysis_status": "idle",
      "created_at": "2026-09-23T13:26:58.000Z"
    }
  ]
}

Créer un site

POST/sitesGratuit

Créer un site, et lancer son analyse si vous le souhaitez.

Outil MCP create_site

ArgumentTypeDescription
nameobligatoirestringLe nom du site.1–255 caractères
site_urlfacultatifstringSon adresse. Nécessaire pour une analyse.jusqu'à 500 caractères
descriptionfacultatifstringjusqu'à 2000 caractères
auto_analyzefacultatifbooleanLancer l'analyse tout de suite (facturée). Ignoré sans crédits : needs_credits vaut alors true.
Requête
curl -X POST https://app.semchat.io/api/v1/sites \
  -H "Authorization: Bearer sk_live_…" \
  -H "Content-Type: application/json" \
  -d '{"name": "…"}'
Réponse · 201
{
  "data": {
    "id": "01a168f1-9d83-7253-a7ec-af716d6279e1",
    "analysis_status": "idle",
    "needs_credits": false
  }
}

Récupérer un site

GET/sites/{siteId}Gratuit

Un site, avec tout ce que sa dernière analyse a enregistré (vue d'ensemble, santé, accessibilité, mots-clés…).

Outil MCP get_site

ArgumentTypeDescription
siteIddans le cheminstringSon identifiant.
Requête
curl https://app.semchat.io/api/v1/sites/{siteId} \
  -H "Authorization: Bearer sk_live_…"
Réponse · 200
{
  "data": {
    "id": "01a08133-4de0-7b5b-87f5-c4c169f01517",
    "name": "Alpha Conseil",
    "site_url": "https://alpha.example.com",
    "description": null,
    "analysis_status": "ready",
    "analysis_stage": null,
    "last_analyzed_at": "2026-10-21T13:26:58.000Z",
    "site_context": {
      "description": "Alpha Conseil, agence de référencement naturel pour les PME lyonnaises.",
      "platform": "inconnu",
      "language": "fr",
      "country": "FR",
      "positioning": "Le SEO durable et expliqué sans jargon pour les PME.",
      "primaryTopics": [
        "audit SEO",
        "contenus"
      ],
      "targetKeywords": [
        "…",
        "…"
      ],
      "kpis": {
        "organic_traffic_estimate": 1840,
        "keywords_count": 312,
        "authority_score": null
      },
      "suggestedInstructions": "Parle simplement à des dirigeants de PME non techniques.",
      "analyzedAt": "2026-10-21T13:26:58.272Z",
      "contentLang": "fr",
      "health": {
        "score": 72,
        "label": "good",
        "pagesChecked": 6,
        "items": [
          "…",
          "…"
        ],
        "checkedAt": "2026-10-21T13:26:58.272Z"
      },
      "accessibility": {
        "score": 78,
        "totalIssues": 4,
        "byLevel": "…",
        "findings": [
          "…",
          "…"
        ],
        "checkedAt": "2026-10-21T13:26:58.272Z"
      },
      "pageVisibility": {
        "checkedPages": 6,
        "indexable": 6,
        "noindex": 0,
        "visibleButShouldnt": "…",
        "hiddenButShould": "…",
        "checkedAt": "2026-10-21T13:26:58.272Z"
      },
      "actionPlan": {
        "scorecard": "…",
        "focus": "…",
        "priorityOrder": [
          "content",
          "backlinks"
        ],
        "summary": "Un site sain qui manque de contenus et de liens.",
        "generatedAt": "2026-10-21T13:26:58.272Z"
      }
    },
    "instructions": null,
    "writing_style": null,
    "technologies": [],
    "favorite": false,
    "created_at": "2026-09-08T13:26:58.000Z"
  }
}

Analyser un site

POST/sites/{siteId}/analyzeFacturé

Lancer (ou relancer) l'analyse complète du site : exploration, santé technique, concurrents, mots-clés, plan d'action.

  • S'exécute en arrière-plan (quelques minutes) : lisez get_site jusqu'à ce que analysis_status vaille ready ou error.
  • Facturée exactement comme une analyse lancée dans l'app. 402 INSUFFICIENT_TOKENS sans crédits.
  • Une nouvelle analyse garde le plan d'action existant et y ajoute ce qui est nouveau.

Outil MCP analyze_site

ArgumentTypeDescription
siteIddans le cheminstringSon identifiant.
Requête
curl -X POST https://app.semchat.io/api/v1/sites/{siteId}/analyze \
  -H "Authorization: Bearer sk_live_…"

Répond 202 avec { "data": … }.

Lister les connecteurs du site

GET/sites/{siteId}/connectorsGratuit

Les outils connectés à ce site.

Outil MCP list_site_connectors

ArgumentTypeDescription
siteIddans le cheminstringSon identifiant.
Requête
curl https://app.semchat.io/api/v1/sites/{siteId}/connectors \
  -H "Authorization: Bearer sk_live_…"

Répond 200 avec { "data": … }.

Modifier un site

PATCH/sites/{siteId}Gratuit

Modifier les réglages du site : nom, adresse, description, instructions, style de rédaction, technologies.

  • Seuls les champs fournis changent. Renvoie le site avec ses réglages.
  • Changer l'adresse ne relance pas l'analyse : appelez analyze_site pour cela.

Outil MCP update_site

ArgumentTypeDescription
siteIddans le cheminstringSon identifiant.
namefacultatifstringLe nom du site (ne peut pas être vide).1–255 caractères
site_urlfacultatifstring | nullSon adresse. Vide ou null l'efface.
descriptionfacultatifstring | nullVide ou null l'efface.
instructionsfacultatifstring | nullCe que l'assistant garde en tête pour ce site. Vide ou null les efface.
writing_stylefacultatifstring | nullLa voix des articles écrits pour le site ; null l'efface.
technologiesfacultatifarrayLes technologies sur lesquelles tourne le site (leurs clés) ; [] les efface.
Requête
curl -X PATCH https://app.semchat.io/api/v1/sites/{siteId} \
  -H "Authorization: Bearer sk_live_…" \
  -H "Content-Type: application/json" \
  -d '{"name": "…"}'

Répond 200 avec { "data": … }.

Supprimer un site

DELETE/sites/{siteId}Gratuit

Supprimer le site.

  • Suppression douce, comme dans l'app : le site quitte les listes et ses routes répondent 404. Rien d'autre ne change : ses conversations, ses documents et ses données enregistrées sont conservés.

Outil MCP delete_site

ArgumentTypeDescription
siteIddans le cheminstringSon identifiant.
Requête
curl -X DELETE https://app.semchat.io/api/v1/sites/{siteId} \
  -H "Authorization: Bearer sk_live_…"

Répond 200 avec { "data": … }.

Mettre un site en favori

PATCH/sites/{siteId}/favoriteGratuit

Ajouter le site aux favoris, ou l'en retirer.

  • Mettre en favori ne compte pas comme une activité : le site garde sa place dans le tri « Activité ».

Outil MCP set_site_favorite

ArgumentTypeDescription
siteIddans le cheminstringSon identifiant.
favoriteobligatoirebooleantrue ajoute le site aux favoris, false l'en retire.
Requête
curl -X PATCH https://app.semchat.io/api/v1/sites/{siteId}/favorite \
  -H "Authorization: Bearer sk_live_…" \
  -H "Content-Type: application/json" \
  -d '{"favorite": true}'

Répond 200 avec { "data": … }.

Récupérer la santé du site

GET/sites/{siteId}/healthGratuit

La santé technique du site : le score et les problèmes de la dernière analyse, l'historique du score, et les nombres de problèmes qui ont changé depuis l'analyse précédente.

Outil MCP get_site_health

ArgumentTypeDescription
siteIddans le cheminstringSon identifiant.
Requête
curl https://app.semchat.io/api/v1/sites/{siteId}/health \
  -H "Authorization: Bearer sk_live_…"
Réponse · 200
{
  "data": {
    "health": {
      "score": 72,
      "label": "good",
      "pages_checked": 6,
      "items": [
        "…",
        "…"
      ],
      "checked_at": "2026-10-21T13:26:58.272Z"
    },
    "history": [
      {
        "score": 61,
        "label": "fair",
        "pages_checked": 6,
        "analyzed_at": "2026-09-23T13:26:58.000Z"
      },
      {
        "score": 72,
        "label": "good",
        "pages_checked": 6,
        "analyzed_at": "2026-10-21T13:26:58.000Z"
      }
    ],
    "changes": [
      {
        "key": "noDescription",
        "before": 3,
        "after": 1
      },
      {
        "key": "thin",
        "before": 3,
        "after": 2
      }
    ]
  }
}

Récupérer l'accessibilité du site

GET/sites/{siteId}/accessibilityGratuit

L'accessibilité du site (WCAG 2.1 A et AA) : le score et les constats par règle de la dernière analyse, et l'historique du score.

Outil MCP get_site_accessibility

ArgumentTypeDescription
siteIddans le cheminstringSon identifiant.
Requête
curl https://app.semchat.io/api/v1/sites/{siteId}/accessibility \
  -H "Authorization: Bearer sk_live_…"

Répond 200 avec { "data": … }.

Récupérer une règle d'accessibilité

GET/sites/{siteId}/accessibility/{ruleId}Gratuit

Toutes les pages où une règle d'accessibilité échoue (le rule_id d'un constat), avec les éléments en défaut.

  • pages est plafonné ; page_count est le nombre exact de pages concernées.

Outil MCP get_accessibility_rule

ArgumentTypeDescription
siteIddans le cheminstringSon identifiant.
ruleIddans le cheminstringSon identifiant.
Requête
curl https://app.semchat.io/api/v1/sites/{siteId}/accessibility/{ruleId} \
  -H "Authorization: Bearer sk_live_…"

Répond 200 avec { "data": … }.

Une question sans réponse ici ? Écrivez-nous.

Prêt à faire décoller votre site ?

Posez votre première question - semchat vous répond avec un plan d'action clair, en quelques secondes.

Gratuit · sans inscription · en 5 secondes