DocumentazioneAPI e MCP
Primi passi
Crea una chiave, fai la tua prima chiamata e leggi le risposte.
Tutto quello che fai in semchat, dal tuo codice (l'API) o dal tuo assistente IA (MCP): i tuoi siti, la loro analisi, i piani d'azione, le parole chiave, i concorrenti, i backlink, i documenti, le attività pianificate e la chat di semchat. Le stesse azioni dell'app, agli stessi prezzi.
Ottenere una chiave
- 1Apri Impostazioni → API e MCPNel tuo spazio di lavoro, in semchat. Solo il proprietario e gli amministratori creano e revocano le chiavi.
- 2Crea una chiaveDalle un nome, poi copiala: viene mostrata una sola volta.
- 3Revocala se finisce in mani sbagliateRevoca, nella stessa scheda: la chiave smette subito di funzionare.
Autenticazione
Ogni richiesta porta la chiave nell'header Authorization: Bearer (oppure X-API-Key). L'URL di base è https://app.semchat.io/api/v1. I corpi delle richieste e le risposte sono in JSON.
curl https://app.semchat.io/api/v1/sites \
-H "Authorization: Bearer sk_live_…"Senza una chiave valida, la risposta è un 401: vedi Errori e limiti.
Un primo sito
Crea un sito e avvia la sua analisi con la stessa chiamata. L'analisi è a pagamento; needs_credits ti dice quando i crediti non sono bastati a pagarla.
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}'Poi leggi il suo piano d'azione con Elenca le attività, oppure fai domande alla chat con Invia un messaggio nel sito.
Le risposte
- Una risposta è
{ "data": … }: un oggetto, oppure un elenco con tutti gli elementi. - Le date sono in ISO 8601 in UTC, e gli id sono UUID.
- I crediti non compaiono mai come numeri grezzi, solo come quota del periodo: Leggi lo spazio di lavoro, Leggi l'utilizzo.
Cosa vede una chiave
Una chiave appartiene a un solo spazio di lavoro: vede i siti e le conversazioni di quello spazio e nient'altro, e agisce con i diritti del membro che l'ha creata.
Il documento OpenAPI
Tutto il riferimento in OpenAPI 3.1, da importare in Postman, Insomnia o in un generatore di client: openapi.json.
Hai una domanda a cui qui non trovi risposta? Scrivici.

