DocumentationAPI & MCP

Premiers pas

Créer une clé, faire votre premier appel et lire les réponses.

Tout ce que vous faites dans semchat, depuis votre propre code (l'API) ou depuis votre assistant IA (MCP) : vos sites, leur analyse, les plans d'action, les mots-clés, les concurrents, les liens entrants, les documents, les tâches planifiées et le chat de semchat. Les mêmes actions que dans l'app, aux mêmes prix.

Obtenir une clé

  1. 1Ouvrez Paramètres → API & MCPDans votre espace, dans semchat. Seuls le propriétaire et les admins créent et révoquent des clés.
  2. 2Créez une cléDonnez-lui un nom, puis copiez-la : elle ne s'affiche qu'une seule fois.
  3. 3Révoquez-la si elle fuiteRévoquer, dans le même onglet : la clé cesse aussitôt de fonctionner.
Une clé agit sur tout l'espace. Gardez-la sur un serveur, jamais dans un site ou une app publics.
Paramètres › API & MCP : les clés, le serveur MCP et la configuration de chaque assistant

Authentification

Chaque requête porte la clé dans l'en-tête Authorization: Bearer (ou X-API-Key). L'URL de base est https://app.semchat.io/api/v1. Les corps de requête et les réponses sont en JSON.

curl https://app.semchat.io/api/v1/sites \
  -H "Authorization: Bearer sk_live_…"

Sans clé valide, la réponse est un 401 : voir Erreurs et limites.

Un premier site

Créez un site et lancez son analyse dans le même appel. L'analyse est facturée ; needs_credits indique quand les crédits n'ont pas pu la payer.

curl -X POST https://app.semchat.io/api/v1/sites \
  -H "Authorization: Bearer sk_live_…" \
  -H "Content-Type: application/json" \
  -d '{"name": "My shop", "site_url": "https://myshop.com", "auto_analyze": true}'

Lisez ensuite son plan d'action avec Lister le plan d'action, ou interrogez le chat à son sujet avec Envoyer un message dans un site.

Les réponses

  • Une réponse est { "data": … } : un objet, ou une liste avec tous les éléments.
  • Les dates sont au format ISO 8601, en UTC, et les identifiants sont des UUID.
  • Les crédits n'apparaissent jamais en nombres bruts, seulement en part de la période : Récupérer l'espace, Récupérer l'usage.

Ce qu'une clé peut voir

Une clé appartient à un seul espace : elle voit les sites et les conversations de cet espace et rien d'autre, et elle agit avec les droits du membre qui l'a créée.

Le document OpenAPI

Toute la référence au format OpenAPI 3.1, à importer dans Postman, Insomnia ou un générateur de client : openapi.json.

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