> ## Documentation Index
> Fetch the complete documentation index at: https://docs.catproxy.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Статистика

> Запрос статистики использования трафика по всем вашим прокси. Необходимое разрешение: stats:read.

<Info>
  Полные схемы запросов и ответов, а также возможность тестирования эндпоинтов доступны в [Swagger UI](https://api.catproxy.io/swagger/index.html).
</Info>

***

## Получить статистику трафика

Возвращает агрегированную статистику использования трафика аутентифицированного пользователя по всем прокси за указанный период.

```http theme={null}
GET /v1/user/traffic
```

**Параметры запроса**

| Параметр    | Тип    | Обязательный | Описание                              |
| :---------- | :----- | :----------- | :------------------------------------ |
| `date_from` | string | Да           | Начальная дата в формате `YYYY-MM-DD` |
| `date_to`   | string | Да           | Конечная дата в формате `YYYY-MM-DD`  |

**Разрешение:** `stats:read`

<CodeGroup>
  ```bash cURL theme={null}
  curl "https://api.catproxy.io/v1/user/traffic?date_from=2026-01-01&date_to=2026-12-31" \
    -H "X-API-Key: cat_YOUR_API_KEY"
  ```

  ```python Python theme={null}
  import requests

  r = requests.get(
      "https://api.catproxy.io/v1/user/traffic",
      headers={"X-API-Key": "cat_YOUR_API_KEY"},
      params={"date_from": "2026-01-01", "date_to": "2026-12-31"}
  )
  print(r.json())
  ```
</CodeGroup>

***

## Экспорт использования прокси (CSV)

Скачивает CSV-файл с разбивкой трафика и расходов по дням для конкретного прокси-листа. Удобно для сверки биллинга и мониторинга пайплайнов.

```http theme={null}
GET /v1/proxy/{id}/usage/export
```

**Параметры пути**

| Параметр | Тип    | Описание                             |
| :------- | :----- | :----------------------------------- |
| `id`     | string | ID прокси-листа (например, `86Rf07`) |

**Параметры запроса**

| Параметр    | Тип    | Обязательный | Описание                              |
| :---------- | :----- | :----------- | :------------------------------------ |
| `date_from` | string | Да           | Начальная дата в формате `YYYY-MM-DD` |
| `date_to`   | string | Да           | Конечная дата в формате `YYYY-MM-DD`  |

**Ответ:** файл `text/csv`.

**Разрешение:** `stats:read`

```bash theme={null}
curl "https://api.catproxy.io/v1/proxy/86Rf07/usage/export?date_from=2026-01-01&date_to=2026-12-31" \
  -H "X-API-Key: cat_YOUR_API_KEY" \
  -o proxy-usage-2026.csv
```