Roistat REST API: Забирать заявки и звонки с источниками

Сценарий из mcp-everything. Актуально на 2026-10-24.

Прокси-лиды и звонки коллтрекинга с привязкой к визиту и рекламному источнику.

Заявки за период: GET /project/proxy-leads с period в формате YYYY-MM-DD-YYYY-MM-DD. В ответе name, phone, email, roistat (визит) и order_id. Время — UTC.
Звонки: POST /project/calltracking/call/list с filters по дате, limit и extend = ["visit", "order"], чтобы сразу получить визит и сделку. В записи есть link — ссылка на запись разговора.
Номера коллтрекинга и их настройки — POST /project/calltracking/phone/list.
Полная цепочка визитов по конкретной сделке — GET /project/orders/{orderId}/info.

curl -G "https://cloud.roistat.com/api/v1/project/proxy-leads" \
  -H "Api-key: $ROISTAT_KEY" -d project=12345 -d period=2026-10-01-2026-10-23

curl -X POST "https://cloud.roistat.com/api/v1/project/calltracking/call/list?project=12345" \
  -H "Api-key: $ROISTAT_KEY" -H 'Content-Type: application/json' \
  -d '{"filters": {"and": [["date", ">", "2026-10-01T00:00:00+0000"]]}, "limit": 100, "extend": ["visit", "order"]}'

Базовые URL

Боевой: https://cloud.roistat.com/api/v1

Авторизация

Тип: API-ключ

Ключ API (один на пользователя, действует для всех его проектов) берётся в профиле: https://cloud.roistat.com/user/profile/api. Передаётся в заголовке Api-key (рекомендуется; параметр key в URL небезопасен). Номер проекта — в параметре project строки запроса; без него работают только /user/projects и /account/project/create.

curl 'https://cloud.roistat.com/api/v1/project/proxy-leads?project=12345&period=2021-07-07-2021-09-24' \
    --request GET \
    --header 'Content-type: application/json' \
    --header 'Api-key: {KEY}'

Методы сценария

GET /project/orders/{orderId}/info — Подробности сделки

Данные сделки, товары и полная цепочка визитов.

Параметр	Где	Тип	Обяз.	Описание
`orderId`	path	string	да	ID сделки
`project`	query	string	да	Номер проекта

GET /project/proxy-leads — Прокси-лиды за период

В ответе ProxyLeads[]: id, title, text, name, phone, email, roistat (визит), creation_date (UTC0), order_id.

Параметр	Где	Тип	Обяз.	Описание
`project`	query	string	да	Номер проекта
`period`	query	string	да	Период YYYY-MM-DD-YYYY-MM-DD

POST /project/calltracking/call/list — История звонков

Чтобы получить визит и сделку для каждого звонка, добавьте visit и order в extend. В записи звонка: id, caller, callee, duration, status, date, link (запись), visit_id, order_id.

Параметр	Где	Тип	Обяз.	Описание
`project`	query	string	да	Номер проекта
`filters`	body	object	нет	Фильтры (например, по диапазону дат в and)
`sort`	body	array	нет	Сортировка
`limit`	body	integer	нет	Число записей
`offset`	body	integer	нет	Смещение
`extend`	body	array	нет	visit, order

POST /project/calltracking/phone/list — Номера коллтрекинга

Параметр	Где	Тип	Обяз.	Описание
`project`	query	string	да	Номер проекта
`filters`	body	object	нет	Фильтры
`limit`	body	integer	нет	Число записей
`offset`	body	integer	нет	Смещение

Нюансы

По умолчанию все методы — POST; GET допускается для методов, оканчивающихся на /list, и для отдельных ресурсов (проекты, прокси-лиды, детали сделки).
Тело — JSON или XML; поддерживается CORS; время по умолчанию — UTC+0.
По умолчанию все ответы, включая ошибки, приходят с HTTP 200; заголовок Use-Http-Code: 1 включает реальные HTTP-коды.
Ответы содержат data, total, status.
Список сделок с extend: visit: при limit больше 1000 — 1 запрос в минуту, больше 100 — 5, меньше 100 — 10; без extend — 20 в минуту.

Другие сценарии

Если этого недостаточно — официальная документация: https://help-en.roistat.com/API/methods/about/ Вся интеграция одним документом: https://mcp-everything.ru/integrations/roistat.md