Référence
Ventes et statistiques
Référence générée depuis le contrat OpenAPI : Ventes et statistiques.
Les ventes, par plateforme
GET /public/v1/sales · listSales
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
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
401 · 403 · 404 · 422 · 429 · 503 — Format des erreurs : Erreurs.
Exemple
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
GET /public/v1/statistics/creators · listCreatorStatistics
Paramètres
| 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
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
401 · 403 · 404 · 422 · 429 · 503 — Format des erreurs : Erreurs.
Exemple
curl -X GET "https://app.fanconvert.ai/public/v1/statistics/creators" \
-H "Authorization: Bearer $FANCONVERT_API_KEY"Mis à jour le