# API Яндекс Метрики: GET /management/v1/counters — Список счётчиков

В ответе: `rows` (всего счётчиков) и `counters[]` (`id`, `name`, `status`, `type`, `owner_login`, `permission` и др.).

| Параметр | Где | Тип | Обяз. | Описание |
|---|---|---|---|---|
| `counter_ids` | query | array | нет | ID счётчиков, которые нужно вернуть |
| `favorite` | query | boolean | нет | Только избранные, по умолчанию false |
| `field` | query | string | нет | Доп. поля: goals,mirrors,grants,filters,operations,counter_flags,measurement_tokens |
| `label_id` | query | integer | нет | Фильтр по метке |
| `offset` | query | integer | нет | Номер первого элемента (с 1), по умолчанию 1 |
| `per_page` | query | integer | нет | Счётчиков в ответе, по умолчанию 1000, максимум 10 000 |
| `permission` | query | string | нет | own, view, edit; можно несколько через запятую |
| `search_string` | query | string | нет | Поиск по ID, названию, адресу сайта |
| `sort` | query | string | нет | None, Default, Visits, Hits, Uniques, Name |
| `status` | query | string | нет | Active (по умолчанию) или Deleted |
| `type` | query | string | нет | simple или partner |

## Базовые URL

- Боевой: `https://api-metrika.yandex.net`

## Авторизация

Тип: OAuth 2.0

OAuth-токен Яндекса передаётся в заголовке `Authorization` в каждом запросе. Без токена или с недействительным токеном сервер отвечает `401`.

```
Authorization: OAuth <токен>
```

## Нюансы

- Префиксы метрик и группировок: `ym:s:` — визиты, `ym:pv:` — хиты; смешивать их в одном запросе нельзя.
- Социально-демографические данные выдаются только при выборке больше 10 посетителей; признак ограничения — `contains_sensitive_data: true`.
- Logs API: период запроса — не больше 1 года, `date2` не может быть текущим днём, фильтрации на уровне запроса нет.
- Поток выгрузки логов: `evaluate` → создание запроса → опрос статуса до `processed` → скачивание частей → `clean`.
- Ограничения фильтров отчётов: до 20 фильтров, до 10 000 символов в строке, до 100 значений в одном условии.

## Сценарии с этим методом

- [Получить посещаемость и источники трафика за период](https://mcp-everything.ru/integrations/yandex-metrika/scenarios/poluchit-poseschaemost-i-istochniki.md)

---

Если этого недостаточно — официальная документация: https://yandex.ru/dev/metrika/ru/
Вся интеграция одним документом: https://mcp-everything.ru/integrations/yandex-metrika.md