---
metadata:
  - name: generator
    content: Diplodoc Platform v5.48.2
alternate:
  - https://www.yandex.com/dev/metrika/en/logs/practice/quick-start.md
  - https://www.yandex.com/dev/metrika/ru/logs/practice/quick-start.md
---
> **Documentation Index:** Fetch the complete configuration index at https://www.yandex.com/dev/metrika/ru/llms.txt

# Сценарий работы с Logs API

1. Чтобы создать логи, выполните запрос [POST https://api-metrika.yandex.net/management/v1/counter/{counterId}/logrequests](https://www.yandex.com/dev/metrika/ru/logs/openapi/createLogRequest.md).

    Вы можете оценить возможность выгрузки данных с помощью запроса [GET https://api-metrika.yandex.net/management/v1/counter/{counterId}/logrequests/evaluate](https://www.yandex.com/dev/metrika/ru/logs/openapi/evaluate.md), если не уверены, что его удастся выгрузить.

    {% note info "Ограничение" %}

    В одном запросе можно запрашивать данные за период не более 1 года. Подробнее см. раздел [Ограничения](https://www.yandex.com/dev/metrika/ru/logs/index.md#restrictions).

    {% endnote %}

2. После успешного выполнения запроса на создание логов сохраните `request_id` и дождитесь подготовки лога. Узнать статус обработки лога можно с помощью запроса [GET https://api-metrika.yandex.net/management/v1/counter/{counterId}/logrequest/{requestId}](https://www.yandex.com/dev/metrika/ru/logs/openapi/getLogRequest.md).

3. Лог со статусом `processed` готов к выгрузке. Для выгрузки используйте запрос [GET https://api-metrika.yandex.net/management/v1/counter/{counterId}/logrequest/{requestId}/part/{partNumber}/download](https://www.yandex.com/dev/metrika/ru/logs/openapi/download.md).

4. После выгрузки очистите подготовленные для загрузки логи, чтобы освободить место для следующих запросов. Для этого выполните запрос [POST https://api-metrika.yandex.net/management/v1/counter/{counterId}/logrequest/{requestId}/clean](https://www.yandex.com/dev/metrika/ru/logs/openapi/clean.md).

Нагрузка на сервис в разное время может различаться, если вам не удалось выгрузить данные, попробуйте позже или в другое время суток. Все запросы выполняются по очереди — каждый новый запрос попадает в конец очереди. Если ваш запрос находится в статусе `created`, дождитесь его выполнения.