seo/
ranked-keywords

Keywords finden, für die eine Domain, Subdomain oder Seite in einem Suchmarkt rankt – mit URLs, Positionen, Suchkennzahlen, Suchintention und geschätztem Traffic-Kontext.

Ranked Keywords API

Ziel: Domain oder Seite
Zuordnung der Ranking-URL
Positionskontext
0,1 Credits pro Ergebnis
Bereit
Bereit

Geben Sie Parameter ein und senden Sie eine Anfrage. Aufgabenstatus und normalisierte Ergebnisse erscheinen hier.

README

Von SocQ · Aktualisiert am

Ranked Keywords

Keywords mit Ranking sind Suchanfragen, die über eine passende Ergebnis-URL mit einer Domain, Subdomain oder Seite verknüpft sind, samt Gruppen-, absoluter und Ergebnisseiten-Position sowie verfügbaren Signalen zu Nachfrage, Schwierigkeit, Suchintention und Traffic. Diese Beziehungen zwischen Suchanfrage und Seite eignen sich für Sichtbarkeitsinventare, die Zuordnung von Landingpages, die Prüfung von Chancen und den Vergleich von Momentaufnahmen eines Ziels.

Funktionen der Ranked Keywords API

  • Umfang: Domain, Subdomain oder SeiteLöst ein korrekt formatiertes Web-Ziel in der Breite auf, die für eine ganze Domain, eine Subdomain oder die vollständige URL einer einzelnen Seite nötig ist.
  • Beziehungen zwischen Keyword und URLOrdnet jedem zurückgegebenen Keyword die passende Ziel-URL zu, die das gerankte Suchergebniselement bereitstellt.
  • Positionen und Keyword-MesswerteLiefert die verfügbaren Gruppen-, absoluten und Ergebnisseiten-Positionen zusammen mit Suchvolumen, CPC, Wettbewerb, Schwierigkeit, monatlichem Verlauf und Suchintention.
  • Vollständiges passendes ElementBewahrt keyword_data und ranked_serp_element in extra auf, sodass Ergebnistyp, modellierter Traffic und nicht übernommene Quelldetails verfügbar bleiben.

Parameter der Ranked Keywords API

ParameterErforderlichBeschreibung
targetErforderlichErforderliches Ziel: Domain, Subdomain oder Seite. Lassen Sie bei einer Domain https:// und www. weg, bei einer Subdomain das Protokoll, oder verwenden Sie für eine einzelne Seite die vollständige URL.
location_codeOptionalPositiver numerischer Code des Suchmarkts. Der Playground verwendet standardmäßig 2840.
location_nameOptionalOptionaler Name des Suchmarkts als Alternative zu location_code. Wenn er ausgefüllt ist, hat er Vorrang vor location_code.
language_codeOptionalSprachcode der Suche mit 2 bis 10 Zeichen. Der Playground verwendet standardmäßig en.
languageOptionalOptionaler Name der Suchsprache als Alternative zu language_code. Wenn er ausgefüllt ist, hat er Vorrang vor language_code.
results_limitOptionalGewünschtes Maximum von 1 bis 1.000 Zeilen mit Ranking-Keywords. Es können weniger Zeilen zurückgegeben werden.
offsetOptionalNullbasierte Anzahl der Quellzeilen, die übersprungen werden, bevor das angeforderte Ergebnisfenster gesammelt wird.

So verwenden Sie die Ranked Keywords API

Senden Sie ein korrekt abgegrenztes Ziel mit Marktparametern und einem begrenzten Ergebnisfenster und lesen Sie anschließend jedes Ranking-Keyword aus der abgeschlossenen asynchronen Aufgabe.

  1. Wählen Sie ein target, einen location_code, einen language_code, ein results_limit von 1 bis 1.000 und einen offset von 0 oder höher.
  2. Senden Sie die Nutzdaten per POST an /v1/seo/ranked-keywords und speichern Sie die zurückgegebene task_id.
  3. Fragen Sie /v1/tasks/{task_id} ab, bis die Aufgabe erfolgreich ist oder einen Fehler zurückgibt.
  4. Lesen Sie data.results.items und fordern Sie dann den zurückgegebenen next_cursor an, solange has_more den Wert true behält.
curl -X POST "https://api.socq.ai/v1/seo/ranked-keywords" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"target":"microsoft.com","location_code":2840,"language_code":"en","results_limit":5}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Anwendungsfälle der Ranked Keywords API

  • Inventar der organischen Sichtbarkeit: Katalogisieren Sie anhand des zurückgegebenen Keyword-Texts und der passenden URLs, wo eine Domain oder Subdomain im gewählten Suchmarkt erscheint.
  • Ranking-Zuordnung für Landingpages: Kombinieren Sie jedes Keyword, die Ziel-URL und das Rank-Objekt, um zu erkennen, welche Seite zu welcher zurückgegebenen Position gehört.
  • Prüfung von Keyword-Chancen: Vergleichen Sie die Position mit den verfügbaren Feldern zu Volumen, CPC, Wettbewerb, Schwierigkeit und Suchintention, um eine Prüfwarteschlange zusammenzustellen.
  • Vergleich von Sichtbarkeits-Momentaufnahmen: Speichern Sie passende Zieleingaben, collected_at, Keywords, URLs und Ränge aus wiederholten Aufgaben, um getrennt erfasste Momentaufnahmen zu vergleichen.

