# Ventes et statistiques

> Référence générée depuis le contrat OpenAPI : Ventes et statistiques.

URL : https://docs.fanconvert.ai/fr/api/reference/ventes-et-statistiques

{/* Généré par scripts/generer-reference.mjs depuis openapi/public-v1.json : ne pas modifier à la main. */}

## Les ventes, par plateforme [#les-ventes-par-plateforme]

`GET /public/v1/sales` · `listSales`

### Paramètres [#paramètres]

| Nom | Où | Type | Requis | Description |
|---|---|---|---|---|
| `platform` | requête | "mym" \| "telegram" \| "onlyfans" \| "fanvue" | non |  (défaut : `mym`) |
| `creatorId` | requête | string \| null | non | Filtre. |
| `from` | requête | string (date-time) \| null | non | MYM seulement. |
| `to` | requête | string (date-time) \| null | non | MYM seulement. |
| `limit` | requête | integer | non | Taille de la page. (défaut : `50`) |
| `cursor` | requête | string \| null | non | Le `nextCursor` de la page précédente. |

### Réponse 200 [#réponse-200]

**`SalesPage`**

| Champ | Type | Requis | Description |
|---|---|---|---|
| `items` | Sale[] | oui |  |
| `nextCursor` | string \| null | non | À repasser en `cursor` pour lire la page suivante ; null = dernière page. |
| `platform` | "mym" \| "telegram" \| "onlyfans" \| "fanvue" | oui |  |
| `currency` | string | oui |  |
| `totalMinor` | integer \| null | non | Total de la période, quand la plateforme le donne. |

**`Sale`**

| Champ | Type | Requis | Description |
|---|---|---|---|
| `id` | string | oui |  |
| `platform` | "mym" \| "telegram" \| "onlyfans" \| "fanvue" | oui |  |
| `creatorId` | string | oui |  |
| `conversationId` | string \| null | oui |  |
| `at` | string (date-time) \| null | oui |  |
| `amountMinor` | integer | oui | Montant payé, en unité mineure de la devise (centimes ; Stars pour XTR). |
| `currency` | string | oui |  |
| `kind` | string \| null | non | Ce qui a été payé : média, pourboire, abonnement… |
| `refundedAt` | string (date-time) \| null | non |  |

### Erreurs possibles [#erreurs-possibles]

`401` · `403` · `404` · `422` · `429` · `503` — Format des erreurs : [Erreurs](/fr/api/rest/erreurs).

### Exemple [#exemple]

```bash
curl -X GET "https://app.fanconvert.ai/public/v1/sales" \
  -H "Authorization: Bearer $FANCONVERT_API_KEY"
```

## Revenus et envois par créatrice sur une période [#revenus-et-envois-par-créatrice-sur-une-période]

`GET /public/v1/statistics/creators` · `listCreatorStatistics`

### Paramètres [#paramètres-1]

| Nom | Où | Type | Requis | Description |
|---|---|---|---|---|
| `from` | requête | string (date-time) | oui |  |
| `to` | requête | string (date-time) | oui |  |
| `platform` | requête | "mym" \| "telegram" \| "onlyfans" \| "fanvue" | non |  (défaut : `mym`) |

### Réponse 200 [#réponse-200-1]

**`Page_CreatorStats_`**

| Champ | Type | Requis | Description |
|---|---|---|---|
| `items` | CreatorStats[] | oui |  |
| `nextCursor` | string \| null | non | À repasser en `cursor` pour lire la page suivante ; null = dernière page. |

**`CreatorStats`**

| Champ | Type | Requis | Description |
|---|---|---|---|
| `creatorId` | string | oui |  |
| `name` | string | oui |  |
| `platform` | string | oui |  |
| `currency` | string | oui |  |
| `revenueMinor` | integer | oui |  |
| `sales` | integer | oui |  |
| `messagesSent` | integer | oui |  |
| `paidMediaSent` | integer | oui |  |
| `freeMediaSent` | integer | oui |  |

### Erreurs possibles [#erreurs-possibles-1]

`401` · `403` · `404` · `422` · `429` · `503` — Format des erreurs : [Erreurs](/fr/api/rest/erreurs).

### Exemple [#exemple-1]

```bash
curl -X GET "https://app.fanconvert.ai/public/v1/statistics/creators" \
  -H "Authorization: Bearer $FANCONVERT_API_KEY"
```