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. Die folgenden Spalten-IDs werden erkannt (dies unterscheidet sich von den IDs, die vom Parameter select erkannt werden).

country: Das Land, in dem ein bestimmtes Keyword getrackt wird. Ein zweistelliger Ländercode (ISO 3166-1 alpha-2).
Typ: string
enum: \"AD\" \"AE\" \"AF\" \"AG\" \"AI\" \"AL\" \"AM\" \"AO\" \"AQ\" \"AR\" \"AS\" \"AT\" \"AU\" \"AW\" \"AX\" \"AZ\" \"BA\" \"BB\" \"BD\" \"BE\" \"BF\" \"BG\" \"BH\" \"BI\" \"BJ\" \"BL\" \"BM\" \"BN\" \"BO\" \"BQ\" \"BR\" \"BS\" \"BT\" \"BV\" \"BW\" \"BY\" \"BZ\" \"CA\" \"CC\" \"CD\" \"CF\" \"CG\" \"CH\" \"CI\" \"CK\" \"CL\" \"CM\" \"CN\" \"CO\" \"CR\" \"CU\" \"CV\" \"CW\" \"CX\" \"CY\" \"CZ\" \"DE\" \"DJ\" \"DK\" \"DM\" \"DO\" \"DZ\" \"EC\" \"EE\" \"EG\" \"EH\" \"ER\" \"ES\" \"ET\" \"FI\" \"FJ\" \"FK\" \"FM\" \"FO\" \"FR\" \"GA\" \"GB\" \"GD\" \"GE\" \"GF\" \"GG\" \"GH\" \"GI\" \"GL\" \"GM\" \"GN\" \"GP\" \"GQ\" \"GR\" \"GS\" \"GT\" \"GU\" \"GW\" \"GY\" \"HK\" \"HM\" \"HN\" \"HR\" \"HT\" \"HU\" \"ID\" \"IE\" \"IL\" \"IM\" \"IN\" \"IO\" \"IQ\" \"IR\" \"IS\" \"IT\" \"JE\" \"JM\" \"JO\" \"JP\" \"KE\" \"KG\" \"KH\" \"KI\" \"KM\" \"KN\" \"KP\" \"KR\" \"KW\" \"KY\" \"KZ\" \"LA\" \"LB\" \"LC\" \"LI\" \"LK\" \"LR\" \"LS\" \"LT\" \"LU\" \"LV\" \"LY\" \"MA\" \"MC\" \"MD\" \"ME\" \"MF\" \"MG\" \"MH\" \"MK\" \"ML\" \"MM\" \"MN\" \"MO\" \"MP\" \"MQ\" \"MR\" \"MS\" \"MT\" \"MU\" \"MV\" \"MW\" \"MX\" \"MY\" \"MZ\" \"NA\" \"NC\" \"NE\" \"NF\" \"NG\" \"NI\" \"NL\" \"NO\" \"NP\" \"NR\" \"NU\" \"NZ\" \"OM\" \"OTHER\" \"PA\" \"PE\" \"PF\" \"PG\" \"PH\" \"PK\" \"PL\" \"PM\" \"PN\" \"PR\" \"PS\" \"PT\" \"PW\" \"PY\" \"QA\" \"RE\" \"RO\" \"RS\" \"RU\" \"RW\" \"SA\" \"SB\" \"SC\" \"SD\" \"SE\" \"SG\" \"SH\" \"SI\" \"SJ\" \"SK\" \"SL\" \"SM\" \"SN\" \"SO\" \"SR\" \"SS\" \"ST\" \"SV\" \"SX\" \"SY\" \"SZ\" \"TC\" \"TD\" \"TF\" \"TG\" \"TH\" \"TJ\" \"TK\" \"TL\" \"TM\" \"TN\" \"TO\" \"TR\" \"TT\" \"TV\" \"TW\" \"TZ\" \"UA\" \"UG\" \"UM\" \"US\" \"UY\" \"UZ\" \"VA\" \"VC\" \"VE\" \"VG\" \"VI\" \"VN\" \"VU\" \"WF\" \"WS\" \"YE\" \"YT\" \"ZA\" \"ZM\" \"ZW\"

