Seiten der Konkurrenten

API + MCP

GET/v3/rank-tracker/competitors-pages

Anfragen an diesen Endpunkt sind kostenlos und verbrauchen keine API-Einheiten.

Query-Parameter

timeoutinteger

Ein manuell festgelegtes Timeout in Sekunden.

limitinteger

Die Anzahl der zurückzugebenden Ergebnisse.

Standard:1000

order_bystring

Eine durch Kommas getrennte Liste von Spalten, nach denen die Ergebnisse sortiert werden sollen, mit optionaler Richtung. Gültige Spaltenkennungen siehe Antwort-Schema.

Example:field_a,field_b:asc,field_c:desc

wherestring

Der Filterausdruck. Folgende Spaltenbezeichner werden erkannt (dies unterscheidet sich von den Bezeichnern, die vom Parameter select erkannt werden).

selectstringErforderlich

Eine kommagetrennte Liste der zurückzugebenden Spalten. Gültige Spaltenkennungen findest du im Antwort-Schema.

target_and_tracked_competitors_onlyboolean

Seiten auf Ziel und verfolgte Konkurrenten beschränken

Standard:false

date_comparedstring (date)

Ein Datum zum Vergleich der Kennzahlen im Format YYYY-MM-DD.

datestring (date)Erforderlich

Ein Datum im Format YYYY-MM-DD, für das Metriken ausgewiesen werden.

devicestringErforderlich

Wähle zwischen Mobile- und Desktop-Rankings.

Zulässige Werte:desktopmobile

project_idintegerErforderlich

Die eindeutige Kennung des Projekts. Sie finden sie in der URL Ihres Rank Tracker Projekts in Ahrefs: https://app.ahrefs.com/rank-tracker/overview/#project_id#

volume_modestring

Der Berechnungsmodus für das Suchvolumen: monatlich oder durchschnittlich. Er beeinflusst Volumen, Traffic und Traffic-Wert.

Zulässige Werte:monthlyaverage

Standard:monthly

outputstring

Das Ausgabeformat.

Zulässige Werte:jsoncsvxmlphp

Antworten

competitors-pagesarray<object>

keywordsinteger

Die Gesamtanzahl Keywords, für die dein Ziel in den Top 100 Suchergebnissen rankt.

share_of_traffic_valuenumber (float)

Der Anteil des organischen Search-Traffic-Werts deines Ziels im Vergleich zum gesamten organischen Search-Traffic-Wert für alle verfolgten Keywords.

share_of_traffic_value_prevnumber (float)

Der Anteil am Traffic-Wert am Vergleichsdatum.

share_of_voicenumber (float)

Der Anteil des organischen Search-Traffics deines Ziels im Vergleich zum gesamten organischen Such-Traffic für alle verfolgten Keywords.

share_of_voice_prevnumber (float)

Der Share of Voice am Vergleichsdatum.

statusstring

Der Status einer Seite: die neue Seite, die gerade erst zu ranken begonnen hat ("left"), die verlorene Seite, die aus den Suchergebnissen verschwunden ist ("right"), oder keine Änderung ("both").

Allowed values:leftrightboth

titlestring or null

Der Titel, der für die Seite in der SERP ihres Top Keyword angezeigt wird.

title_prevstring or null

Der Titel am Vergleichsdatum.

trafficinteger

Die geschätzte Anzahl monatlicher Besucher, die eine Seite über die organische Suche erhält.

traffic_previnteger

Der Traffic am Vergleichsdatum.

traffic_valueinteger or null

Der geschätzte Wert des monatlichen organischen Search-Traffics der Seite, in US-Cent.

traffic_value_previnteger or null

Der Traffic-Wert am Vergleichsdatum.

urlstring (url)

Die URL der Seite.