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érationAppel
Lister les concurrentsGET /sites/{siteId}/competitorsGratuit
Ajouter un concurrentPOST /sites/{siteId}/competitorsGratuit
Supprimer un concurrentDELETE /sites/{siteId}/competitors/{competitorId}Gratuit
Analyser un concurrentPOST /sites/{siteId}/competitors/{competitorId}/profileFacturé
Récupérer les liens entrants d'un concurrentGET /sites/{siteId}/competitors/{competitorId}/backlinksFacturé

Lister les concurrents

GET/sites/{siteId}/competitorsGratuit

Les concurrents du site, avec leur profil une fois analysés.

Outil MCP list_competitors

ArgumentTypeDescription
siteIddans le cheminstringSon identifiant.
Requête
curl https://app.semchat.io/api/v1/sites/{siteId}/competitors \
  -H "Authorization: Bearer sk_live_…"
Réponse · 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
      }
    }
  ]
}

Ajouter un concurrent

POST/sites/{siteId}/competitorsGratuit

Ajouter 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

ArgumentTypeDescription
siteIddans le cheminstringSon identifiant.
urlobligatoirestringL'adresse du concurrent.1–500 caractères
namefacultatifstringjusqu'à 255 caractères
auto_analyzefacultatifbooleanL'analyser en arrière-plan (facturé). Ignoré sans crédits.
Requête
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

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

Retirer un concurrent de ceux du site.

Outil MCP delete_competitor

ArgumentTypeDescription
siteIddans le cheminstringSon identifiant.
competitorIddans le cheminstringSon identifiant.
Requête
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

POST/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

ArgumentTypeDescription
siteIddans le cheminstringSon identifiant.
competitorIddans le cheminstringSon identifiant.
backgroundfacultatifbooleanRépondre tout de suite (202, statut analyzing) et enregistrer le profil quand il arrive : lisez-le avec list_competitors.
localefacultatifstringLa 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
Requête
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": … }.

Une question sans réponse ici ? Écrivez-nous.

Prêt à faire décoller votre site ?

Posez votre première question - semchat vous répond avec un plan d'action clair, en quelques secondes.

Gratuit · sans inscription · en 5 secondes