Catproxy Developer Documentation

Полные схемы запросов и ответов, а также возможность тестирования эндпоинтов доступны в Swagger UI.

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

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

GET /v1/user/traffic

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

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

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

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"

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())

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

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

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

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

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

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

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

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