Konkurrenten: Übersicht

API + MCP

GET/v3/rank-tracker/competitors-overview

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\"

is_main_position: Schließt Positionen in AI Overview, Sitelinks, Top Stories, Bilder-Packs, Videos, Diskussionen und Foren sowie Posts auf X (Twitter) aus.
Typ: boolean

is_main_position_prev: Schließt Positionen in AI Overview, Sitelinks, Top Stories, Bilder-Packs, Videos, Diskussionen und Foren sowie Posts auf X (Twitter) am Vergleichsdatum aus.
Typ: boolean

keyword: Das Keyword, für das dein Ziel rankt.
Typ: string

keyword_difficulty: Eine Schätzung, wie schwierig es ist, für ein Keyword in die Top 10 der organischen Suchergebnisse zu kommen – auf einer Skala von 100 Punkten.
Typ: integer, nullable

keyword_has_data: Gibt false zurück, wenn das Keyword noch verarbeitet wird und noch keine SERP abgerufen wurde.
Typ: boolean

keyword_is_frozen: Gibt an, ob ein Keyword das Limit der in deinem Tarif getrackten Keywords überschritten hat. Solche Keywords sind „eingefroren“, d. h., ihre Rankings werden nicht aktualisiert.
Typ: boolean

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

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

serp_features: Die SERP-Features, die in den Suchergebnissen für ein Keyword erscheinen.
Typ: array(string)
enum: \"paid_top\" \"paid_bottom\" \"paid_right\" \"paid_sitelink\" \"organic\" \"sitelink\" \"snippet\" \"image\" \"article\" \"knowledge_card\" \"knowledge_panel\" \"local_pack\" \"local_teaser\" \"news\" \"question\" \"review\" \"shopping\" \"tweet\" \"spelling\" \"video\" \"discussion\" \"ai_overview\" \"ai_overview_sitelink\" \"organic_shopping\" \"image_th\" \"video_th\" \"ai_overview_found\"

serp_updated: Das Datum, an dem wir die Suchmaschinenergebnisse für ein Keyword zuletzt geprüft haben.
Typ: datetime, nullable

serp_updated_prev: Das Datum, bis zu dem wir die Suchmaschinenergebnisse am Vergleichsdatum geprüft haben.
Typ: datetime, nullable

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

volume: Eine Schätzung des durchschnittlichen monatlichen Suchvolumens für ein Keyword – entweder für den letzten Monat oder (je nach Parameter „volume_mode“) über die letzten bekannten 12 Monate.
Typ: integer, nullable

selectstringErforderlich

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

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:jsonphp

Antworten

keywordsarray<object>

competitors_listarray<object>

Wettbewerberinformationen für ein bestimmtes Keyword. Enthalten sind die folgenden Felder: url, url_prev, position, position_prev, best_position_kind, best_position_kind_prev, traffic, traffic_prev, value, value_prev. Felder, die auf prev enden, sind nur in der Vergleichsansicht enthalten.

countrystring

Das Land, in dem ein bestimmtes Keyword verfolgt wird. Ein zweistelliger Ländercode (ISO 3166-1 alpha-2).

Allowed values:ADAEAFAGAIALAMAOAQARASATAUAWAXAZBABBBDBEBFBGBHBIBJBLBMBNBOBQBRBSBTBVBWBYBZCACCCDCFCGCHCICKCLCMCNCOCRCUCVCWCXCYCZDEDJDKDMDODZECEEEGEHERESETFIFJFKFMFOFRGAGBGDGEGFGGGHGIGLGMGNGPGQGRGSGTGUGWGYHKHMHNHRHTHUIDIEILIMINIOIQIRISITJEJMJOJPKEKGKHKIKMKNKPKRKWKYKZLALBLCLILKLRLSLTLULVLYMAMCMDMEMFMGMHMKMLMMMNMOMPMQMRMSMTMUMVMWMXMYMZNANCNENFNGNINLNONPNRNUNZOMOTHERPAPEPFPGPHPKPLPMPNPRPSPTPWPYQARERORSRURWSASBSCSDSESGSHSISJSKSLSMSNSOSRSSSTSVSXSYSZTCTDTFTGTHTJTKTLTMTNTOTRTTTVTWTZUAUGUMUSUYUZVAVCVEVGVIVNVUWFWSYEYTZAZMZW

keywordstring

Das Keyword, für das dein Ziel rankt.

keyword_difficultyinteger or null

Eine Schätzung, wie schwer es ist, für ein Keyword in den Top 10 der organischen Suchergebnisse zu ranken, auf einer Skala von 100 Punkten.

keyword_has_databoolean

Gibt false zurück, wenn das Keyword noch verarbeitet wird und noch keine SERP abgerufen wurde.

keyword_is_frozenboolean

Gibt an, ob ein Keyword das Limit der in deinem Tarif verfolgten Keywords überschritten hat. Solche Keywords sind „eingefroren“, d. h., ihre Rankings werden nicht aktualisiert.

languagestring

Die SERP-Sprache, für die ein bestimmtes Keyword verfolgt wird.

locationstring

Der Standort (Land, Bundesland/Kanton oder Stadt), an dem ein bestimmtes Keyword verfolgt wird.

serp_featuresarray<string>

Die SERP-Features, die in den Suchergebnissen für das Keyword angezeigt werden.

Allowed values:paid_toppaid_bottompaid_rightpaid_sitelinkorganicsitelinksnippetimagearticleknowledge_cardknowledge_panellocal_packlocal_teasernewsquestionreviewshoppingtweetspellingvideodiscussionai_overviewai_overview_sitelinkorganic_shoppingimage_thvideo_thai_overview_found

serp_updatedstring or null

An diesem Datum haben wir die Suchergebnisse für das Keyword zuletzt geprüft.

serp_updated_prevstring or null

Das Datum, an dem wir die Suchergebnisse bis zum Vergleichsdatum geprüft haben.

tagsarray<string>

Eine Liste von Tags, die einem bestimmten Keyword zugewiesen sind.

volumeinteger or null

Eine Schätzung der durchschnittlichen monatlichen Anzahl von Suchanfragen für ein Keyword im letzten Monat bzw. in den letzten bekannten 12 Monaten – abhängig vom Parameter "volume_mode".