Docs
Dokumentation durchsuchen...⌘K

SERP-Übersicht

API + MCP
GET/v3/rank-tracker/serp-overview

Anfragen an diesen Endpunkt sind kostenlos und verbrauchen keine API-Einheiten.

Query-Parameter

top_positionsinteger

Die Anzahl der obersten organischen SERP-Positionen, die zurückgegeben werden sollen. Wenn nicht angegeben, werden alle verfügbaren Positionen zurückgegeben.

devicestringErforderlich

Wähle zwischen Mobile- und Desktop-Rankings.

Zulässige Werte:desktopmobile
datestring

Ein Zeitstempel, zu dem die zuletzt verfügbare SERP-Übersicht im Format YYYY-MM-DDThh:mm:ss zurückgegeben wird. Wenn nicht angegeben, wird die neueste SERP-Übersicht zurückgegeben.

location_idinteger

Die Location-ID eines getrackten Keywords. Du kannst den Endpoint management/project-keywords verwenden, um Ländercodes, Sprachcodes und Location-IDs für deine getrackten Keywords abzurufen.

countrystringErforderlich

Ein zweibuchstabiger Ländercode (ISO 3166-1 Alpha-2).

Zulässige Werte:adaeafagaialamaoarasatauawazbabbbdbebfbgbhbibjbnbobrbsbtbwbybzcacdcfcgchcickclcmcncocrcucvcyczdedjdkdmdodzeceeegesetfifjfmfofrgagbgdgegfggghgiglgmgngpgqgrgtgugyhkhnhrhthuidieiliminiqisitjejmjojpkekgkhkiknkrkwkykzlalblclilklsltlulvlymamcmdmemgmkmlmmmnmqmrmsmtmumvmwmxmymznancnengninlnonpnrnunzompapepfpgphpkplpnprpsptpyqarerorsrurwsasbscsesgshsiskslsmsnsosrstsvtdtgthtjtktltmtntotrtttwtzuaugusuyuzvcvevgvivnvuwsyeytzazmzw
language_codestring

Der Sprachcode eines getrackten Keywords. Du kannst den Endpoint management/project-keywords verwenden, um Ländercodes, Sprachcodes und Location-IDs für deine getrackten Keywords abzurufen.

keywordstringErforderlich

Das Keyword, für das die SERP-Übersicht zurückgegeben werden soll.

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#

outputstring

Das Ausgabeformat.

Zulässige Werte:jsoncsvxmlphp

Antworten

positionsarray<object>
ahrefs_rankinteger or null

Die Stärke des Backlinkprofils einer Domain im Vergleich zu anderen Websites in unserer Datenbank, wobei Platz 1 das stärkste Backlinkprofil hat.

backlinksinteger or null

Die Gesamtzahl der Links von anderen Websites, die auf ein Suchergebnis verweisen.

domain_ratingnumber or null

Die Stärke des Backlinkprofils einer Domain im Vergleich zu den anderen Websites in unserer Datenbank auf einer 100-Punkte-Skala.

keywordsinteger or null

Die Gesamtanzahl der Keywords, für die ein Suchergebnis in den Top 100 organischen Positionen rangiert.

nr_wordsinteger or null

Die Gesamtanzahl der Wörter im HTML einer Webseite.

page_typestring or null

Durch Kommas getrennte Liste der von KI vorhergesagten hierarchischen Seitentyp-Pfade für die rankende Seite. Jeder Wert ist ein Pfad mit vorangestelltem Schrägstrich (z. B. /Article/How_to).

positioninteger

Die Position des Suchergebnisses in der SERP.

refdomainsinteger or null

Die Anzahl der einzelnen Domains, die auf ein Suchergebnis verlinken.

titlestring or null

Der Titel einer Ranking-Seite.

top_keywordstring or null

Das Keyword, das einem Suchergebnis den meisten organischen Traffic bringt.

top_keyword_volumeinteger or null

Eine Schätzung der durchschnittlichen monatlichen Suchanfragen für das Top-Keyword über die letzten 12 Monate, für die wir Daten haben.

trafficinteger or null

Eine Schätzung des monatlichen organischen Suchtraffics, den ein Ergebnis über alle Keywords erhält, für die es rankt.

typearray<string>

Die Art der Position: organisch, bezahlt oder ein SERP-Feature. Zulässige Werte: ai_overview, ai_overview_sitelink, discussion, image, image_th, knowledge_card, knowledge_panel, local_pack, organic, organic_shopping, paid_top, paid_bottom, paid_right, question, sitelink, snippet, top_story, tweet, video, video_th.

update_datestring

Das Datum, an dem wir die Suchergebnisse für ein Keyword geprüft haben.

urlstring or null

Die URL einer Ranking-Seite.

url_ratingnumber or null

Die Stärke des Backlinkprofils einer Seite auf einer logarithmischen 100-Punkte-Skala.

valueinteger or null

Der geschätzte Wert des monatlichen organischen Search-Traffics der Seite, in US-Cent.