DocumentationRéférence de l'API

Données et documents

Les graphiques, les grilles KPI et les documents enregistrés d'un site.

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 données du siteGET /sites/{siteId}/dataGratuit
Lister les documents du siteGET /sites/{siteId}/documentsGratuit
Enregistrer un bloc de donnéesPOST /sites/{siteId}/dataGratuit
Supprimer un bloc de donnéesDELETE /sites/{siteId}/data/{blockId}Gratuit

Lister les données du site

GET/sites/{siteId}/dataGratuit

Les blocs de données enregistrés sur le site : graphiques, grilles KPI et cartographies conservés depuis les conversations.

Outil MCP list_site_data

ArgumentTypeDescription
siteIddans le cheminstringSon identifiant.
Requête
curl https://app.semchat.io/api/v1/sites/{siteId}/data \
  -H "Authorization: Bearer sk_live_…"
Réponse · 200
{
  "data": [
    {
      "id": "01a15ea4-c1e0-7157-becb-0b33c960722e",
      "type": "kpi_grid",
      "title": "Vue d'ensemble - alpha",
      "data": {
        "title": "Vue d'ensemble - alpha",
        "cards": [
          "…",
          "…"
        ]
      },
      "conversation_id": "01a1597c-9120-70b0-87de-f58bf6fe953e",
      "created_at": "2026-10-18T13:26:58.000Z"
    },
    {
      "id": "01a15ea4-c1e0-730a-a3c7-1cf43b1cd203",
      "type": "chart",
      "title": "Trafic organique - alpha vs concurrents",
      "data": {
        "title": "Trafic organique - alpha vs concurrents",
        "type": "bar",
        "x_key": "domain",
        "y_keys": [
          "trafic"
        ],
        "data": [
          "…",
          "…"
        ],
        "format": "number",
        "unit": "visites/mois"
      },
      "conversation_id": "01a15456-3520-7443-9b04-564ff63c5448",
      "created_at": "2026-10-17T13:26:58.000Z"
    }
  ]
}

Lister les documents du site

GET/sites/{siteId}/documentsGratuit

Les documents écrits pour le site (articles, briefs…).

Outil MCP list_site_documents

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

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

Enregistrer un bloc de données

POST/sites/{siteId}/dataGratuit

Enregistrer un graphique ou une grille KPI sur le site (comme le bouton Sauvegarder d'un graphique dans une conversation de l'app).

Outil MCP save_data_block

ArgumentTypeDescription
siteIddans le cheminstringSon identifiant.
typeobligatoirestringchart ou kpi_grid.chart | kpi_grid
titleobligatoirestring1–500 caractères
dataobligatoireobjectLes props du graphique ou de la grille KPI, telles que les porte le bloc d'une conversation.
conversation_idfacultatifstringLa conversation d'où il vient.au moins 1 caractère
message_idfacultatifstringLe message d'où il vient : un message enregistre un bloc par titre (409 CONFLICT).au moins 1 caractère
Requête
curl -X POST https://app.semchat.io/api/v1/sites/{siteId}/data \
  -H "Authorization: Bearer sk_live_…" \
  -H "Content-Type: application/json" \
  -d '{"type": "chart", "title": "…", "data": {}}'

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

Supprimer un bloc de données

DELETE/sites/{siteId}/data/{blockId}Gratuit

Supprimer un bloc de données enregistré sur le site.

Outil MCP delete_data_block

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

Répond 204 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