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).

OperazioneChiamata
Elenca le parole chiaveGET /sites/{siteId}/keywordsGratis
Aggiungi una parola chiavePOST /sites/{siteId}/keywordsGratis
Modifica una parola chiavePATCH /sites/{siteId}/keywords/{keywordId}Gratis
Elimina una parola chiaveDELETE /sites/{siteId}/keywords/{keywordId}Gratis

Elenca le parole chiave

GET/sites/{siteId}/keywordsGratis

Le 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

ArgomentoTipoDescrizione
siteIdnel percorsostringIl suo id.
Richiesta
curl https://app.semchat.io/api/v1/sites/{siteId}/keywords \
  -H "Authorization: Bearer sk_live_…"
Risposta · 200
{
  "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

POST/sites/{siteId}/keywordsGratis

Aggiungi 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

ArgomentoTipoDescrizione
siteIdnel percorsostringIl suo id.
keywordobbligatoriostringLa parola chiave.1–255 caratteri
volumefacoltativostring | nullIl suo volume di ricerca mensile, se lo conosci.
difficultyfacoltativostring | nullLa sua difficoltà, 0–100, se la conosci.
intentfacoltativostring | nullinformational, commercial, transactional o navigational.
priorityfacoltativostringhigh, medium (predefinito) o low.high | medium | low
rationalefacoltativostring | nullPerché puntarci.
source_langfacoltativostringLa lingua in cui è scritto il testo (per es. "fr", "en"). Se omesso: la lingua dei contenuti del sito.2–5 caratteri
Richiesta
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

PATCH/sites/{siteId}/keywords/{keywordId}Gratis

Modifica 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

ArgomentoTipoDescrizione
siteIdnel percorsostringIl suo id.
keywordIdnel percorsostringIl suo id.
keywordfacoltativostring1–255 caratteri
volumefacoltativostring | null
difficultyfacoltativostring | null
intentfacoltativostring | null
priorityfacoltativostringhigh | medium | low
rationalefacoltativostring | null
source_langfacoltativostringLa lingua della nuova parola chiave / della nuova motivazione. Ignorato se nessuna delle due cambia.2–5 caratteri
Richiesta
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

DELETE/sites/{siteId}/keywords/{keywordId}Gratis

Rimuovi una parola chiave target dal sito.

Strumento MCP delete_keyword

ArgomentoTipoDescrizione
siteIdnel percorsostringIl suo id.
keywordIdnel percorsostringIl suo id.
Richiesta
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.

Pronto a far decollare il tuo sito?

Fai la tua prima domanda - semchat ti risponde con un piano d'azione chiaro in pochi secondi.

Gratis · senza registrazione · in 5 secondi