Docs
Dokumentation durchsuchen...⌘K

Übersicht

API + MCP
GET/v3/rank-tracker/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:jsoncsvxmlphp

Antworten

overviewsarray<object>
best_position_has_thumbnailboolean or null

Die Top-Position (oder – falls festgelegt – die Ziel-URL) hat ein Thumbnail.

best_position_has_thumbnail_previousboolean or null

Die Top-Position (oder – falls festgelegt – die Ziel-URL) hat am Vergleichsdatum ein Thumbnail.

best_position_has_video_previewboolean or null

Die Top-Position (oder – falls festgelegt – die Ziel-URL) hat eine Videovorschau.

best_position_has_video_preview_previousboolean or null

Die Top-Position (oder – falls festgelegt – die Ziel-URL) hat am Vergleichsdatum eine Videovorschau.

best_position_kindstring or null

Die Art der Top-Position (oder – falls festgelegt – der Ziel-URL): organisch, bezahlt oder ein SERP-Feature.

Allowed values:paid_toppaid_bottompaid_rightpaid_sitelinkorganicsitelinksnippetimagearticleknowledge_cardknowledge_panellocal_packlocal_teasernewsquestionreviewshoppingtweetspellingvideodiscussionai_overviewai_overview_sitelinkorganic_shopping
best_position_kind_previousstring or null

Die Art der Spitzenposition (oder der Ziel-URLs, falls festgelegt) am Vergleichsdatum.

Allowed values:paid_toppaid_bottompaid_rightpaid_sitelinkorganicsitelinksnippetimagearticleknowledge_cardknowledge_panellocal_packlocal_teasernewsquestionreviewshoppingtweetspellingvideodiscussionai_overviewai_overview_sitelinkorganic_shopping
clicksinteger or null

Klicks ist die durchschnittliche monatliche Anzahl Klicks auf Suchergebnisse für das Keyword. Während einige Suchen zu Klicks auf mehrere Ergebnisse führen, wird bei anderen möglicherweise auf keines der Ergebnisse geklickt.

clicks_per_searchnumber (float) or null

Klicks Pro Suche ist das Verhältnis von Klick zum Suchvolumen des Keywords. Es gibt an, auf wie viele verschiedene Ergebnisse Nutzer durchschnittlich klicken, die im gegebenen Land nach dem Ziel-Keyword suchen.

cost_per_clickinteger or null

Cost Per Click zeigt den durchschnittlichen Preis, den Werbetreibende pro Anzeigenklick in den bezahlten Suchergebnissen für das Keyword zahlen.

countrystring

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

Allowed values:ADAEAFAGAIALAMAOAQARASATAUAWAXAZBABBBDBEBFBGBHBIBJBLBMBNBOBQBRBSBTBVBWBYBZCACCCDCFCGCHCICKCLCMCNCOCRCUCVCWCXCYCZDEDJDKDMDODZECEEEGEHERESETFIFJFKFMFOFRGAGBGDGEGFGGGHGIGLGMGNGPGQGRGSGTGUGWGYHKHMHNHRHTHUIDIEILIMINIOIQIRISITJEJMJOJPKEKGKHKIKMKNKPKRKWKYKZLALBLCLILKLRLSLTLULVLYMAMCMDMEMFMGMHMKMLMMMNMOMPMQMRMSMTMUMVMWMXMYMZNANCNENFNGNINLNONPNRNUNZOMOTHERPAPEPFPGPHPKPLPMPNPRPSPTPWPYQARERORSRURWSASBSCSDSESGSHSISJSKSLSMSNSOSRSSSTSVSXSYSZTCTDTFTGTHTJTKTLTMTNTOTRTTTVTWTZUAUGUMUSUYUZVAVCVEVGVIVNVUWFWSYEYTZAZMZW
country_prevstring

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

Allowed values:ADAEAFAGAIALAMAOAQARASATAUAWAXAZBABBBDBEBFBGBHBIBJBLBMBNBOBQBRBSBTBVBWBYBZCACCCDCFCGCHCICKCLCMCNCOCRCUCVCWCXCYCZDEDJDKDMDODZECEEEGEHERESETFIFJFKFMFOFRGAGBGDGEGFGGGHGIGLGMGNGPGQGRGSGTGUGWGYHKHMHNHRHTHUIDIEILIMINIOIQIRISITJEJMJOJPKEKGKHKIKMKNKPKRKWKYKZLALBLCLILKLRLSLTLULVLYMAMCMDMEMFMGMHMKMLMMMNMOMPMQMRMSMTMUMVMWMXMYMZNANCNENFNGNINLNONPNRNUNZOMOTHERPAPEPFPGPHPKPLPMPNPRPSPTPWPYQARERORSRURWSASBSCSDSESGSHSISJSKSLSMSNSOSRSSSTSVSXSYSZTCTDTFTGTHTJTKTLTMTNTOTRTTTVTWTZUAUGUMUSUYUZVAVCVEVGVIVNVUWFWSYEYTZAZMZW
created_atstring (date-time)

