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

# Analysen

> Analysen auf Plattformebene und pro Beitrag in der CLI abrufen

Die Analysebefehle liefern Kennzahlen auf Kontoebene für eine verbundene Plattform und Leistungskennzahlen für einen einzelnen Beitrag. Die Ausgabe ist standardmäßig JSON — übergib `--table` für eine lesbare Ansicht oder leite das JSON für Skripte an `jq` weiter.

## analytics:platform

Ruft Analysen für einen Plattformbereich oder ein Social-Konto ab.

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

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

Konto-UUID oder Plattformname (`facebook`, `instagram`, `linkedin`, `linkedin_page`, `youtube`, `x`, `twitter`, `whatsapp`). Wenn du einen Plattformnamen angibst, löst die CLI ihn in das erste verbundene Konto dieser Plattform in deinem Workspace auf.

**section** `string`

Der abzurufende Analysebereich (zum Beispiel `page`, `posts`, `videos`, `account`, `media`, `stories`, `channel`, `content`). Die Bereiche sind plattformspezifisch — siehe die Tabelle unten. Lass ihn weg, um die verfügbaren Bereiche für einen Plattformnamen zu sehen, oder um die kombinierte Plattformübersicht abzurufen, wenn die Kennung eine Konto-UUID ist.

| Option | Beschreibung | Standard |
| - | - | - |
| `-d, --days <number>` | Rückblickzeitraum in Tagen: `7`, `30` oder `90` | `7` |

### Verfügbare Bereiche

| Plattform | Kennung(en) | Bereiche |
| - | - | - |
| Facebook | `facebook` | `page`, `posts`, `videos` |
| Instagram | `instagram` | `account`, `media`, `stories` |
| LinkedIn | `linkedin` | `page`, `posts` |
| LinkedIn-Seite | `linkedin_page` | `page`, `posts` |
| YouTube | `youtube` | `channel`, `videos` |
| Twitter / X | `x`, `twitter` | `account`, `content` |
| WhatsApp | `whatsapp` | `account` |

> [!NOTE]
>
> Plattform-Aliase werden vor dem Senden der Anfrage automatisch normalisiert: `twitter` wird als `x` behandelt und `linkedin_page` als `linkedin`.

### Wie die Auflösung funktioniert

**1. Plattformname ohne Bereich**

Die CLI gibt die verfügbaren Bereiche für diese Plattform aus und beendet sich, ohne eine Anfrage zu stellen.

```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. Konto-UUID ohne Bereich**

Die CLI ruft die kombinierte Plattformübersicht vom Legacy-Endpunkt
`/v1/analytics/platform/:id` ab.

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

**3. Kennung mit Bereich**

Die CLI ruft genau diesen Bereich ab. Ist die Plattform bekannt, wird der Bereich vor der Anfrage anhand der obigen Tabelle validiert.

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

### Beispiele

```bash theme={null}
# Verfügbare Bereiche einer Plattform ansehen
so-me analytics:platform facebook

# Facebook-Seitenanalysen der letzten 30 Tage
so-me analytics:platform facebook page --days 30

# Instagram-Medienanalysen der letzten 7 Tage (Standard)
so-me analytics:platform instagram media

# YouTube-Kanalanalysen der letzten 90 Tage
so-me analytics:platform youtube channel --days 90

# Twitter-/X-Kontoanalysen (twitter wird zu x normalisiert)
so-me analytics:platform twitter account

# Kombinierte Plattformübersicht per Konto-UUID
so-me analytics:platform 550e8400-e29b-41d4-a716-446655440000 --days 30

# Bereichsanalysen per Konto-UUID
so-me analytics:platform 550e8400-e29b-41d4-a716-446655440000 posts --days 90

# Als Tabelle
so-me analytics:platform facebook page --days 30 --table
```

> [!WARNING]
>
> Gibst du für eine bekannte Plattform einen ungültigen Bereich an (zum Beispiel `so-me analytics:platform facebook
>   stories`), schlägt der Aufruf fehl und die Liste der gültigen Bereiche dieser Plattform wird ausgegeben. Gibst du zusammen mit einem Bereich eine Konto-UUID an, die im aktuellen Workspace nicht verbunden ist, schlägt der Befehl ebenfalls fehl — führe `so-me accounts:list` aus, um ein gültiges Konto zu finden.

## analytics:post

Ruft Leistungskennzahlen für einen bestimmten Beitrag über seine ID ab.

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

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

Die UUID des Beitrags.

| Option | Beschreibung | Standard |
| - | - | - |
| `-d, --days <number>` | Rückblickzeitraum in Tagen: `7`, `30` oder `90` | `7` |

### Beispiele

```bash theme={null}
# Standardzeitraum von 7 Tagen
so-me analytics:post 550e8400-e29b-41d4-a716-446655440000

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

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