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ération | Appel | |
|---|---|---|
| Lister les données du site | GET /sites/{siteId}/data | Gratuit |
| Lister les documents du site | GET /sites/{siteId}/documents | Gratuit |
| Enregistrer un bloc de données | POST /sites/{siteId}/data | Gratuit |
| Supprimer un bloc de données | DELETE /sites/{siteId}/data/{blockId} | Gratuit |
Lister les données du site
/sites/{siteId}/dataGratuitLes blocs de données enregistrés sur le site : graphiques, grilles KPI et cartographies conservés depuis les conversations.
Outil MCP list_site_data
| Argument | Type | Description |
|---|---|---|
siteIddans le chemin | string | Son identifiant. |
curl https://app.semchat.io/api/v1/sites/{siteId}/data \
-H "Authorization: Bearer sk_live_…"{
"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
/sites/{siteId}/documentsGratuitLes documents écrits pour le site (articles, briefs…).
Outil MCP list_site_documents
| Argument | Type | Description |
|---|---|---|
siteIddans le chemin | string | Son identifiant. |
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
/sites/{siteId}/dataGratuitEnregistrer 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
| Argument | Type | Description |
|---|---|---|
siteIddans le chemin | string | Son identifiant. |
typeobligatoire | string | chart ou kpi_grid.chart | kpi_grid |
titleobligatoire | string | 1–500 caractères |
dataobligatoire | object | Les props du graphique ou de la grille KPI, telles que les porte le bloc d'une conversation. |
conversation_idfacultatif | string | La conversation d'où il vient.au moins 1 caractère |
message_idfacultatif | string | Le message d'où il vient : un message enregistre un bloc par titre (409 CONFLICT).au moins 1 caractère |
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
/sites/{siteId}/data/{blockId}GratuitSupprimer un bloc de données enregistré sur le site.
Outil MCP delete_data_block
| Argument | Type | Description |
|---|---|---|
siteIddans le chemin | string | Son identifiant. |
blockIddans le chemin | string | Son identifiant. |
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.