Das Datum, an dem ein Keyword zum Projekt hinzugefügt wurde.

is_brandedboolean

Nutzerintention: Branded. Der Nutzer sucht nach einem bestimmten Markennamen oder Firmennamen.

is_commercialboolean

Nutzerintention: Kommerziell. Der Nutzer vergleicht Produkte oder Dienstleistungen, bevor er eine Kaufentscheidung trifft.

is_informationalboolean

Nutzerintention: Informational. Der Nutzer sucht nach Informationen oder einer Antwort auf eine bestimmte Frage.

is_localboolean

Nutzerintention: Local. Der Nutzer sucht nach Informationen zu einem bestimmten Ort oder nahegelegenen Diensten.

is_navigationalboolean

Nutzerintention: Navigational. Der Nutzer sucht nach einer bestimmten Website oder Webseite.

is_transactionalboolean

Nutzerintention: Transactional. Der Nutzer ist bereit, eine Handlung abzuschließen, oft einen Kauf.

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.

keyword_prevstring

Das Keyword, für das dein Ziel zum Vergleichsdatum rankt.

languagestring

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

language_prevstring

Die SERP-Sprache zum Vergleichsdatum.

locationstring

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

location_prevstring

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

parent_topicstring or null

Anhand der Eltern-Themas kannst du schätzen, ob du für das jeweilige Keyword ranken kannst, während du die Seite für ein allgemeineres primäres Keyword optimierst. Um das Eltern-Thema zu ermitteln, schauen wir uns die Rankings der #1 rankenden Seite für dein Keyword an und ermitteln, welches Keyword dieser Seite den meisten Traffic bringt.

positioninteger or null

Die Spitzenposition (oder die Ziel-URLs, falls festgelegt) in der organischen Suche.

position_diffinteger or null

Die Veränderung der Spitzenposition (oder der Ziel-URLs, falls festgelegt) zwischen den ausgewählten Daten.

position_previnteger or null

Die Spitzenposition (oder die Ziel-URLs, falls festgelegt) am Vergleichsdatum.

search_type_imagenumber (float) or null

Das Search-Type-Bild zeigt den Prozentsatz der Suchanfragen nach einem Keyword für Bilder an, was das Interesse an visuellen Inhalten widerspiegelt.

search_type_newsnumber (float) or null

Der Suchtyp News zeigt den Prozentsatz der Suchanfragen für ein Keyword, die auf Nachrichtenartikel abzielen.

search_type_videonumber (float) or null

Der Suchtyp Video zeigt den Prozentsatz der Suchanfragen für ein Keyword, die auf Videos abzielen, und spiegelt das Interesse an Videoinhalten wider.

search_type_webnumber (float) or null

Der Suchtyp Web zeigt den Prozentsatz der Suchanfragen für ein Keyword, die für allgemeine Webinhalte gemacht wurden, was ein Interesse an einer breiten Palette von Informationen vermuten lässt.

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_features_prevarray<string>

Die SERP-Features, die in den Suchergebnissen für das Keyword am Vergleichsdatum 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.

tags_prevarray<string>

Eine Liste der Tags, die einem bestimmten Keyword am Vergleichsdatum zugewiesen sind.

target_positions_countinteger

Die Anzahl der Ziel-URLs, die für ein Keyword ranken.

trafficinteger or null

Eine Schätzung der monatlichen Besuche, die eine Seite im letzten Monat bzw. in den letzten bekannten 12 Monaten aus der organischen Suche erhält – abhängig vom Parameter "volume_mode".

traffic_diffinteger or null

Die Änderung des Traffics zwischen deinen gewählten Daten.

traffic_previnteger or null

Eine Schätzung der monatlichen Besuche, die eine Seite im letzten Monat bzw. in den letzten bekannten 12 Monaten aus der organischen Suche erhält – abhängig vom Parameter "volume_mode".

urlstring (url) or null

Die bestplatzierte URL (oder die Ziel-URL, falls festgelegt) in der organischen Suche.

url_prevstring (url) or null

Die bestplatzierte URL (oder die Ziel-URL, falls festgelegt) am Vergleichsdatum.

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

volume_desktop_pctnumber (float) or null

Der prozentuale Anteil des gesamten Suchvolumens, der von Desktop-Geräten stammt.

volume_mobile_pctnumber (float) or null

Der prozentuale Anteil des gesamten Suchvolumens, der von Mobilgeräten stammt.