DocumentazioneRiferimento API
Concorrenti
I concorrenti di un sito, la loro analisi e i loro backlink.
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 i concorrenti | GET /sites/{siteId}/competitors | Gratis |
| Aggiungi un concorrente | POST /sites/{siteId}/competitors | Gratis |
| Elimina un concorrente | DELETE /sites/{siteId}/competitors/{competitorId} | Gratis |
| Analizza un concorrente | POST /sites/{siteId}/competitors/{competitorId}/profile | A pagamento |
| Leggi i backlink di un concorrente | GET /sites/{siteId}/competitors/{competitorId}/backlinks | A pagamento |
Elenca i concorrenti
/sites/{siteId}/competitorsGratisI concorrenti del sito, con il loro profilo una volta analizzati.
Strumento MCP list_competitors
| Argomento | Tipo | Descrizione |
|---|---|---|
siteIdnel percorso | string | Il suo id. |
curl https://app.semchat.io/api/v1/sites/{siteId}/competitors \
-H "Authorization: Bearer sk_live_…"{
"data": [
{
"id": "01a15ea4-c1e0-7285-bdde-d36e70d2d1b9",
"url": "https://comp1.example.com",
"name": "Concurrent Un",
"source": "auto",
"profiled_at": "2026-10-21T13:26:58.000Z",
"metrics": {
"traffic": 5200,
"keywords": 400,
"overlap": 40,
"reason": "Mêmes mots-clés à Lyon."
},
"profile": {
"summary": "Concurrent Un accompagne les PME.",
"positioning": "Agence généraliste.",
"topics": [
"SEO",
"SEA"
],
"strengths": [
"Notoriété"
],
"tech": [
"wordpress"
],
"pageCount": 24
}
},
{
"id": "01a15ea4-c1e0-7042-931d-3fa2cb1f4ffc",
"url": "https://comp2.example.com",
"name": "Concurrent Deux",
"source": "auto",
"profiled_at": "2026-10-21T13:26:58.000Z",
"metrics": {
"traffic": 4200,
"keywords": 350,
"overlap": 30,
"reason": "Mêmes mots-clés à Lyon."
},
"profile": {
"summary": "Concurrent Deux accompagne les PME.",
"positioning": "Agence généraliste.",
"topics": [
"SEO",
"SEA"
],
"strengths": [
"Notoriété"
],
"tech": [
"wordpress"
],
"pageCount": 24
}
}
]
}Aggiungi un concorrente
/sites/{siteId}/competitorsGratisAggiungi un concorrente e, se vuoi, analizzalo (a pagamento).
- Risponde con il suo id e
analyzing: false quando non è stata avviata nessuna analisi (non richiesta, o niente crediti; il concorrente viene salvato comunque).
Strumento MCP add_competitor
| Argomento | Tipo | Descrizione |
|---|---|---|
siteIdnel percorso | string | Il suo id. |
urlobbligatorio | string | L'indirizzo del concorrente.1–500 caratteri |
namefacoltativo | string | fino a 255 caratteri |
auto_analyzefacoltativo | boolean | Analizzalo in background (a pagamento). Saltato se non ci sono crediti. |
curl -X POST https://app.semchat.io/api/v1/sites/{siteId}/competitors \
-H "Authorization: Bearer sk_live_…" \
-H "Content-Type: application/json" \
-d '{"url": "https://example.com"}'Risponde 201 con { "data": … }.
Elimina un concorrente
/sites/{siteId}/competitors/{competitorId}GratisRimuovi un concorrente da quelli del sito.
Strumento MCP delete_competitor
| Argomento | Tipo | Descrizione |
|---|---|---|
siteIdnel percorso | string | Il suo id. |
competitorIdnel percorso | string | Il suo id. |
curl -X DELETE https://app.semchat.io/api/v1/sites/{siteId}/competitors/{competitorId} \
-H "Authorization: Bearer sk_live_…"Risponde 204 con { "data": … }.
Analizza un concorrente
/sites/{siteId}/competitors/{competitorId}/profileA pagamentoAnalizza un concorrente (una scansione leggera del suo sito e un riepilogo IA: cosa fa, il suo posizionamento, gli argomenti, i punti di forza, le sue lacune rispetto al tuo sito) e salva il risultato sul concorrente.
- Addebitata come la stessa analisi nell'app (una chiamata IA). 402 INSUFFICIENT_TOKENS se non ci sono crediti.
- Senza background, aspetta il profilo (fino a qualche minuto) e risponde con il concorrente e il suo profilo.
Strumento MCP profile_competitor
| Argomento | Tipo | Descrizione |
|---|---|---|
siteIdnel percorso | string | Il suo id. |
competitorIdnel percorso | string | Il suo id. |
backgroundfacoltativo | boolean | Risponde subito (202, status analyzing) e salva il profilo quando arriva: leggilo con list_competitors. |
localefacoltativo | string | La lingua in cui scrivere il profilo (fr, en, es, de, pt, it). Predefinita: quella di chi ha creato la chiave.2–5 caratteri |
curl -X POST https://app.semchat.io/api/v1/sites/{siteId}/competitors/{competitorId}/profile \
-H "Authorization: Bearer sk_live_…" \
-H "Content-Type: application/json" \
-d '{"background": true}'Risponde 200 con { "data": … }.
Leggi i backlink di un concorrente
/sites/{siteId}/competitors/{competitorId}/backlinksA pagamentoI numeri dei backlink di un concorrente: rank (0–100), domini referenti, backlink, punteggio spam.
- Gratis quando il profilo backlink salvato del sito (get_backlinks) copre già questo concorrente; altrimenti una chiamata dati a pagamento, come nell'app.
- 402 INSUFFICIENT_TOKENS se non ci sono crediti quando servirebbe una chiamata a pagamento.
Strumento MCP get_competitor_backlinks
| Argomento | Tipo | Descrizione |
|---|---|---|
siteIdnel percorso | string | Il suo id. |
competitorIdnel percorso | string | Il suo id. |
curl https://app.semchat.io/api/v1/sites/{siteId}/competitors/{competitorId}/backlinks \
-H "Authorization: Bearer sk_live_…"Risponde 200 con { "data": … }.
Hai una domanda a cui qui non trovi risposta? Scrivici.

