API-пайплайн: кто смотрел вашу карточку

Индекс: API-пайплайны — индекс

Цель: узнать, сколько людей открыли вашу карточку, какие страницы они смотрели и откуда пришли.

Шаги

1. Получить статистику (нужен доступ на запись к карточке: владелец или редактор).

GET /v0/my/cards/{nonce | @handle}/stats?window_days=30
→ {"day":   {"views": 28,  "people": 11},
   "week":  {"views": 177, "people": 67},
   "month": {"views": 191, "people": 69},
   "timeline": [{"day": "2026-10-09", "views": 9, "people": 6}, …],
   "pages":    [{"key": "/@example-handle", "views": 32, "people": 18}, …],
   "from":     [{"key": "", "views": 77, "people": 49}, {"key": "/", "views": 24, "people": 14}, …],
   "sources":  [{"key": "telegram", "views": 5, "people": 4}, …],
   "mentions": [{"key": "article/470000000000000002", "views": 1, "people": 1}],
   "tile_shown": 36, "tile_opened": 4}

• day / week / month: последние 1, 7 и 30 дней; timeline: строка на каждый день за window_days (по умолчанию 30).
• pages: просмотренные пути. Для проекта — его страница и все карточки, которые ему принадлежат; для любой другой карточки — её страница.
• from: откуда пришёл просмотр: путь на cabi.chat, внешний домен или "" = напрямую.
• sources: значения utm_source визитов ("" = нет).
• mentions (проекты): карточки, открытые по ссылкам-упоминаниям проекта.
• tile_shown / tile_opened: сколько раз плитку карточки показали в списках и открыли оттуда.

За кадром

• Только люди: боты и инструменты не учитываются, как и вы сами и владелец карточки.
• Визиты записываются с 2026-10-08.

Правила

• 401 без токена; 404, если карточка неизвестна или вам нельзя её редактировать.

Поверхность API