YepAPI/skills – Keyword-Recherche-Workflow

Keyword-Recherche-Workflow

Dedizierter Keyword-Recherche-Workflow – entdecke, bewerte und priorisiere Keywords mittels YepAPI-Endpunkten.

Verwendete Endpunkte

Endpunkt	Kosten	Zweck
POST /v1/seo/keywords/ideas	$0.03	Keyword-Vorschläge auf Basis eines Seed-Keywords
POST /v1/seo/keywords/related	$0.03	Verwandte Keywords zu einem Seed-Keyword
POST /v1/seo/keywords	$0.15	Bulk-Keyword-Metriken (Volumen, CPC, Schwierigkeit, Absicht)
POST /v1/seo/keyword-gap	$0.04	Keyword-Gap-Analyse zwischen zwei Domains

Workflow

Schritt 1: Keyword-Ideen generieren

Beginne mit einem Seed-Keyword. Führe POST /v1/seo/keywords/ideas aus.

{
  "keyword": "Projektmanagement",
  "location": "de"
}

Ergebnis: Keyword-Vorschläge basierend auf dem Seed – inhaltliche Ansätze und Long-Tail-Varianten.

Schritt 2: Verwandte Keywords finden

Erweitere mit POST /v1/seo/keywords/related.

{
  "keyword": "Projektmanagement",
  "location": "de"
}

Ergebnis: Semantisch verwandte Begriffe – breitere und spezifischere Varianten.

Schritt 3: Keyword-Metriken bewerten

Führe POST /v1/seo/keywords mit allen Kandidaten-Keywords aus.

{
  "keywords": ["Projektmanagement-Software", "Projektmanagement-Tools", "Beste Projektmanagement-App"],
  "location": "de"
}

Ergebnis: Suchvolumen, CPC, Keyword-Schwierigkeit, Suchintention (informational/commercial/transactional), 12-Monats-Trends.

Schritt 4: Keyword-Gap-Analyse (optional)

Falls der Benutzer eine Domain und einen Mitbewerber hat, führe POST /v1/seo/keyword-gap aus.

{
  "domain": "beispiel.de",
  "competitor": "wettbewerber.de"
}

Ergebnis: Keywords, für die der Mitbewerber rankt, der Benutzer jedoch nicht – ungenutzte Chancen.

Schritt 5: Keywords priorisieren

Präsentiere eine priorisierte Keyword-Liste, sortiert nach Opportunity-Score:

• Hohe Chance – hohes Volumen + geringe Schwierigkeit
• Nach Absicht gruppieren – informational, navigational, commercial, transactional
• Saisonale Keywords markieren – notiere 12-Monats-Muster aus den Trends-Daten

Regeln

• Beginne breit mit Ideen, verfeinere dann mit Metriken
• Gruppiere Keywords nach Suchintention: informational, navigational, commercial, transactional
• Markiere saisonale Keywords mithilfe der Trends-Daten (12-Monats-Muster)
• Batch-Keyword-Metriken-Aufrufe – bis zu 100 Keywords pro Anfrage (0,15 $) sind günstiger als einzelne Lookups

Fehlerbehandlung

• NO_CREDITS (402) – Teile dem Benutzer mit, dass er unter https://yepapi.com/dashboard Guthaben hinzufügen soll
• UPSTREAM_ERROR (502) – Einmal wiederholen; bei erneutem Fehlschlag diesen Schritt überspringen und notieren
• VALIDATION_ERROR (400) – Keyword-Format prüfen; Keywords müssen nicht-leere Zeichenketten sein
• RATE_LIMITED (429) – Warten und wiederholen; den Retry-After-Header beachten