YepAPI/skills

Workflow zur Konkurrenzforschung

Wettbewerbsanalyse zwischen Domains mithilfe der YepAPI-Endpunkte.

Verwendete Endpunkte

Endpunkt	Kosten	Zweck
POST /v1/seo/domain/overview	0,01 $	Traffic, Keywords, Backlinks, Domain-Rang
POST /v1/seo/competitors	0,04 $	SEO-Konkurrenz-Domains nach Keyword-Überschneidung
POST /v1/seo/keyword-gap	0,04 $	Keyword-Gap-Analyse zwischen zwei Domains

Workflow

Schritt 1: Domain-Übersicht

Führen Sie POST /v1/seo/domain/overview für die Domain des Benutzers aus.

{
  "domain": "example.com"
}

Gibt zurück: organischen Traffic, Gesamt-Keywords, Backlink-Anzahl, Domain-Rang.

Schritt 2: Konkurrenten entdecken

Führen Sie POST /v1/seo/competitors für die Domain des Benutzers aus.

{
  "domain": "example.com"
}

Gibt zurück: Konkurrenz-Domains mit Prozentsatz der Keyword-Überschneidung und Traffic-Schätzungen.

Schritt 3: Top-Konkurrenten vergleichen

Führen Sie für die 2-3 wichtigsten Konkurrenten POST /v1/seo/domain/overview für jeden aus.

{
  "domain": "competitor.com"
}

Vergleichen: Traffic, Keyword-Anzahl, Backlink-Profile, Domain-Rang.

Schritt 4: Keyword-Gap-Analyse

Führen Sie POST /v1/seo/keyword-gap zwischen der Domain des Benutzers und dem Top-Konkurrenten aus.

{
  "domain": "example.com",
  "competitor": "competitor.com"
}

Gibt zurück: Keywords, für die der Konkurrent rankt, der Benutzer jedoch nicht – sortiert nach Volumen und Schwierigkeitsgrad.

Schritt 5: Ergebnisse präsentieren

• Wer insgesamt gewinnt (Traffic, Autorität)
• Wo die Keyword-Lücken sind (hochwertige Begriffe, die dem Benutzer fehlen)
• Was als Nächstes anvisiert werden soll (priorisiert nach Chance: hohes Volumen + niedriger Schwierigkeitsgrad)

Regeln

• Mit der Domain-Übersicht beginnen – günstigste mit 0,01 $, liefert Basismetriken
• Konkurrenz-Tiefenanalysen auf die Top 3 beschränken – Kostenkontrolle
• Keyword-Gap-Analyse ist das am besten umsetzbare Ergebnis – immer einbeziehen

Fehlerbehandlung

• NO_CREDITS (402) – Den Benutzer auffordern, Credits unter https://yepapi.com/dashboard hinzuzufügen
• UPSTREAM_ERROR (502) – Einmal wiederholen; falls erneut fehlschlägt, diesen Schritt überspringen und notieren
• VALIDATION_ERROR (400) – Domain-Format prüfen; nackte Domain ohne Protokoll verwenden
• RATE_LIMITED (429) – Warten und wiederholen; den Retry-After-Header beachten