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
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
target | Erforderlich | Erforderliches 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_code | Optional | Positiver numerischer Code des Suchmarkts. Der Playground verwendet standardmäßig 2840. |
location_name | Optional | Optionaler Name des Suchmarkts als Alternative zu location_code. Wenn er ausgefüllt ist, hat er Vorrang vor location_code. |
language_code | Optional | Sprachcode der Suche mit 2 bis 10 Zeichen. Der Playground verwendet standardmäßig en. |
language | Optional | Optionaler Name der Suchsprache als Alternative zu language_code. Wenn er ausgefüllt ist, hat er Vorrang vor language_code. |
results_limit | Optional | Gewünschtes Maximum von 1 bis 1.000 Zeilen mit Ranking-Keywords. Es können weniger Zeilen zurückgegeben werden. |
offset | Optional | Nullbasierte 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.
- 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.
- Senden Sie die Nutzdaten per POST an /v1/seo/ranked-keywords und speichern Sie die zurückgegebene task_id.
- Fragen Sie /v1/tasks/{task_id} ab, bis die Aufgabe erfolgreich ist oder einen Fehler zurückgibt.
- 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 trueAnwendungsfä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.
Verwandte APIs
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.
- Keyword Suggestions API
- Related Keywords API
- Search Intent API
- Backlinks Summary API
- Backlinks API
- Referring Domains API
- Backlink Competitors API
- Domain Overview API
- Competitor Domains API
- Traffic Estimate API
- Domain Technologies API
- Whois Lookup API
- Google News API
- Google Images API
- Bing Search API
- YouTube Rank Tracker API
- Google Autocomplete API