Історія сторінки

API + MCP

GET/v3/gsc/page-history

Запити до цього ендпоїнта безкоштовні та не витрачають жодних одиниць API.

Параметри запиту

project_idinteger

Ідентифікатор проєкту. Обов’язковий, якщо portfolio_id не вказано.

portfolio_idinteger

Ідентифікатор портфоліо. Якщо його вказано, агрегує дані за всіма підключеними до GSC проєктами в межах портфоліо.

date_fromstring (date)Обов’язково

Дата початку історичного періоду у форматі YYYY-MM-DD.

date_tostring (date)

Дата завершення історичного періоду у форматі YYYY-MM-DD.

history_groupingstring

Часовий інтервал, що використовується для групування історичних даних.

Дозволені значення:dailyweeklymonthly

За Замовчуванням:monthly

countrystring

Двобуквений код країни (ISO 3166-1 alpha-2).

Дозволені значення:adaeafagaialamaoarasatauawazba…

devicestring

Фільтрування за типом пристрою (DESKTOP, MOBILE, TABLET). Якщо не вказано, буде включено всі пристрої.

Дозволені значення:desktopmobiletablet

pagesstring

Список URL-адрес сторінок, розділених комами, для яких потрібно отримати історичні дані.

outputstring

Формат виводу.

Дозволені значення:jsoncsvxmlphp

metricsarray<object>

clicksinteger

ctrnumber (float)

datestring (date-time)

impressionsinteger

pagestring (url)

positionnumber (float)

Середня позиція (десяткове число, наприклад 4.7)