> ## 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.

# Análises

> Obtenha análises por plataforma e por post pela CLI

Os comandos de análises retornam métricas no nível da conta de uma plataforma conectada e métricas de desempenho
de um post individual. A saída é JSON por padrão; passe `--table` para uma visualização legível
ou encadeie o JSON com `jq` para uso em scripts.

## analytics:platform

Obtém as análises de uma seção de plataforma ou de uma conta social.

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

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

UUID da conta ou nome de uma plataforma (`facebook`, `instagram`, `linkedin`, `linkedin_page`,
`youtube`, `x`, `twitter`, `whatsapp`). Quando você informa o nome de uma plataforma, a CLI o resolve para
a primeira conta conectada dessa plataforma no seu espaço de trabalho.

**section** `string`

A seção de análises a buscar (por exemplo, `page`, `posts`, `videos`, `account`, `media`,
`stories`, `channel`, `content`). As seções variam por plataforma; veja a tabela abaixo. Omita-a
para ver as seções disponíveis de uma plataforma pelo nome ou para obter o resumo combinado da plataforma
quando o identificador é um UUID de conta.

| Opção | Descrição | Padrão |
| - | - | - |
| `-d, --days <number>` | Período retroativo em dias: `7`, `30` ou `90` | `7` |

### Seções disponíveis

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

> [!NOTE]
>
> Os aliases de plataforma são normalizados automaticamente antes de a requisição ser enviada: `twitter` é tratado como
> `x` e `linkedin_page` é tratado como `linkedin`.

### Como a resolução funciona

**1. Nome da plataforma + nenhuma seção**

A CLI exibe as seções disponíveis para essa plataforma e termina sem fazer nenhuma requisição.

```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 da conta + nenhuma seção**

A CLI busca o resumo combinado da plataforma no endpoint legado
`/v1/analytics/platform/:id`.

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

**3. Identificador + seção**

A CLI busca essa seção específica. Se a plataforma for conhecida, a seção é validada
em relação à tabela acima antes de a requisição ser feita.

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

### Exemplos

```bash theme={null}
# Ver as seções disponíveis de uma plataforma
so-me analytics:platform facebook

# Análises da página do Facebook dos últimos 30 dias
so-me analytics:platform facebook page --days 30

# Análises de mídia do Instagram dos últimos 7 dias (padrão)
so-me analytics:platform instagram media

# Análises do canal do YouTube dos últimos 90 dias
so-me analytics:platform youtube channel --days 90

# Análises da conta do Twitter / X (twitter é normalizado para x)
so-me analytics:platform twitter account

# Resumo combinado da plataforma pelo UUID da conta
so-me analytics:platform 550e8400-e29b-41d4-a716-446655440000 --days 30

# Análises de uma seção pelo UUID da conta
so-me analytics:platform 550e8400-e29b-41d4-a716-446655440000 posts --days 90

# Como tabela
so-me analytics:platform facebook page --days 30 --table
```

> [!WARNING]
>
> Informar uma seção inválida para uma plataforma conhecida (por exemplo, `so-me analytics:platform facebook
>   stories`) falha e exibe a lista de seções válidas dessa plataforma. Se você informar um UUID
> de conta que não está conectada no espaço de trabalho atual junto com uma seção, o comando também falha;
> execute `so-me accounts:list` para encontrar uma conta válida.

## analytics:post

Obtém as métricas de desempenho de um post específico pelo ID.

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

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

O UUID do post.

| Opção | Descrição | Padrão |
| - | - | - |
| `-d, --days <number>` | Período retroativo em dias: `7`, `30` ou `90` | `7` |

### Exemplos

```bash theme={null}
# Janela padrão de 7 dias
so-me analytics:post 550e8400-e29b-41d4-a716-446655440000

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

# Como tabela
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.