Relevant Pages
Relevante Seiten sind indexierte URLs mit messbarer organischer oder bezahlter Suchsichtbarkeit, darunter Keyword-Anzahlen, Positionsbereiche, modellierter Traffic, Kostenschätzungen und Signale zu Veränderungen. Diese Messwerte auf Seitenebene eignen sich für Sichtbarkeitsinventare, den Vergleich von Fußabdrücken, die Prüfung des Traffic-Werts und die Analyse wiederholter Momentaufnahmen.
Funktionen der Relevant Pages API
- Seiteninventar auf Domain-EbeneLiefert absolute URLs von Seiten einer Domain, die im gewählten Suchindex messbare organische oder bezahlte Relevanz haben.
- Organische Ranking-VerteilungBewahrt die Anzahl organischer Keywords je Positionsbereich zusammen mit den Anzahlen neuer, aufsteigender, absteigender und verlorener Rankings, sofern sie bereitgestellt werden.
- Fußabdruck in der bezahlten SucheStellt für jede Seite die verfügbaren Anzahlen bezahlter Keywords, Positionsbereiche, den modellierten Traffic und die geschätzten Kosten des bezahlten Traffics bereit.
- Vollständige Kennzahlenobjekte der SeiteHält verschachtelte organische, bezahlte und weitere variable Messwerte auf Seitenebene in extra vor, während die Seiten-URL für eine stabile Identifizierung normalisiert wird.
Parameter der Relevant Pages API
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
target | Erforderlich | Erforderliche Domain ohne https:// oder www., zum Beispiel example.com. |
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 Datensätzen indexierter Seiten. 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 Relevant Pages API
Senden Sie eine korrekt formatierte Domain mit Marktparametern und einem begrenzten Quellfenster und lesen Sie anschließend jede relevante Seite aus der abgeschlossenen asynchronen Aufgabe.
- Wählen Sie eine Domain ohne https:// oder www., 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/relevant-pages 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/relevant-pages" \
-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 Relevant Pages API
- Inventar suchsichtbarer Seiten: Nutzen Sie die zurückgegebenen Seiten-URLs, um ein Domain-Inventar aufzubauen, das auf Seiten mit messbarer Relevanz im Suchindex beschränkt ist.
- Vergleich des organischen Fußabdrucks: Vergleichen Sie organische Keyword-Anzahlen, Ranking-Bereiche und Veränderungsfelder, um zu erkennen, wie sich die Sichtbarkeit auf die Seiten verteilt.
- Prüfung von Seiten in der bezahlten Suche: Nutzen Sie Anzahlen bezahlter Keywords, Positionsbereiche, modellierten Traffic und geschätzte Kosten, um den bezahlten Fußabdruck der zurückgegebenen Seiten zu vergleichen.
- Momentaufnahmen der Seitensichtbarkeit: Speichern Sie wiederholte Datensätze nach page_address und Markt, um Ranking-Verteilungen und modellierten Traffic über verschiedene Erfassungszeitpunkte hinweg zu vergleichen.
Profi-Tipps zur Relevant Pages API
- Entfernen Sie https:// und www. aus target, bevor Sie die Anfrage senden, weil dieser Endpunkt eine Domain und keine vollständige Seiten-URL erwartet.
- Verwenden Sie die zurückgegebene url als Seitenkennung; text ist dieselbe URL als Ersatzwert und enthält keinen Inhalt der Seite.
- Halten Sie target, location_code, language_code, results_limit und offset fest, wenn Sie wiederholte Ergebnisfenster vergleichen.
- Behandeln Sie offset als Anzahl der Quellzeilen und nicht als Seitennummer, und speichern Sie ihn getrennt vom next_cursor des Aufgabenergebnisses.
- Lesen Sie organische und bezahlte Messwerte aus extra.metrics, und rechnen Sie damit, dass verschachtelte Kennzahlengruppen oder einzelne Felder fehlen können.
- Interpretieren Sie etv und estimated_paid_traffic_cost als modellierte Suchschätzungen und nicht als private Analysedaten oder beobachtete Umsätze.
Verwandte APIs
Ergänzend zur Relevant Pages 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.
- Ranked Keywords API — Keywords finden, für die eine Domain, Subdomain oder Seite rankt – mit passenden URLs, Positionen, Suchwerten, Suchintention und vollständigen Quellelementen.
- 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