DocumentationRéférence de l'API
Concurrents
Les concurrents d'un site, leur analyse et leurs liens entrants.
Chaque opération ci-dessous est aussi un outil MCP, sous le même nom. Les opérations marquées Gratuit ne coûtent rien ; celles marquées Facturé utilisent les crédits de l'espace, comme dans l'app (Ce que ça coûte).
| Opération | Appel | |
|---|---|---|
| Lister les concurrents | GET /sites/{siteId}/competitors | Gratuit |
| Ajouter un concurrent | POST /sites/{siteId}/competitors | Gratuit |
| Supprimer un concurrent | DELETE /sites/{siteId}/competitors/{competitorId} | Gratuit |
| Analyser un concurrent | POST /sites/{siteId}/competitors/{competitorId}/profile | Facturé |
| Récupérer les liens entrants d'un concurrent | GET /sites/{siteId}/competitors/{competitorId}/backlinks | Facturé |
Lister les concurrents
/sites/{siteId}/competitorsGratuitLes concurrents du site, avec leur profil une fois analysés.
Outil MCP list_competitors
| Argument | Type | Description |
|---|---|---|
siteIddans le chemin | string | Son identifiant. |
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
}
}
]
}Ajouter un concurrent
/sites/{siteId}/competitorsGratuitAjouter un concurrent, et l'analyser si vous le souhaitez (facturé).
- Renvoie son id, avec
analyzingà false quand aucune analyse n'a été lancée (aucune demandée, ou pas de crédits ; le concurrent est enregistré quand même).
Outil MCP add_competitor
| Argument | Type | Description |
|---|---|---|
siteIddans le chemin | string | Son identifiant. |
urlobligatoire | string | L'adresse du concurrent.1–500 caractères |
namefacultatif | string | jusqu'à 255 caractères |
auto_analyzefacultatif | boolean | L'analyser en arrière-plan (facturé). Ignoré sans crédits. |
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"}'Répond 201 avec { "data": … }.
Supprimer un concurrent
/sites/{siteId}/competitors/{competitorId}GratuitRetirer un concurrent de ceux du site.
Outil MCP delete_competitor
| Argument | Type | Description |
|---|---|---|
siteIddans le chemin | string | Son identifiant. |
competitorIddans le chemin | string | Son identifiant. |
curl -X DELETE https://app.semchat.io/api/v1/sites/{siteId}/competitors/{competitorId} \
-H "Authorization: Bearer sk_live_…"Répond 204 avec { "data": … }.
Analyser un concurrent
/sites/{siteId}/competitors/{competitorId}/profileFacturéAnalyser un concurrent (une exploration légère de son site et un résumé par l'IA : ce qu'il fait, son positionnement, ses sujets, ses forces, ses manques face à votre site) et l'enregistrer sur le concurrent.
- Facturé comme la même analyse dans l'app (un appel à l'IA). 402 INSUFFICIENT_TOKENS sans crédits.
- Sans background, attend le profil (jusqu'à quelques minutes) et renvoie le concurrent avec son profil.
Outil MCP profile_competitor
| Argument | Type | Description |
|---|---|---|
siteIddans le chemin | string | Son identifiant. |
competitorIddans le chemin | string | Son identifiant. |
backgroundfacultatif | boolean | Répondre tout de suite (202, statut analyzing) et enregistrer le profil quand il arrive : lisez-le avec list_competitors. |
localefacultatif | string | La langue dans laquelle écrire le profil (fr, en, es, de, pt, it). Par défaut : celle du créateur de la clé.2–5 caractères |
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}'Répond 200 avec { "data": … }.
Récupérer les liens entrants d'un concurrent
/sites/{siteId}/competitors/{competitorId}/backlinksFacturéLes chiffres de liens entrants d'un concurrent : rang (0–100), domaines référents, backlinks, score de spam.
- Gratuit quand le profil de liens entrants enregistré du site (get_backlinks) couvre déjà ce concurrent ; sinon, un appel de données facturé, comme dans l'app.
- 402 INSUFFICIENT_TOKENS sans crédits quand un appel facturé serait nécessaire.
Outil MCP get_competitor_backlinks
| Argument | Type | Description |
|---|---|---|
siteIddans le chemin | string | Son identifiant. |
competitorIddans le chemin | string | Son identifiant. |
curl https://app.semchat.io/api/v1/sites/{siteId}/competitors/{competitorId}/backlinks \
-H "Authorization: Bearer sk_live_…"Répond 200 avec { "data": … }.
Une question sans réponse ici ? Écrivez-nous.

