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

selectstringErforderlich

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

wherestring

Der Filterausdruck. Die folgenden Spaltenkennungen werden erkannt (dies unterscheidet sich von den Kennungen, die vom Parameter select erkannt werden).

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
limitinteger

Die Anzahl der zurückzugebenden Ergebnisse.

Standard:1000
timeoutinteger

Eine manuelle Timeout-Dauer in Sekunden.

volume_modestring

Der Berechnungsmodus für das Suchvolumen: monatlich oder durchschnittlich. Er wirkt sich auf Volumen, Traffic und den Traffic-Wert aus.

Zulässige Werte:monthlyaverage
Standard:monthly
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#

devicestringErforderlich

Wähle zwischen Mobile- und Desktop-Rankings.

Zulässige Werte:desktopmobile
datestring (date)Erforderlich

Ein Datum im Format JJJJ-MM-TT, für das Kennzahlen gemeldet werden sollen.

date_comparedstring (date)

Ein Datum im Format YYYY-MM-DD, mit dem Metriken verglichen werden.

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

Zulässige Werte:ADAEAFAGAIALAMAOAQARASATAUAWAX…
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.

Zulässige Werte:paid_toppaid_bottompaid_rightpaid_sitelinkorganicsitelinksnippetimagearticleknowledge_cardknowledge_panellocal_packlocal_teasernewsquestion…
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".