country_prev: Das Land, in dem ein bestimmtes Keyword am Vergleichsdatum getrackt wurde. Ein zweistelliger Ländercode (ISO 3166-1 alpha-2).
Typ: string
enum: \"AD\" \"AE\" \"AF\" \"AG\" \"AI\" \"AL\" \"AM\" \"AO\" \"AQ\" \"AR\" \"AS\" \"AT\" \"AU\" \"AW\" \"AX\" \"AZ\" \"BA\" \"BB\" \"BD\" \"BE\" \"BF\" \"BG\" \"BH\" \"BI\" \"BJ\" \"BL\" \"BM\" \"BN\" \"BO\" \"BQ\" \"BR\" \"BS\" \"BT\" \"BV\" \"BW\" \"BY\" \"BZ\" \"CA\" \"CC\" \"CD\" \"CF\" \"CG\" \"CH\" \"CI\" \"CK\" \"CL\" \"CM\" \"CN\" \"CO\" \"CR\" \"CU\" \"CV\" \"CW\" \"CX\" \"CY\" \"CZ\" \"DE\" \"DJ\" \"DK\" \"DM\" \"DO\" \"DZ\" \"EC\" \"EE\" \"EG\" \"EH\" \"ER\" \"ES\" \"ET\" \"FI\" \"FJ\" \"FK\" \"FM\" \"FO\" \"FR\" \"GA\" \"GB\" \"GD\" \"GE\" \"GF\" \"GG\" \"GH\" \"GI\" \"GL\" \"GM\" \"GN\" \"GP\" \"GQ\" \"GR\" \"GS\" \"GT\" \"GU\" \"GW\" \"GY\" \"HK\" \"HM\" \"HN\" \"HR\" \"HT\" \"HU\" \"ID\" \"IE\" \"IL\" \"IM\" \"IN\" \"IO\" \"IQ\" \"IR\" \"IS\" \"IT\" \"JE\" \"JM\" \"JO\" \"JP\" \"KE\" \"KG\" \"KH\" \"KI\" \"KM\" \"KN\" \"KP\" \"KR\" \"KW\" \"KY\" \"KZ\" \"LA\" \"LB\" \"LC\" \"LI\" \"LK\" \"LR\" \"LS\" \"LT\" \"LU\" \"LV\" \"LY\" \"MA\" \"MC\" \"MD\" \"ME\" \"MF\" \"MG\" \"MH\" \"MK\" \"ML\" \"MM\" \"MN\" \"MO\" \"MP\" \"MQ\" \"MR\" \"MS\" \"MT\" \"MU\" \"MV\" \"MW\" \"MX\" \"MY\" \"MZ\" \"NA\" \"NC\" \"NE\" \"NF\" \"NG\" \"NI\" \"NL\" \"NO\" \"NP\" \"NR\" \"NU\" \"NZ\" \"OM\" \"OTHER\" \"PA\" \"PE\" \"PF\" \"PG\" \"PH\" \"PK\" \"PL\" \"PM\" \"PN\" \"PR\" \"PS\" \"PT\" \"PW\" \"PY\" \"QA\" \"RE\" \"RO\" \"RS\" \"RU\" \"RW\" \"SA\" \"SB\" \"SC\" \"SD\" \"SE\" \"SG\" \"SH\" \"SI\" \"SJ\" \"SK\" \"SL\" \"SM\" \"SN\" \"SO\" \"SR\" \"SS\" \"ST\" \"SV\" \"SX\" \"SY\" \"SZ\" \"TC\" \"TD\" \"TF\" \"TG\" \"TH\" \"TJ\" \"TK\" \"TL\" \"TM\" \"TN\" \"TO\" \"TR\" \"TT\" \"TV\" \"TW\" \"TZ\" \"UA\" \"UG\" \"UM\" \"US\" \"UY\" \"UZ\" \"VA\" \"VC\" \"VE\" \"VG\" \"VI\" \"VN\" \"VU\" \"WF\" \"WS\" \"YE\" \"YT\" \"ZA\" \"ZM\" \"ZW\"

domain: Die Domain der Seite.
Typ: string

language: Die SERP-Sprache, für die ein bestimmtes Keyword getrackt wird.
Typ: string

language_prev: Die SERP-Sprache am Vergleichsdatum.
Typ: string

location: Der Ort (Land, Bundesland/Provinz oder Stadt), in dem ein bestimmtes Keyword getrackt wird.
Typ: string

location_prev: Der Ort (Land, Bundesland/Provinz oder Stadt), in dem ein bestimmtes Keyword am Vergleichsdatum getrackt wurde.
Typ: string

tags: Eine Liste der Tags, die einem bestimmten Keyword zugewiesen sind.
Typ: array(string)

tags_prev: Eine Liste der Tags, die einem bestimmten Keyword am Vergleichsdatum zugewiesen sind.
Typ: array(string)

url: Die URL der Seite.
Typ: string

selectstringErforderlich

Eine durch Kommas getrennte Liste der zurückzugebenden Spalten. Gültige Spaltenkennungen finden Sie im Antwort-Schema.

target_and_tracked_competitors_onlyboolean

Seiten auf Ziel und verfolgte Konkurrenten beschränken

Standard:false

date_comparedstring

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

datestringErforderlich

Ein Datum, für das Metriken im Format YYYY-MM-DD ausgegeben 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

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

Der Anteil am Traffic-Wert am Vergleichsdatum.

share_of_voicenumber

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

share_of_voice_prevnumber

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

Die URL der Seite.