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).

country: Das Land, in dem ein bestimmtes Keyword getrackt wird. Ein zweistelliger Ländercode (ISO 3166-1 alpha-2).
type: 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).
type: 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.
type: string

keyword: Das Keyword, für das Ihr Target rankt.
type: string

keyword_prev: Das Keyword, für das Ihr Target am Vergleichsdatum rankte.
type: string

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

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

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

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

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

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

url: Die URL der Seite.
type: string

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, 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 (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.