DokumentationAPI-Referenz

Wettbewerber

Die Wettbewerber einer Website, ihre Analyse und ihre Backlinks.

Jede Operation unten ist auch ein MCP-Tool mit demselben Namen. Operationen mit Kostenlos kosten nichts; Operationen mit Kostenpflichtig verbrauchen die Credits des Workspaces, wie in der App (Was es kostet).

OperationAufruf
Wettbewerber auflistenGET /sites/{siteId}/competitorsKostenlos
Wettbewerber hinzufügenPOST /sites/{siteId}/competitorsKostenlos
Wettbewerber löschenDELETE /sites/{siteId}/competitors/{competitorId}Kostenlos
Wettbewerber analysierenPOST /sites/{siteId}/competitors/{competitorId}/profileKostenpflichtig
Backlinks eines Wettbewerbers abrufenGET /sites/{siteId}/competitors/{competitorId}/backlinksKostenpflichtig

Wettbewerber auflisten

GET/sites/{siteId}/competitorsKostenlos

Die Wettbewerber der Website, mit ihrem Profil, sobald sie analysiert sind.

MCP-Tool list_competitors

ArgumentTypBeschreibung
siteIdim PfadstringDie ID.
Anfrage
curl https://app.semchat.io/api/v1/sites/{siteId}/competitors \
  -H "Authorization: Bearer sk_live_…"
Antwort · 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
      }
    }
  ]
}

Wettbewerber hinzufügen

POST/sites/{siteId}/competitorsKostenlos

Einen Wettbewerber hinzufügen und auf Wunsch analysieren (kostenpflichtig).

  • Antwortet mit seiner ID und analyzing: false, wenn keine Analyse gestartet wurde (keine angefordert oder keine Credits; der Wettbewerber wird trotzdem gespeichert).

MCP-Tool add_competitor

ArgumentTypBeschreibung
siteIdim PfadstringDie ID.
urlerforderlichstringDie Adresse des Wettbewerbers.1–500 Zeichen
nameoptionalstringbis zu 255 Zeichen
auto_analyzeoptionalbooleanIhn im Hintergrund analysieren (kostenpflichtig). Ohne Credits übersprungen.
Anfrage
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"}'

Antwortet 201 mit { "data": … }.

Wettbewerber löschen

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

Einen Wettbewerber aus den Wettbewerbern der Website entfernen.

MCP-Tool delete_competitor

ArgumentTypBeschreibung
siteIdim PfadstringDie ID.
competitorIdim PfadstringDie ID.
Anfrage
curl -X DELETE https://app.semchat.io/api/v1/sites/{siteId}/competitors/{competitorId} \
  -H "Authorization: Bearer sk_live_…"

Antwortet 204 mit { "data": … }.

Wettbewerber analysieren

POST/sites/{siteId}/competitors/{competitorId}/profileKostenpflichtig

Einen Wettbewerber analysieren (ein flacher Crawl seiner Website und eine KI-Zusammenfassung: was er macht, seine Positionierung, Themen, Stärken, seine Lücken gegenüber Ihrer Website) und das Ergebnis beim Wettbewerber speichern.

  • Abgerechnet wie dieselbe Analyse in der App (ein KI-Aufruf). 402 INSUFFICIENT_TOKENS ohne Credits.
  • Ohne background wartet der Aufruf auf das Profil (bis zu einigen Minuten) und antwortet mit dem Wettbewerber samt Profil.

MCP-Tool profile_competitor

ArgumentTypBeschreibung
siteIdim PfadstringDie ID.
competitorIdim PfadstringDie ID.
backgroundoptionalbooleanSofort antworten (202, status analyzing) und das Profil speichern, sobald es fertig ist: Lesen Sie es mit list_competitors.
localeoptionalstringDie Sprache, in der das Profil geschrieben wird (fr, en, es, de, pt, it). Standard: die Sprache dessen, der den Schlüssel erstellt hat.2–5 Zeichen
Anfrage
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}'

Antwortet 200 mit { "data": … }.

Keine Antwort auf Ihre Frage gefunden? Schreiben Sie uns.

Bereit, Ihrer Website Aufschwung zu geben?

Stellen Sie Ihre erste Frage - semchat antwortet in Sekunden mit einem klaren Aktionsplan.

Kostenlos · ohne Anmeldung · in 5 Sekunden