API App Store Connect
Numéro de fournisseur App Store Connect et API salesReports
Chaque requête de rapport de ventes à l’API App Store Connect exige un numéro que la plupart des développeurs n’ont jamais regardé : le numéro de fournisseur. Voici où il se trouve, quelle clé peut l’utiliser et comment transformer `GET /v1/salesReports` en ventes par pays réellement exploitables.
Où trouver votre numéro de fournisseur App Store Connect
Votre numéro de fournisseur se trouve dans Paiements et rapports financiers. Connectez-vous à App Store Connect, ouvrez Paiements et rapports financiers, sélectionnez Rapports en haut de la page : le numéro apparaît dans le coin supérieur gauche, sous le nom de votre entité juridique. L’API l’attend sous la forme filter[vendorNumber] (aide d’Apple).
- Connectez-vous à App Store Connect avec le rôle Titulaire du compte, Admin ou Finance — les rôles qu’Apple indique pour Paiements et rapports financiers.
- Ouvrez Paiements et rapports financiers.
- Sélectionnez Rapports en haut de la page.
- Lisez le numéro de fournisseur sous le nom de votre entité juridique, en haut à gauche, et copiez-le.
Deux raccourcis. Si vous avez déjà téléchargé un rapport de ventes depuis Tendances → Rapports Ventes et tendances, le numéro de fournisseur figure dans le nom du fichier : les fichiers Summary quotidiens s’appellent S_D_<vendor number>_<date>, par exemple S_D_80012345_20130919 (noms des fichiers de rapport). Et si vous n’avez que le rôle Sales, demandez à quelqu’un ayant le rôle Admin ou Finance de le lire pour vous, car il s’affiche sur la page financière.
Plusieurs numéros de fournisseur
Le menu à côté du nom de votre fournisseur peut lister plusieurs numéros. Apple en attribue un nouveau quand vous changez le nom de votre entité juridique, et des numéros distincts pour les accords Apple News+ ou Apple Arcade. Les rapports sont séparés par numéro de fournisseur : après un changement de raison sociale, il vous faut le nouveau numéro pour les nouvelles ventes et l’ancien pour l’historique.
Quels rôles peuvent lire les rapports de ventes
Deux permissions différentes entrent en jeu : voir le numéro de fournisseur (Paiements et rapports financiers) et lire Ventes et tendances. La clé API qui télécharge les rapports a besoin de la seconde. D’après les autorisations par rôle et les pages d’aide d’Apple :
| Rôle | Rapports Ventes et tendances | Paiements et rapports financiers | Modifier les prix |
|---|---|---|---|
| Admin | Oui | Oui | Oui |
| Finance | Oui | Oui | Non |
| Sales | Oui | Non | Non |
| App Manager | Non mentionné par Apple | Non | Oui |
| Developer, Marketing, Customer Support | Non | Non | Non |
Apple suggère le rôle Sales (sa documentation API l’appelle Sales and Reports) pour une clé confiée à un tiers qui se contente d’analyser les rapports : elle peut appeler GET /v1/salesReports mais pas le point d’accès des rapports financiers (remarque d’Apple). Si une même clé doit à la fois lire les ventes et modifier les prix, le seul rôle de clé qui fait les deux est Admin. L’alternative est d’avoir deux clés — App Manager pour les prix, Sales pour les rapports — plus propre si votre outil le permet. La création de l’une ou l’autre est expliquée dans créer une clé API.
Les types de rapports Ventes et tendances
GET /v1/salesReports sert tous les rapports Ventes et tendances téléchargeables. Chaque type n’accepte que certaines combinaisons de sous-type, de fréquence et de version ; toute autre combinaison est une erreur. Les combinaisons valides, d’après la référence du point d’accès d’Apple :
| reportType | reportSubType | frequency | version |
|---|---|---|---|
SALES | SUMMARY | DAILY, WEEKLY, MONTHLY, YEARLY | 1_0 |
PRE_ORDER | SUMMARY | DAILY, WEEKLY, MONTHLY, YEARLY | 1_0 |
SUBSCRIPTION | SUMMARY | DAILY | 1_3 |
SUBSCRIPTION_EVENT | SUMMARY | DAILY | 1_3 |
SUBSCRIBER | DETAILED | DAILY | 1_3 |
SUBSCRIPTION_OFFER_CODE_REDEMPTION | SUMMARY | DAILY | 1_0 |
WIN_BACK_ELIGIBILITY | SUMMARY | DAILY | 1_0 |
NEWSSTAND | DETAILED | DAILY, WEEKLY | 1_0 |
FIRST_ANNUAL | DETAILED / SUMMARY | DAILY / YEARLY | 1_0 |
Pour les ventes par pays, celui qu’il vous faut est SALES / SUMMARY : unités, prix et produits agrégés pour les apps et les achats intégrés, une ligne par produit, pays, prix et type de transaction. La fréquence quotidienne est la plus utile, car on peut reconstituer n’importe quelle période à partir des jours, et ce sont les jours qu’il faut pour voir l’effet d’un changement de prix.
Télécharger un rapport de ventes avec GET /v1/salesReports
| Paramètre | Obligatoire | Valeur pour un rapport de ventes quotidien | Remarques |
|---|---|---|---|
filter[vendorNumber] | Oui | 85012345 (le vôtre) | Dans Paiements et rapports financiers. |
filter[reportType] | Oui | SALES | Voir le tableau ci-dessus pour les autres types. |
filter[reportSubType] | Oui | SUMMARY | Doit correspondre au type de rapport. |
filter[frequency] | Oui | DAILY | DAILY, WEEKLY, MONTHLY ou YEARLY. |
filter[reportDate] | Non | 2026-11-09 | Apple documente le format YYYY-MM-DD et indique que DAILY n’exige pas de date. Envoyez-en une quand même pour savoir quel jour vous avez reçu. |
filter[version] | Non | 1_0 | La version qu’Apple indique pour le type de rapport. |
- Créez une clé API d’équipe avec le rôle Admin, Finance ou Sales, et conservez son Issuer ID, son Key ID et son fichier
.p8. - Signez un JWT avec la clé (génération des jetons). Pour la plupart des requêtes, Apple rejette les jetons valables plus de 20 minutes : générez-en un nouveau par lot.
- Demandez le jour :
GET https://api.appstoreconnect.apple.com/v1/salesReports?filter[frequency]=DAILY&filter[reportType]=SALES&filter[reportSubType]=SUMMARY&filter[vendorNumber]=85012345&filter[reportDate]=2026-11-09&filter[version]=1_0, avecAuthorization: Bearer <token>etAccept: application/a-gzip. Encodez les crochets dans l’URL si votre client HTTP ne le fait pas. - Le corps de la réponse 200 est au format gzip (
application/a-gzip). Décompressez-le — avec curl, enregistrez dans un fichier et lancezgunzipdessus. - Vous obtenez alors du texte séparé par des tabulations : une ligne d’en-tête, puis une ligne par produit, pays, prix et type de transaction. Analysez les colonnes par nom d’en-tête, pas par position.
- Stockez le jour. Apple ne conserve les rapports quotidiens qu’un an : tout ce que vous voulez comparer d’une année sur l’autre doit être sauvegardé de votre côté.
- Répétez pour chaque jour nécessaire, en vous modérant : chaque réponse contient un en-tête
X-Rate-Limitindiquant vos requêtes horaires restantes (limites de débit).
Les rapports hebdomadaires, mensuels et annuels fonctionnent de la même façon avec une autre fréquence. Dans les exemples de noms de fichiers d’Apple, un rapport hebdomadaire est daté d’un dimanche, et les fichiers mensuels et annuels n’indiquent que le mois ou l’année, ce qui permet de vérifier la période reçue. Rappelez-vous que la somme de 30 fichiers quotidiens vous donne un mois que vous pouvez découper comme vous voulez ; un fichier mensuel ne vous donne pas les jours.
Le format du fichier et les colonnes utiles
La référence des champs du rapport Summary Sales documente chaque colonne (elle décrit la version 1_3 de la disposition ; Apple ajoute des colonnes avec le temps, une raison de plus pour s’appuyer sur les noms d’en-tête). Celles qu’il vous faut pour les ventes par pays :
| Colonne | Contenu | À quoi elle sert |
|---|---|---|
| Apple Identifier | L’identifiant Apple de l’app ou de l’achat intégré | Faire le lien avec vos produits dans l’API |
| SKU / Parent Identifier | Votre SKU ; pour les achats intégrés, Parent Identifier est le SKU de l’app | Regrouper les achats intégrés sous leur app |
| Title | Nom de l’app pour les téléchargements, identifiant du produit pour les achats intégrés | Libellés |
| Product Type Identifier | Le type de transaction, comme 1F ou IAY | Séparer téléchargements, achats, mises à jour et re-téléchargements |
| Units | Unités agrégées ; négatives pour les remboursements | Compter téléchargements et achats |
| Developer Proceeds | Ce que vous recevez par unité, après taxes et commission d’Apple | Produits = Units × Developer Proceeds |
| Customer Price / Customer Currency | Le prix par unité facturé au client, et sa devise | Vérifier le prix réellement payé |
| Country Code | Code à deux lettres du pays ou de la région de l’App Store de l’achat | La ventilation par pays |
| Currency of Proceeds | La devise du montant Developer Proceeds | Convertir avant de comparer les pays |
| Subscription / Period | Nouveau ou renouvellement, et durée de l’abonnement | Distinguer les nouveaux abonnés des renouvellements |
Les identifiants de type de produit classent les lignes (liste complète) : 1, 1F, 1T et F1 sont des téléchargements d’app, gratuits ou payants ; 3 et 3F des re-téléchargements ; 7, 7F, 7T et F7 des mises à jour ; IA1, IA9, IAY, FI1 et leurs variantes -M des achats intégrés et des abonnements ; IA3 un non consommable restauré.
- Developer Proceeds est par unité. Multipliez par Units avant d’additionner les lignes.
- Les remboursements ont des Units négatives et des Developer Proceeds positifs : Units × Developer Proceeds les soustrait donc correctement.
- Excluez mises à jour et re-téléchargements avant de compter les téléchargements — ils sont gratuits et dépassent souvent de loin les vrais téléchargements.
- Un même produit et un même pays peuvent apparaître sur plusieurs lignes (prix, appareils, codes promo différents). Additionnez-les.
- Les jours vont de minuit à minuit, heure du Pacifique, pas en UTC.
- Les montants sont en devises locales. Convertissez avec un seul jeu de taux avant de classer les pays ; les ventes par pays détaille une comparaison équitable.
Quand les rapports sont prêts et combien de temps ils restent
D’après la page de disponibilité d’Apple : les rapports quotidiens sont disponibles le lendemain, les hebdomadaires le lundi, les mensuels cinq jours après la fin du mois et les annuels six jours après la fin de l’année, en général avant 8 h, heure du Pacifique. Les rapports quotidiens, hebdomadaires et mensuels sont conservés un an ; les annuels dix ans. Un rapport Summary Sales n’existe que pour une période où au moins une unité d’app a été vendue : un jour calme n’a simplement pas de fichier.
Erreurs courantes de salesReports
| Réponse | Ce que cela signifie en général | Que faire |
|---|---|---|
400 PARAMETER_ERROR.REQUIRED | Un filtre obligatoire manque, par ex. « The parameter 'filter[vendorNumber]' is required but was not provided » | Envoyez les quatre filtres obligatoires. |
| 400 (autre) | Une combinaison qu’Apple ne propose pas — sous-type, fréquence ou version incompatible avec le type de rapport | Vérifiez vos valeurs avec le tableau des valeurs autorisées ci-dessus. |
401 NOT_AUTHORIZED | Le jeton est mal formé, expiré ou signé avec une clé révoquée | Générez un nouveau jeton ; vérifiez que Key ID, Issuer ID et .p8 vont ensemble. |
| 403 | Le rôle de la clé ne peut pas lire les rapports de ventes | Utilisez une clé avec le rôle Admin, Finance ou Sales. |
| 404 | Pas de rapport pour cette date : pas encore publié, rien vendu ce jour-là, ou plus ancien que ce qu’Apple conserve | Considérez-le comme « aucune donnée », réessayez plus tard pour les jours récents. |
| 429 | Limite horaire de requêtes atteinte pour cette clé | Patientez puis reprenez ; étalez les téléchargements d’historique dans le temps. |
500 UNEXPECTED_ERROR | Le serveur d’Apple a échoué. Quand nous avons envoyé un numéro de fournisseur n’appartenant pas à l’équipe de la clé, c’est ce qui est revenu plutôt qu’un message clair | Réessayez une fois ; si cela persiste, revérifiez d’abord le numéro de fournisseur. |
Comment RepriceCat utilise votre numéro de fournisseur
RepriceCat modifie les prix avec votre clé App Store Connect ; avec votre numéro de fournisseur, il peut aussi voir ce que ces prix produisent. Ajoutez-le dans Réglages → Rapports de ventes. Votre clé doit avoir le rôle Admin, Finance ou Sales pour lire les rapports — donc Admin si la même clé modifie aussi les prix. Ensuite, RepriceCat télécharge les rapports quotidiens SALES / SUMMARY d’Apple, une seule fois par jour, et ne conserve que les totaux quotidiens par produit et par pays. Les mises à jour et les re-téléchargements sont exclus.
- L’écran Ventes : unités, téléchargements, achats, produits (en USD aux taux du jour), part et tendance par pays, avec une carte du monde, des graphiques par jour et par jour de la semaine, et des filtres par app et par produit.
- Des indications de prix, comme les pays avec beaucoup de téléchargements mais peu d’achats, ou ceux qui achètent bien plus souvent que la moyenne.
- L’impact de chaque changement de prix dans Activité : unités et produits avant et après le changement, par produit et par pays.
- Les expériences : changez le prix dans quelques pays, gardez le reste comme comparaison, puis conservez ou annulez le résultat (comment faire un test de prix).
Si vous préférez ne pas maintenir vous-même le script de téléchargement et d’analyse, comparez RepriceCat aux scripts d’API ou commencez avec un mois gratuit.
Questions fréquentes
Où trouver mon numéro de fournisseur dans App Store Connect ?
Ouvrez Paiements et rapports financiers, sélectionnez Rapports en haut et lisez le numéro dans le coin supérieur gauche, sous le nom de votre entité juridique. Il figure aussi dans le nom de fichier de tout rapport de ventes que vous avez téléchargé, comme S_D_80012345_20130919.
Le numéro de fournisseur est-il le même que mon Team ID ou l’Apple ID de l’app ?
Non. Le numéro de fournisseur est lié à votre entité juridique dans Paiements et rapports financiers. Le Team ID et les Apple ID des apps sont des identifiants distincts et ne fonctionneront pas comme filter[vendorNumber].
Quel rôle une clé API doit-elle avoir pour télécharger les rapports de ventes ?
Admin, Finance ou Sales. App Manager peut modifier les prix mais ne fait pas partie des rôles qu’Apple indique pour Ventes et tendances : une clé unique qui fait les deux doit donc être Admin.
Pourquoi GET /v1/salesReports renvoie-t-il 404 ?
Il n’y a pas de rapport pour cette date : le jour n’est pas encore publié, rien n’a été vendu ce jour-là, ou la date dépasse l’année pendant laquelle Apple conserve les rapports quotidiens. Considérez-le comme une absence de données et réessayez plus tard pour les jours récents.
Jusqu’où puis-je remonter pour télécharger les rapports de ventes App Store ?
Les rapports quotidiens, hebdomadaires et mensuels sont conservés un an après leur mise à disposition, et les rapports annuels dix ans. Enregistrez vous-même les fichiers si vous avez besoin d’un historique quotidien plus long.
Quelle version utiliser pour le rapport de ventes quotidien ?
La référence du point d’accès d’Apple indique la version 1_0 pour SALES et SUMMARY. Analysez le fichier par noms de colonnes plutôt que par positions, car Apple ajoute des colonnes entre les versions de la disposition.
Essayer
Fixez les prix de tous les territoires à partir d’un seul prix de base
Paliers, arrondi aux paliers de prix, un seul tableau de vérification, une seule confirmation — via l’API App Store Connect. Premier mois offert, puis 1 $ par app et par mois.