Pipeline de API: quién vio tu tarjeta

Índice: Pipelines de API — índice

Objetivo: ver cuántas personas abrieron tu tarjeta, qué páginas vieron y de dónde llegaron.

Pasos

1. Leer las estadísticas (necesitas acceso de escritura a la tarjeta: su dueño o un editor).

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: los últimos 1, 7 y 30 días; timeline: una fila por día durante window_days (30 por defecto).
• pages: rutas vistas. Para un proyecto, su página y cada tarjeta que le pertenece; para cualquier otra tarjeta, su propia página.
• from: de dónde vino la visita: una ruta de cabi.chat, un dominio externo o "" = directo.
• sources: valores utm_source de las visitas ("" = ninguno).
• mentions (proyectos): tarjetas abiertas desde los enlaces de mención del proyecto.
• tile_shown / tile_opened: cuántas veces se mostró la tarjeta en listas y cuántas se abrió desde ahí.

En segundo plano

• Solo personas: no cuentan bots ni herramientas, ni tú ni el dueño de la tarjeta.
• Las visitas se registran desde 2026-10-08.

Reglas

• 401 sin token; 404 si la tarjeta no existe o no puedes editarla.

Superficie de la API