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).
| Operation | Aufruf | |
|---|---|---|
| Wettbewerber auflisten | GET /sites/{siteId}/competitors | Kostenlos |
| Wettbewerber hinzufügen | POST /sites/{siteId}/competitors | Kostenlos |
| Wettbewerber löschen | DELETE /sites/{siteId}/competitors/{competitorId} | Kostenlos |
| Wettbewerber analysieren | POST /sites/{siteId}/competitors/{competitorId}/profile | Kostenpflichtig |
| Backlinks eines Wettbewerbers abrufen | GET /sites/{siteId}/competitors/{competitorId}/backlinks | Kostenpflichtig |
Wettbewerber auflisten
/sites/{siteId}/competitorsKostenlosDie Wettbewerber der Website, mit ihrem Profil, sobald sie analysiert sind.
MCP-Tool list_competitors
| Argument | Typ | Beschreibung |
|---|---|---|
siteIdim Pfad | string | Die 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
}
}
]
}Wettbewerber hinzufügen
/sites/{siteId}/competitorsKostenlosEinen 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
| Argument | Typ | Beschreibung |
|---|---|---|
siteIdim Pfad | string | Die ID. |
urlerforderlich | string | Die Adresse des Wettbewerbers.1–500 Zeichen |
nameoptional | string | bis zu 255 Zeichen |
auto_analyzeoptional | boolean | Ihn im Hintergrund analysieren (kostenpflichtig). Ohne Credits übersprungen. |
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
/sites/{siteId}/competitors/{competitorId}KostenlosEinen Wettbewerber aus den Wettbewerbern der Website entfernen.
MCP-Tool delete_competitor
| Argument | Typ | Beschreibung |
|---|---|---|
siteIdim Pfad | string | Die ID. |
competitorIdim Pfad | string | Die ID. |
curl -X DELETE https://app.semchat.io/api/v1/sites/{siteId}/competitors/{competitorId} \
-H "Authorization: Bearer sk_live_…"Antwortet 204 mit { "data": … }.
Wettbewerber analysieren
/sites/{siteId}/competitors/{competitorId}/profileKostenpflichtigEinen 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
| Argument | Typ | Beschreibung |
|---|---|---|
siteIdim Pfad | string | Die ID. |
competitorIdim Pfad | string | Die ID. |
backgroundoptional | boolean | Sofort antworten (202, status analyzing) und das Profil speichern, sobald es fertig ist: Lesen Sie es mit list_competitors. |
localeoptional | string | Die 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 |
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": … }.
Backlinks eines Wettbewerbers abrufen
/sites/{siteId}/competitors/{competitorId}/backlinksKostenpflichtigDie Backlink-Kennzahlen eines Wettbewerbers: Rang (0–100), verweisende Domains, Backlinks, Spam-Wert.
- Kostenlos, wenn das gespeicherte Backlink-Profil der Website (get_backlinks) diesen Wettbewerber bereits abdeckt; sonst ein kostenpflichtiger Datenaufruf, wie in der App.
- 402 INSUFFICIENT_TOKENS ohne Credits, wenn ein kostenpflichtiger Aufruf nötig wäre.
MCP-Tool get_competitor_backlinks
| Argument | Typ | Beschreibung |
|---|---|---|
siteIdim Pfad | string | Die ID. |
competitorIdim Pfad | string | Die ID. |
curl https://app.semchat.io/api/v1/sites/{siteId}/competitors/{competitorId}/backlinks \
-H "Authorization: Bearer sk_live_…"Antwortet 200 mit { "data": … }.
Keine Antwort auf Ihre Frage gefunden? Schreiben Sie uns.

