Riwayat kata kunci

API + MCP

GET/v3/gsc/keyword-history

Permintaan ke endpoint ini gratis dan tidak menghabiskan unit API.

Parameter kueri

project_idinteger

ID Proyek. Wajib diisi jika portfolio_id tidak diberikan.

portfolio_idinteger

ID Portfolio. Jika diberikan, data akan diagregasi dari semua Proyek yang terhubung ke GSC dalam Portfolio tersebut.

date_fromstring (date)Wajib

Tanggal mulai periode historis dalam format YYYY-MM-DD.

date_tostring (date)

Tanggal akhir periode historis dalam format YYYY-MM-DD.

history_groupingstring

Interval waktu yang digunakan untuk mengelompokkan data historis.

Nilai yang diizinkan:dailyweeklymonthly

Default:monthly

countrystring

Kode negara dua huruf (ISO 3166-1 alpha-2).

Nilai yang diizinkan:adaeafagaialamaoarasatauawazba…

devicestring

Filter berdasarkan jenis perangkat (DESKTOP, MOBILE, TABLET). Jika tidak ditentukan, semua perangkat akan disertakan.

Nilai yang diizinkan:desktopmobiletablet

keywordsstring

Daftar kata kunci yang dipisahkan dengan koma untuk mengambil data riwayatnya.

wherestring

Bidang yang didukung:

outputstring

Format output.

Nilai yang diizinkan:jsoncsvxmlphp

metricsarray<object>

clicksinteger

ctrnumber (float)

datestring (date-time)

impressionsinteger

keywordstring

positionnumber (float)

Posisi rata-rata (desimal, mis. 4.7)