DocumentazioneRiferimento API
Parole chiave
Le parole chiave di un sito: elencarle, aggiungerle, modificarle ed eliminarle.
Ogni operazione qui sotto è anche uno strumento MCP, con lo stesso nome. Le operazioni Gratis non costano nulla; quelle A pagamento usano i crediti dello spazio di lavoro, come nell'app (Quanto costa).
| Operazione | Chiamata | |
|---|---|---|
| Elenca le parole chiave | GET /sites/{siteId}/keywords | Gratis |
| Aggiungi una parola chiave | POST /sites/{siteId}/keywords | Gratis |
| Modifica una parola chiave | PATCH /sites/{siteId}/keywords/{keywordId} | Gratis |
| Elimina una parola chiave | DELETE /sites/{siteId}/keywords/{keywordId} | Gratis |
Elenca le parole chiave
/sites/{siteId}/keywordsGratisLe parole chiave target del sito, trovate dalla sua analisi o aggiunte a mano, con il loro volume, la difficoltà e la posizione attuale.
- Il testo viene restituito così com'è salvato, nella lingua in cui è stato scritto (source_lang; null = la lingua dei contenuti del sito). L'app lo traduce quando lo mostra; l'API no.
Strumento MCP list_keywords
| Argomento | Tipo | Descrizione |
|---|---|---|
siteIdnel percorso | string | Il suo id. |
curl https://app.semchat.io/api/v1/sites/{siteId}/keywords \
-H "Authorization: Bearer sk_live_…"{
"data": [
{
"id": "01a15ea4-c1e0-7957-b667-9b025ed3641e",
"keyword": "agence seo lyon",
"volume": 1900,
"difficulty": 45,
"cpc": 1.8,
"competition": 40,
"current_position": 4,
"traffic": 475,
"url": "https://alpha.example.com/services",
"intent": "commercial",
"priority": "high",
"rationale": "Opportunité sur « agence seo lyon ».",
"source": "auto",
"source_lang": "fr",
"created_at": "2026-10-21T13:26:58.000Z"
},
{
"id": "01a15ea4-c1e0-7e93-9a50-38742b693311",
"keyword": "audit seo",
"volume": 2400,
"difficulty": 60,
"cpc": 1.8,
"competition": 40,
"current_position": 12,
"traffic": 200,
"url": "https://alpha.example.com/services",
"intent": "commercial",
"priority": "high",
"rationale": "Opportunité sur « audit seo ».",
"source": "auto",
"source_lang": "fr",
"created_at": "2026-10-21T13:26:58.000Z"
}
]
}Aggiungi una parola chiave
/sites/{siteId}/keywordsGratisAggiungi una parola chiave target al sito.
- Salvata così come viene fornita, come parola chiave manuale: non viene recuperato nessun dato sulla parola chiave (niente addebito). Risponde con la parola chiave.
Strumento MCP add_keyword
| Argomento | Tipo | Descrizione |
|---|---|---|
siteIdnel percorso | string | Il suo id. |
keywordobbligatorio | string | La parola chiave.1–255 caratteri |
volumefacoltativo | string | null | Il suo volume di ricerca mensile, se lo conosci. |
difficultyfacoltativo | string | null | La sua difficoltà, 0–100, se la conosci. |
intentfacoltativo | string | null | informational, commercial, transactional o navigational. |
priorityfacoltativo | string | high, medium (predefinito) o low.high | medium | low |
rationalefacoltativo | string | null | Perché puntarci. |
source_langfacoltativo | string | La lingua in cui è scritto il testo (per es. "fr", "en"). Se omesso: la lingua dei contenuti del sito.2–5 caratteri |
curl -X POST https://app.semchat.io/api/v1/sites/{siteId}/keywords \
-H "Authorization: Bearer sk_live_…" \
-H "Content-Type: application/json" \
-d '{"keyword": "…"}'Risponde 201 con { "data": … }.
Modifica una parola chiave
/sites/{siteId}/keywords/{keywordId}GratisModifica una parola chiave target: la parola chiave, i suoi dati, l'intento, la priorità o la motivazione.
- Risponde con la parola chiave com'è adesso.
Strumento MCP update_keyword
| Argomento | Tipo | Descrizione |
|---|---|---|
siteIdnel percorso | string | Il suo id. |
keywordIdnel percorso | string | Il suo id. |
keywordfacoltativo | string | 1–255 caratteri |
volumefacoltativo | string | null | |
difficultyfacoltativo | string | null | |
intentfacoltativo | string | null | |
priorityfacoltativo | string | high | medium | low |
rationalefacoltativo | string | null | |
source_langfacoltativo | string | La lingua della nuova parola chiave / della nuova motivazione. Ignorato se nessuna delle due cambia.2–5 caratteri |
curl -X PATCH https://app.semchat.io/api/v1/sites/{siteId}/keywords/{keywordId} \
-H "Authorization: Bearer sk_live_…" \
-H "Content-Type: application/json" \
-d '{"keyword": "…"}'Risponde 200 con { "data": … }.
Elimina una parola chiave
/sites/{siteId}/keywords/{keywordId}GratisRimuovi una parola chiave target dal sito.
Strumento MCP delete_keyword
| Argomento | Tipo | Descrizione |
|---|---|---|
siteIdnel percorso | string | Il suo id. |
keywordIdnel percorso | string | Il suo id. |
curl -X DELETE https://app.semchat.io/api/v1/sites/{siteId}/keywords/{keywordId} \
-H "Authorization: Bearer sk_live_…"Risponde 204 con { "data": … }.
Hai una domanda a cui qui non trovi risposta? Scrivici.

