Kinerja berdasarkan posisi

API + MCP

GET/v3/gsc/performance-by-position

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.

search_typestring

Jenis hasil penelusuran yang akan dikembalikan (web, gambar, video, berita).

Nilai yang diizinkan:webimagevideonews

Default:web

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

wherestring

Bidang yang didukung:

outputstring

Format output.

Nilai yang diizinkan:jsoncsvxmlphp

Respons

metricsarray<object>

clicksinteger

clicks_percentnumber (float)

impressionsinteger

impressions_percentnumber (float)

keyword_countinteger

keyword_count_percentnumber (float)

position_rangestring

{ "metrics": [ { "clicks": 0, "clicks_percent": 0.0, "impressions": 0, "impressions_percent": 0.0, "keyword_count": 0, "keyword_count_percent": 0.0, "position_range": "string" } ] }