analíticas

accede a estadísticas de posts y datos de rendimiento de engagement. rastrea likes, comentarios, compartidos e impresiones en todas las plataformas conectadas.

get_post_stats

recupera estadísticas agregadas de posts para un workspace. devuelve conteos por estado (borrador, programado, publicado, fallido).

> ¿cuántos posts tengo?
  using antwork.get_post_stats

  [done] estadísticas obtenidas
  [info] 5 borradores, 3 programados, 12 publicados, 1 fallido
parámetros
workspace_idstringopcional
id o nombre del workspace. opcional si el usuario solo tiene uno

get_performance

obtén métricas de engagement DE POR VIDA de cada post publicado. para engagement histórico por día (ej. "qué pasó la última semana"), usa get_engagement_history en su lugar.

> ¿cómo rinden mis posts de por vida?
  using antwork.get_performance

  [done] 15 posts publicados
  [info] 234 likes, 45 comentarios, 12 compartidos
parámetros
workspace_idstringopcional
id o nombre del workspace. opcional si el usuario solo tiene uno
limitnumberopcional
máximo de posts (por defecto: 30, máx: 50)

get_engagement_history

obtén el engagement histórico día a día del workspace para los últimos N días. devuelve el engagement REAL que ocurrió ese día — no totales de por vida atribuidos al día de publicación. calculado a partir de snapshots diarios de métricas acumuladas.

> ¿cuántas impresiones tuve la semana pasada?
  using antwork.get_engagement_history

  [done] 7 días de datos
  [info] esta semana: 12k impresiones · semana pasada: 8k
parámetros
workspace_idstringopcional
id o nombre del workspace. opcional si el usuario solo tiene uno
daysnumberopcional
ventana en días (1–365, por defecto 30, incluye hoy)

get_post_history

obtén las métricas históricas día a día de un post específico. cada fila contiene los totales acumulados a esa fecha y los deltas (engagement ganado ESE día) por plataforma. ideal para "cómo creció este post" o "¿dejó de ganar likes?".

> ¿cómo creció mi post del 10 de marzo en los primeros 7 días?
  using antwork.get_post_history

  [done] 7 filas de historial
  [info] día pico: 11 mar · +8 likes, +2 comentarios
parámetros
post_idstringrequerido
el id del post del que obtener el historial
daysnumberopcional
ventana opcional en días (1–365). omite para historial completo.