Документация API YASTATIC

YASTATIC работает как промежуточный слой между вашими сервисами и API статистики Яндекса. Ниже приведено базовое описание протокола и основных эндпоинтов. Все примеры приведены для иллюстрации и могут отличаться от боевой конфигурации.

Базовый URL

https://api.mydomain.ru/v1/

Аутентификация

• Тип: заголовок X-YST-KEY
• Формат значения: псевдослучайная строка длиной 32–64 символа
• Ограничение: ключ привязан к набору IP-адресов заказчика

Типовые эндпоинты

/metrics/report

Прокси-запрос к отчётам Яндекс Метрики.

POST /v1/metrics/report
{
  "profile_id": 1234567,
  "date_from": "2024-01-01",
  "date_to": "2024-01-31",
  "dimensions": ["ym:s:referer"],
  "metrics": ["ym:s:visits", "ym:s:pageviews"]
}
    

/direct/stats

Доступ к агрегированной статистике кампаний Яндекс Директа.

GET /v1/direct/stats?campaign_id=111222333&date_from=2024-01-01&date_to=2024-01-07
    

Ограничения

• Лимиты запросов согласуются индивидуально.
• Запросы могут кешироваться на уровне шлюза.
• Список доступных профилей ограничивается договорённостями с заказчиком.

Подключение

Для подключения к YASTATIC обратитесь к ответственному администратору вашей организации. Публичная регистрация и автоматическая выдача ключей не поддерживаются.