Позиции по дням

Метод API SerpWatch: позиции запросов по дням с URL, показами и кликами — до 50 000 строк за вызов.

GET/api/v1/projects/{id}/positions

Главный метод для отчётов. Возвращает позиции за период по одному региону: и данные Вебмастера (средняя позиция показа, показы, клики), и живую выдачу, и перенесённую историю. Источник указан в поле source.

Параметры

Параметр	Где	Что значит
`id`	в пути	id проекта
`region_id`	необязательно	id региона, по умолчанию первый
`date_from`	необязательно	начало периода, ГГГГ-ММ-ДД, по умолчанию 30 дней назад
`date_to`	необязательно	конец периода, по умолчанию сегодня; период не больше года
`keyword_id`	необязательно	только один запрос
`limit`	необязательно	строк за вызов, до 50 000
`offset`	необязательно	сдвиг для постраничной загрузки

Ответ

Поле	Что значит
`keyword_id`	id запроса
`date`	дата
`source`	webmaster, serp или import
`position`	позиция или null, если сайта нет в топ-100
`url`	страница сайта в выдаче
`impressions`	показы (только webmaster)
`clicks`	клики (только webmaster)

[
  {
    "keyword_id": 501,
    "date": "2026-10-05",
    "source": "serp",
    "position": 4,
    "url": "https://site.ru/akpp",
    "impressions": null,
    "clicks": null
  }
]

Примеры

curl

curl -H "Authorization: Bearer sw_ваш_токен" \
  "https://serpwatch.ru/api/v1/projects/12/positions?date_from=2026-09-01&date_to=2026-09-30"

Python

import requests

r = requests.get("https://serpwatch.ru/api/v1/projects/12/positions",
                 headers={"Authorization": "Bearer sw_ваш_токен"}, timeout=60)
print(r.json())

Ошибки

400 — период больше года. Общие коды и лимит 120 запросов в минуту — в разделе ошибки и лимиты.

Для чего пригодится

Отчёт клиенту в Google Таблицах или Looker Studio
Свой алерт на падение позиций