Profi-Tipps zur Ranked Keywords API

  • Entfernen Sie https:// und www. aus einem Domain-Ziel und das Protokoll aus einem Subdomain-Ziel, damit der gewünschte Umfang richtig interpretiert wird.
  • Verwenden Sie die vollständige Seiten-URL, wenn Sie Ergebnisse auf Seitenebene benötigen; ein Seitenpfad ohne Protokoll kann als Ziel für die gesamte Domain gedeutet werden.
  • Erhöhen Sie offset um die Anzahl der Quellzeilen, die Sie überspringen möchten, und halten Sie Ziel, Markt, Sprache und Grenze fest, wenn Sie aufeinanderfolgende Fenster abrufen.
  • Behandeln Sie rank.page als Nummer der Suchergebnisseite; verwenden Sie offset für Quellfenster und next_cursor getrennt davon für gespeicherte SocQ-Ergebnisseiten.
  • Lesen Sie zuerst die normalisierten Positionen und Keyword-Kennzahlen und prüfen Sie dann extra.ranked_serp_element auf den modellierten Wert etv und weitere Quellfelder, die nicht übernommen wurden.
  • Erstellen Sie historische Vergleiche aus wiederholten Aufgaben und entfernen Sie Duplikate zwischen Fenstern anhand von Keyword, passender URL, Markt und Sprache, weil sich die Quellreihenfolge ändern kann.

Ergänzend zur Ranked Keywords API nutzen Sie diese APIs, wenn Sie eine andere Art öffentlicher SEO-Daten benötigen.

  • Google Organic SERP API — Eine aktuelle Google-Ergebnisseite per Suchanfrage und Markt abrufen – mit normalisierten Zielen, Rängen, Elementtypen und vollständigen Ergebnisdetails.
  • Keyword Difficulty API — Die Ranking-Schwierigkeit in der organischen Suche für eine übermittelte Keyword-Liste vergleichen und jedes verfügbare Keyword mit seinem normalisierten Wert zurückgeben.
  • Keyword Overview API — Eine übermittelte Keyword-Liste um verfügbaren Kontext zu Nachfrage, bezahltem Wettbewerb, Schwierigkeit, monatlichen Suchen und Suchintention anreichern.
  • Keyword Search Volume API — Bekannte Keywords mit verfügbarem Suchvolumen, CPC, bezahltem Wettbewerb und monatlichem Suchverlauf messen.
  • Keywords for Site API — Für eine Website relevante Keywords mit verfügbaren Nachfragewerten, monatlichem Verlauf, Marktkontext und vollständigen Quellzeilen generieren.
  • Relevant Pages API — Indexierte Seiten einer Domain erfassen – mit Verteilungen organischer und bezahlter Rankings, modelliertem Traffic und geschätztem Kostenkontext.

Weitere Plattformen entdecken

Kombinieren Sie SEO-Daten mit öffentlichen Daten anderer unterstützter Social-Media-Plattformen.

Ranked Keywords API — FAQ

Ranked Keywords API ist eine Schnittstelle, die Suchbegriffe findet, die mit einer Domain, Subdomain oder Seite in einem gewählten Markt und einer gewählten Sprache verbunden sind. Sie liefert passende URLs, Positionen, Keyword-Kennzahlen, den monatlichen Verlauf, die Suchintention und vollständige Quellelemente.

Verwenden Sie eine reine Domain ohne https:// oder www., eine Subdomain ohne Protokoll oder die vollständige URL einer einzelnen Seite. Ein Seitenpfad ohne Protokoll kann den Umfang auf die gesamte Domain ausweiten.

Nein. Die Positionen beschreiben den gewählten Suchindex und Markt und nicht ein identisches Live-Ergebnis für jeden Nutzer; verwenden Sie daher collected_at, wenn Sie wiederholte Momentaufnahmen vergleichen.

rank.page ist die Nummer der Suchergebnisseite, offset überspringt Quellzeilen mit Keywords, und next_cursor blättert durch Ergebnisse, die bereits für die SocQ-Aufgabe gespeichert sind. Diese Werte sind nicht austauschbar.

Nein. etv ist ein modellierter Wert, der in extra.ranked_serp_element erhalten bleibt, und keine privaten Traffic- oder Conversion-Analysedaten des Ziels.

Jedes zurückgegebene Ranking-Keyword kostet 0,1 SocQ-Credits. Für eine leere Ergebnismenge fallen keine Ergebnisgebühren an, und results_limit liefert die Schätzung vor der Anfrage und keine garantierte endgültige Anzahl.