Docs
Dokumentation durchsuchen...⌘K

Organische Keywords

API + MCP
GET/v3/site-explorer/organic-keywords

Query-Parameter

selectstringErforderlich

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

wherestring

Der Filterausdruck. Die folgenden Spaltenbezeichner werden erkannt (dies unterscheidet sich von den Bezeichnern, 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
traffic_modestring

Der Modus zur Berechnung des organischen Traffics: statisch oder adaptiv. Er wirkt sich auf den organischen Traffic und den Traffic-Wert aus.

Zulässige Werte:staticadaptive
Standard:adaptive
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.

countrystring

Ein aus zwei Buchstaben bestehender Ländercode (ISO 3166-1 alpha-2).

Zulässige Werte:adaeafagaialamaoarasatauawazba…
modestring

Der Umfang der Suche basierend auf dem von Ihnen eingegebenen Ziel.

Zulässige Werte:exactprefixdomainsubdomains
Standard:subdomains
targetstring (url)Erforderlich

Das Ziel der Suche: eine Domain oder eine URL.

protocolstring

Das Protokoll Ihres Ziels.

Zulässige Werte:bothhttphttps
Standard:both
outputstring

Das Ausgabeformat.

Zulässige Werte:jsonphpxml

Antworten

keywordsarray<object>
all_positionsarray<object>

(5 Einheiten) Die Liste aller Positionen für ein Keyword.

all_positions_prevarray<object>

(5 Einheiten) Die Liste aller Positionen für ein Keyword am Vergleichsdatum.

best_positioninteger or null

Das beste Ranking, das dein Ziel in den organischen Suchergebnissen für ein Keyword erreicht.

best_position_diffinteger or null

Die Ranking-Änderung zwischen den ausgewählten Daten.

best_position_has_thumbnailboolean or null

Die Top-Position hat ein Thumbnail.

best_position_has_thumbnail_prevboolean or null

Die Top-Position hat am Vergleichsdatum ein Thumbnail.

best_position_has_videoboolean or null

Die Top-Position hat ein Video.

best_position_has_video_prevboolean or null

Die Top-Position hat am Vergleichsdatum ein Video.

best_position_kindstring or null

Die Art der Top-Position: organisch, bezahlt oder ein SERP-Feature.

Zulässige Werte:paid_toppaid_bottompaid_rightpaid_sitelinkorganicsitelinksnippetimagearticleknowledge_cardknowledge_panellocal_packlocal_teasernewsquestion…
best_position_kind_mergedstring

Die Art der Top-Position, für die Sortierung optimiert.

Zulässige Werte:paid_toppaid_bottompaid_rightpaid_sitelinkorganicsitelinksnippetimagearticleknowledge_cardknowledge_panellocal_packlocal_teasernewsquestion…
best_position_kind_prevstring or null

Die Art der Top-Position am Vergleichsdatum.

Zulässige Werte:paid_toppaid_bottompaid_rightpaid_sitelinkorganicsitelinksnippetimagearticleknowledge_cardknowledge_panellocal_packlocal_teasernewsquestion…
best_position_previnteger or null

Die Top-Position am Vergleichsdatum.

best_position_setstring

Die Ranking-Gruppe der Top-Position.

Zulässige Werte:top_3top_4_10top_11_50top_51_more
best_position_set_prevstring or null

Die Ranking-Gruppe der Top-Position am Vergleichsdatum.

Zulässige Werte:top_3top_4_10top_11_50top_51_more
best_position_urlstring (url) or null

Die Ranking-URL in den organischen Suchergebnissen.

best_position_url_prevstring (url) or null

Die Ranking-URL am Vergleichsdatum.

cpcinteger or null

Kosten pro Klick zeigt den durchschnittlichen Preis, den Werbetreibende für jeden Anzeigenklick in den bezahlten Suchergebnissen für ein Keyword zahlen, in US-Cent.

cpc_mergedinteger or null

Das CPC-Feld, optimiert für die Sortierung.

cpc_previnteger or null

Die CPC-Kennzahl am Vergleichsdatum.

entitiesarray<object>

Organisationen, Produkte, Personen, Werke, Veranstaltungen und Orte, die in einem Schlüsselwort gefunden wurden.

is_best_position_set_top_11_50boolean

Die Rankinggruppe der Top-Position ist 11–50.

is_best_position_set_top_11_50_prevboolean or null

Die Rankinggruppe der Top-Position war am Vergleichsdatum 11–50.

is_best_position_set_top_3boolean

Die Rankinggruppe der Top-Position ist Top 3.

is_best_position_set_top_3_prevboolean or null

Die Rankinggruppe der Top-Position war am Vergleichsdatum Top 3.

is_best_position_set_top_4_10boolean

Die Rankinggruppe der Top-Position ist 4–10.

is_best_position_set_top_4_10_prevboolean or null

Die Rankinggruppe der Top-Position war am Vergleichsdatum 4–10.

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 or null

Das Keyword, für das dein Ziel rankt.

keyword_countrystring

Das Land des Keywords, für das dein Ziel rankt.

Zulässige Werte:ADAEAFAGAIALAMAOAQARASATAUAWAX…
keyword_difficultyinteger or null

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

keyword_difficulty_mergedinteger or null

(10 Einheiten) Das Feld für die Keyword-Schwierigkeit, optimiert für die Sortierung.

keyword_difficulty_previnteger or null

(10 Einheiten) Die Keyword-Schwierigkeit zum Vergleichsdatum.

keyword_languagearray<string>

Die Sprache der Suchanfrage

keyword_mergedstring

Das Keyword-Feld, optimiert für die Sortierung.

keyword_prevstring or null

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

languagestring

Die SERP-Sprache.

language_prevstring or null

Die SERP-Sprache zum Vergleichsdatum.

last_updatestring (date-time)

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

last_update_prevstring (date-time) or null

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

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_features_countinteger

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

serp_features_count_previnteger or null

Die Anzahl der SERP-Features am Vergleichsdatum.

serp_features_mergedarray<string>

Das SERP-Features-Feld, optimiert für die Sortierung.

Zulässige Werte:paid_toppaid_bottompaid_rightpaid_sitelinkorganicsitelinksnippetimagearticleknowledge_cardknowledge_panellocal_packlocal_teasernewsquestion…
serp_features_prevarray<string>

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

Zulässige Werte:paid_toppaid_bottompaid_rightpaid_sitelinkorganicsitelinksnippetimagearticleknowledge_cardknowledge_panellocal_packlocal_teasernewsquestion…
serp_target_main_positions_countinteger

Die Anzahl der Ziel-URLs, die für ein Keyword ranken, ohne Positionen in Sitelinks, Top Stories, Bilder-Karussells und Beiträgen auf X (Twitter).

serp_target_main_positions_count_previnteger or null

Die Anzahl der Ziel-URLs, die für ein Keyword am Vergleichsdatum ranken, ohne Positionen in Sitelinks, Top Stories, Bilder-Karussells und Beiträgen auf X (Twitter).

serp_target_positions_countinteger

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

serp_target_positions_count_previnteger or null

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

statusstring

Der Status einer Seite: die neue Seite, die gerade erst zu ranken begonnen hat ("left"), die verlorene Seite, die aus den Suchergebnissen verschwunden ist ("right"), oder keine Änderung ("both").

Zulässige Werte:leftrightboth
sum_paid_trafficinteger or null

(10 Einheiten) Eine Schätzung der monatlichen Besuche, die dein Ziel über bezahlte Suche für ein Keyword erhält.

sum_paid_traffic_mergedinteger

(10 Einheiten) Das Paid-Traffic-Feld, optimiert für die Sortierung.

sum_paid_traffic_previnteger or null

(10 Einheiten) Der bezahlte Traffic am Vergleichsdatum.

sum_trafficinteger or null

(10 Einheiten) Eine Schätzung der monatlichen Besuche, die dein Ziel durch organische Suche für ein Keyword erhält.

sum_traffic_mergedinteger

(10 Einheiten) Das Traffic-Feld, optimiert für die Sortierung.

sum_traffic_previnteger or null

(10 Einheiten) Der Traffic am Vergleichsdatum.

volumeinteger or null

(10 Einheiten) Eine Schätzung der Anzahl der Suchanfragen für ein Keyword im letzten Monat.

volume_desktop_pctnumber (float) or null

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

volume_mergedinteger or null

(10 Einheiten) Das Suchvolumen-Feld, optimiert für die Sortierung.

volume_mobile_pctnumber (float) or null

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

volume_previnteger or null

(10 Einheiten) Das Suchvolumen am Vergleichsdatum.

wordsinteger or null

Die Anzahl der Wörter in einem Keyword.

words_mergedinteger

Die Anzahl der Wörter in einem Keyword, optimiert für die Sortierung.

words_previnteger or null

Die Anzahl der Wörter in einem Keyword am Vergleichsdatum.