Docs
Dokumentation durchsuchen...⌘K

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

selectstringErforderlich

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

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: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 (date-time) or null

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

serp_updated_prevstring (date-time) 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".