seo/
relevant-pages

Indexierte Seiten einer Domain erfassen – mit Seiten-URLs, Ranking-Verteilungen, modelliertem Suchtraffic und Kostenkontext der bezahlten Suche in normalisierten Datensätzen.

Relevant Pages API

Sichtbarkeit von Seiten
Ranking-Verteilung
Traffic-Schätzungen
0,15 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

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

ParameterErforderlichBeschreibung
targetErforderlichErforderliche Domain ohne https:// oder www., zum Beispiel example.com.
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 Datensätzen indexierter Seiten. 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 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.

  1. 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.
  2. Senden Sie die Nutzdaten per POST an /v1/seo/relevant-pages 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/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 true

Anwendungsfä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.

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.

Weitere Plattformen entdecken

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

Relevant Pages API — FAQ

Relevant Pages API ist eine Schnittstelle, die indexierte Seiten mit messbarer Suchrelevanz zu einer Domain ohne Protokoll oder www findet. Sie liefert Seiten-URLs, organische und bezahlte Ranking-Verteilungen, modellierten Traffic, Kostenschätzungen, Veränderungszahlen und vollständige Quellzeilen.

Senden Sie eine Domain wie example.com ohne https:// und ohne www. Senden Sie für dieses Domain-Inventar auf Seitenebene keine vollständige Seiten-URL.

Nein. Er liefert Seiten, die dem Suchindex bekannt sind und messbare organische oder bezahlte Relevanz haben; nicht indexierte Seiten und Seiten ohne messbare Sichtbarkeit erscheinen daher möglicherweise nicht.

Die Quellzeile kann organische und bezahlte Keyword-Anzahlen, Positionsbereiche, modellierten Traffic, geschätzte Kosten des bezahlten Traffics und Zahlen zu Ranking-Veränderungen enthalten. Diese verschachtelten Werte bleiben in extra.metrics und stehen nicht im normalisierten metrics-Objekt der obersten Ebene.

Nein. etv und die Werte zu Traffic-Kosten sind modellierte Suchschätzungen und keine privaten Analysedaten, beobachteten Besuche oder Umsatzmessungen.

Jede zurückgegebene Seite kostet 0,15 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.