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

# Analyses

> Récupérez les analyses par plateforme et par publication depuis la CLI

Les commandes d'analyse renvoient les métriques au niveau du compte pour une plateforme connectée et les métriques de performance
d'une publication individuelle. La sortie est en JSON par défaut — ajoutez `--table` pour une vue lisible,
ou transmettez le JSON à `jq` pour vos scripts.

## analytics:platform

Récupère les analyses d'une section de plateforme ou d'un compte social.

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

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

UUID du compte, ou nom de plateforme (`facebook`, `instagram`, `linkedin`, `linkedin_page`,
`youtube`, `x`, `twitter`, `whatsapp`). Lorsque vous indiquez un nom de plateforme, la CLI le résout vers
le premier compte connecté de cette plateforme dans votre espace de travail.

**section** `string`

La section d'analyses à récupérer (par exemple `page`, `posts`, `videos`, `account`, `media`,
`stories`, `channel`, `content`). Les sections dépendent de la plateforme — voir le tableau ci-dessous. Omettez-la
pour voir les sections disponibles pour un nom de plateforme, ou pour récupérer le résumé combiné de la plateforme
lorsque l'identifiant est un UUID de compte.

| Option | Description | Par défaut |
| - | - | - |
| `-d, --days <number>` | Période d'analyse en jours : `7`, `30` ou `90` | `7` |

### Sections disponibles

| Plateforme | Identifiant(s) | Sections |
| - | - | - |
| Facebook | `facebook` | `page`, `posts`, `videos` |
| Instagram | `instagram` | `account`, `media`, `stories` |
| LinkedIn | `linkedin` | `page`, `posts` |
| Page LinkedIn | `linkedin_page` | `page`, `posts` |
| YouTube | `youtube` | `channel`, `videos` |
| Twitter / X | `x`, `twitter` | `account`, `content` |
| WhatsApp | `whatsapp` | `account` |

> [!NOTE]
>
> Les alias de plateforme sont normalisés automatiquement avant l'envoi de la requête : `twitter` est traité comme
> `x`, et `linkedin_page` comme `linkedin`.

### Fonctionnement de la résolution

**1. Nom de plateforme sans section**

La CLI affiche les sections disponibles pour cette plateforme et se termine sans effectuer de requête.

```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 compte sans section**

La CLI récupère le résumé combiné de la plateforme depuis l'ancien
endpoint `/v1/analytics/platform/:id`.

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

**3. Identifiant avec section**

La CLI récupère cette section précise. Si la plateforme est connue, la section est validée
par rapport au tableau ci-dessus avant l'envoi de la requête.

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

### Exemples

```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]
>
> Indiquer une section invalide pour une plateforme connue (par exemple `so-me analytics:platform facebook
>   stories`) échoue et affiche la liste des sections valides pour cette plateforme. Si vous indiquez un UUID de compte
> non connecté dans l'espace de travail actuel avec une section, la commande échoue également
> — exécutez `so-me accounts:list` pour trouver un compte valide.

## analytics:post

Récupère les métriques de performance d'une publication précise à partir de son ID.

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

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

L'UUID de la publication.

| Option | Description | Par défaut |
| - | - | - |
| `-d, --days <number>` | Période d'analyse en jours : `7`, `30` ou `90` | `7` |

### Exemples

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