> ## Documentation Index
> Fetch the complete documentation index at: https://docs.so-me.studio/llms.txt
> Use this file to discover all available pages before exploring further.

# Analíticas

> Obtén analíticas a nivel de plataforma y por publicación desde la CLI

Los comandos de analíticas devuelven métricas a nivel de cuenta de una plataforma conectada y métricas de rendimiento
de una publicación concreta. La salida es JSON por defecto; pasa `--table` para una vista legible,
o encadena el JSON con `jq` para usarlo en scripts.

## analytics:platform

Obtiene las analíticas de una sección de plataforma o de una cuenta social.

```bash theme={null}
so-me analytics:platform <account-id-or-platform> [section] [options]
```

**account-id-or-platform** `string` *required*

UUID de la cuenta, o nombre de una plataforma (`facebook`, `instagram`, `linkedin`, `linkedin_page`,
`youtube`, `x`, `twitter`, `whatsapp`). Si indicas el nombre de una plataforma, la CLI lo resuelve a
la primera cuenta conectada de esa plataforma en tu espacio de trabajo.

**section** `string`

La sección de analíticas que se obtiene (por ejemplo `page`, `posts`, `videos`, `account`, `media`,
`stories`, `channel`, `content`). Las secciones dependen de la plataforma; consulta la tabla de abajo. Omítela
para ver las secciones disponibles de un nombre de plataforma, o para obtener el resumen combinado de la plataforma
cuando el identificador es un UUID de cuenta.

| Opción | Descripción | Por defecto |
| - | - | - |
| `-d, --days <number>` | Periodo de consulta en días: `7`, `30` o `90` | `7` |

### Secciones disponibles

| Plataforma | Identificador(es) | Secciones |
| - | - | - |
| Facebook | `facebook` | `page`, `posts`, `videos` |
| Instagram | `instagram` | `account`, `media`, `stories` |
| LinkedIn | `linkedin` | `page`, `posts` |
| Página de LinkedIn | `linkedin_page` | `page`, `posts` |
| YouTube | `youtube` | `channel`, `videos` |
| Twitter / X | `x`, `twitter` | `account`, `content` |
| WhatsApp | `whatsapp` | `account` |

> [!NOTE]
>
> Los alias de plataforma se normalizan automáticamente antes de enviar la solicitud: `twitter` se trata como
> `x`, y `linkedin_page` se trata como `linkedin`.

### Cómo funciona la resolución

**1. Nombre de plataforma sin sección**

La CLI imprime las secciones disponibles de esa plataforma y termina sin hacer ninguna solicitud.

```bash theme={null}
so-me analytics:platform facebook
```

```
  Available sections for Facebook:

  page
  posts
  videos

  Usage: so-me analytics:platform facebook <section> --days <number>
```

**2. UUID de cuenta sin sección**

La CLI obtiene el resumen combinado de la plataforma desde el endpoint heredado
`/v1/analytics/platform/:id`.

```bash theme={null}
so-me analytics:platform 550e8400-e29b-41d4-a716-446655440000 --days 30
```

**3. Identificador con sección**

La CLI obtiene esa sección concreta. Si la plataforma es conocida, la sección se valida
con la tabla anterior antes de hacer la solicitud.

```bash theme={null}
so-me analytics:platform instagram media --days 7
```

### Ejemplos

```bash theme={null}
# See available sections for a platform
so-me analytics:platform facebook

# Facebook page analytics for the last 30 days
so-me analytics:platform facebook page --days 30

# Instagram media analytics for the last 7 days (default)
so-me analytics:platform instagram media

# YouTube channel analytics for the last 90 days
so-me analytics:platform youtube channel --days 90

# Twitter / X account analytics (twitter is normalized to x)
so-me analytics:platform twitter account

# Combined platform summary by account UUID
so-me analytics:platform 550e8400-e29b-41d4-a716-446655440000 --days 30

# Section analytics by account UUID
so-me analytics:platform 550e8400-e29b-41d4-a716-446655440000 posts --days 90

# As a table
so-me analytics:platform facebook page --days 30 --table
```

> [!WARNING]
>
> Pasar una sección no válida para una plataforma conocida (por ejemplo `so-me analytics:platform facebook
>   stories`) falla e imprime la lista de secciones válidas de esa plataforma. Si pasas un UUID de cuenta
> que no está conectada en el espacio de trabajo actual junto con una sección, el comando también falla;
> ejecuta `so-me accounts:list` para encontrar una cuenta válida.

## analytics:post

Obtiene las métricas de rendimiento de una publicación concreta por su ID.

```bash theme={null}
so-me analytics:post <post-id> [options]
```

**post-id** `string` *required*

El UUID de la publicación.

| Opción | Descripción | Por defecto |
| - | - | - |
| `-d, --days <number>` | Periodo de consulta en días: `7`, `30` o `90` | `7` |

### Ejemplos

```bash theme={null}
# Default 7-day window
so-me analytics:post 550e8400-e29b-41d4-a716-446655440000

# Last 30 days
so-me analytics:post 550e8400-e29b-41d4-a716-446655440000 --days 30

# As a table
so-me analytics:post 550e8400-e29b-41d4-a716-446655440000 --days 90 --table
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.