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

OperazioneChiamata
Elenca i concorrentiGET /sites/{siteId}/competitorsGratis
Aggiungi un concorrentePOST /sites/{siteId}/competitorsGratis
Elimina un concorrenteDELETE /sites/{siteId}/competitors/{competitorId}Gratis
Analizza un concorrentePOST /sites/{siteId}/competitors/{competitorId}/profileA pagamento
Leggi i backlink di un concorrenteGET /sites/{siteId}/competitors/{competitorId}/backlinksA pagamento

Elenca i concorrenti

GET/sites/{siteId}/competitorsGratis

I concorrenti del sito, con il loro profilo una volta analizzati.

Strumento MCP list_competitors

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

POST/sites/{siteId}/competitorsGratis

Aggiungi 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

ArgomentoTipoDescrizione
siteIdnel percorsostringIl suo id.
urlobbligatoriostringL'indirizzo del concorrente.1–500 caratteri
namefacoltativostringfino a 255 caratteri
auto_analyzefacoltativobooleanAnalizzalo in background (a pagamento). Saltato se non ci sono crediti.
Richiesta
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

DELETE/sites/{siteId}/competitors/{competitorId}Gratis

Rimuovi un concorrente da quelli del sito.

Strumento MCP delete_competitor

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

POST/sites/{siteId}/competitors/{competitorId}/profileA pagamento

Analizza 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

ArgomentoTipoDescrizione
siteIdnel percorsostringIl suo id.
competitorIdnel percorsostringIl suo id.
backgroundfacoltativobooleanRisponde subito (202, status analyzing) e salva il profilo quando arriva: leggilo con list_competitors.
localefacoltativostringLa lingua in cui scrivere il profilo (fr, en, es, de, pt, it). Predefinita: quella di chi ha creato la chiave.2–5 caratteri
Richiesta
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": … }.

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