Adresse de base et authentification
La base est https://storelift.net/v1. Créez une clé dans Settings → API ; elle n'est affichée qu'une fois et stockée uniquement sous forme de hash : une clé perdue se remplace, elle ne se récupère pas.
Envoyez-la dans x-api-key, ou comme jeton bearer si votre client ne gère que les en-têtes Authorization :
curl -s https://storelift.net/v1/apps \
-H "x-api-key: sl_live_..."Les 27 endpoints
| Endpoint | Ce qu'il renvoie |
|---|---|
GET /v1/apps | Les apps suivies par ce compte ; l'id des autres appels vient d'ici. |
GET | Une app et l'instantané de la dernière exécution. |
GET | Le classement actuel de chaque mot-clé suivi dans un storefront, avec l'état de la mesure et la profondeur de recherche. |
GET | Les apps placées au-dessus de vous, chacune avec les termes sur lesquels elle vous devance et les deux positions. |
GET | Si un assistant cite votre app pour votre catégorie, avec la série enregistrée. Pro, Studio ou Enterprise requis. |
GET | La série de classement par mot-clé, tronquée à la fenêtre d'historique du plan. |
GET | Votre propre fiche telle que le store la sert, sur les deux plateformes, avec les changements datés qui y ont été détectés. |
GET | Les avis récents avec le résumé des étoiles, le nombre de nouveaux avis dans cette exécution, et le côté Play quand il est mesuré. /reviews/search cherche dans toute l'archive par texte, étoiles, version et dates ; /reviews/stats donne la répartition, la courbe quotidienne et la ventilation par version. |
GET | Les changements datés de la fiche — version, captures, événements, mises en avant, modifications du champ de mots-clés — chacun avec le mouvement de rangs des mots-clés autour. |
GET | Cartes éditoriales, In-App Events et le rayon « Vous aimerez aussi » d'Apple par pays, avec l'historique daté des mises en avant et des nouveaux événements. |
GET | La position dans le top pour la catégorie et le storefront de l'app, avec la série. |
GET | Revenus et téléchargements de l'app issus des sources connectées : unités App Store Connect, installations Google Play, MRR, abonnements et essais RevenueCat. connected:false si rien n'est connecté. Scope revenue:read. |
GET | Le nombre d'événements d'abonnement reçus par le webhook RevenueCat / Adapty, par jour, par pays et par cohorte mensuelle. Scope revenue:read. |
GET | Impressions App Store → vues de la page produit → téléchargements : le point du jour et l'historique jour par jour issus des analytics App Store Connect. Scope revenue:read. |
GET | Prix en vigueur par produit et par pays, chaque période à prix fixe avec ses essais, ses premiers paiements et ses revenus, plus les codes d'offre, depuis le webhook RevenueCat / Adapty. Scope revenue:read. |
GET | Les campagnes Apple Ads qui font la promotion de l'app (rapprochées par identifiant App Store) : dépenses, taps, installations, budget et statut, plus les principaux mots-clés et termes de recherche. Scope ads:read. |
Les endpoints sous /apps/{id} acceptent country (un code de storefront comme us, par défaut le premier de l'app) et, quand les deux stores sont mesurés, platform=ios|android.
Les trois états de mesure passent la frontière intacts
Un champ de classement peut contenir un nombre, mais l'absence de nombre recouvre deux choses différentes, et l'API les garde séparées :
measured: true,rank: 7: l'app a été trouvée en position 7.measured: true,rank: null: la recherche a tourné et l'app n'était pas dans les résultats jusqu'àsearchDepth.measured: false: la recherche n'a pas pu être lancée ce jour-là. On ne sait rien de la position.
{
"country": "de",
"platform": "ios",
"live": true,
"measuredAt": "2026-09-19T02:14:08.921Z",
"keywords": [
{ "term": "traumdeutung", "measured": true, "rank": 7, "demand": 6, "searchDepth": 200 },
{ "term": "traumsymbole", "measured": true, "rank": null, "demand": 3, "searchDepth": 200 },
{ "term": "traumtagebuch", "measured": false, "rank": null, "demand": null, "searchDepth": null }
]
}Fondre les deux derniers en zéro décrirait un effondrement qui n'a jamais eu lieu, et toute moyenne construite dessus serait fausse. Si votre code a besoin d'un seul nombre, traitez measured: false comme un trou dans la série, pas comme une valeur.
Compte, consommation et recherche
Quatre endpoints portent sur la clé elle-même et sur les données propres au compte. Les deux premiers ne coûtent rien. search et fetch suivent la forme qu'attend ChatGPT d'un connecteur deep research : une requête renvoie des identifiants, un identifiant renvoie l'enregistrement.
| Endpoint | Ce qu'il renvoie |
|---|---|
GET /v1/account | À qui appartient la clé : plan, méthode d'authentification, scopes, apps lisibles, solde de crédits. |
GET /v1/usage | Chaque quota avec utilisé / limite / remise à zéro, l'allocation Hive du jour et le débit par seconde. |
GET | Recherche dans vos apps, vos mots-clés suivis et vos concurrents ; renvoie des identifiants pour /v1/fetch. |
GET | L'enregistrement complet derrière un identifiant de recherche : fiche d'app, un mot-clé avec son historique, ou un concurrent avec les termes sur lesquels il vous devance. |
Hive : n'importe quelle app, n'importe quel marché
Les endpoints ci-dessus lisent vos propres apps suivies. Les endpoints Hive lisent ce que mesure l'ensemble du réseau : tops, mesure quotidienne de n'importe quelle app, listes de résultats par mot-clé, mots-clés d'un concurrent, revenus et téléchargements de n'importe quelle app. Ils demandent leur propre scope sur la clé et coûtent plus de crédits par appel ; chaque plan a aussi une allocation Hive quotidienne, pour qu'un mois de crédits dure un mois.
| Endpoint | Ce qu'il renvoie | Scope |
|---|---|---|
GET | Le Top Free, le Top Grossing ou le classement iPad d'un storefront (100 places) au jour le plus récent. | hive:read |
GET | La dernière mesure quotidienne de n'importe quelle app : nombre de notes, note, version, prix, répartition des étoiles, badge de catégorie, plus langues prises en charge, événements dans l'app à venir, texte promotionnel et achats intégrés mis en avant. | hive:read |
GET | Qui s'est classé sur un mot-clé, jour par jour (1 000 lignes par appel). | hive:read |
GET | Les mots-clés sur lesquels un concurrent se classe, avec la même allocation mensuelle d'espionnage que dans le tableau de bord. | hive:spy |
GET | Revenus et téléchargements mensuels de n'importe quelle app de l'App Store, dans le monde entier (202 pendant la première lecture). | hive:estimate |
GET | Qui est monté, qui a chuté, qui est entré et qui est sorti d'un top, par rapport au même top N jours plus tôt. Chaque écart est calculé entre deux jours mesurés, et la réponse indique les deux. | hive:read |
GET | Les apps vues pour la première fois dans un top, les plus récentes d'abord. La réponse indique combien de ces jours l'index couvre. | hive:read |
GET | Trouvez des apps dans les tops que nous mesurons : filtre par catégorie, storefront, top (Top Grossing, Top Free, Top Paid, Top iPad), tranche de rang, date de première apparition, nom ou éditeur. Chaque ligne porte les revenus et les téléchargements de l'app. | hive:read |
GET | L'écart de mots-clés entre jusqu'à cinq apps côte à côte : sur quels termes chacune se classe et lesquels lui manquent. Hive Explorer. Chaque app porte son propre état de mesure. | hive:spy |
GET | Toutes les apps d'un éditeur que Hive a vues, avec le jour de leur première entrée dans un top. | hive:read |
GET | L'identifiant de n'importe quelle app à partir d'un nom, d'un développeur, d'un lien de store, d'un id App Store ou d'un nom de paquet. Les noms passent par la recherche App Store de ce store. | hive:read |
GET | Le rayon d'apps similaires du store pour n'importe quelle app, dans l'ordre du rayon, avec la catégorie et le nom de chacune et le jour de lecture. | hive:read |
GET | Les avis récents de n'importe quelle app dans un store avec la répartition des étoiles ; sans nom d'auteur. | hive:read |
Rien de personnel ne franchit cette ligne : les auteurs d'avis n'apparaissent jamais, et un mot-clé d'un concurrent ne s'affiche que si au moins deux autres comptes le suivent, ou si vous le suivez vous-même.
L'essayer sans clé
Chaque chemin existe aussi sous /v1/sandbox/, sans aucune clé : les mêmes formats, un jeu de données fixe de deux apps, des dates qui suivent la veille. Les réponses portent x-sandbox: true. Pour la CI, vous pouvez créer une clé de test (sl_test_) dans Settings : elle répond uniquement depuis le bac à sable, ne consomme aucun crédit et fonctionne sur tous les plans.
curl -s https://storelift.net/v1/sandbox/apps
curl -s 'https://storelift.net/v1/sandbox/hive/keywords/sleep%20sounds/ranks?country=us&days=3&top=10'Comment fonctionnent les écritures et les scopes
- Chaque écriture est d'abord prévisualisée.
POST /v1/actionsrenvoie le diff avant/après, le coût en crédits et un jeton à usage unique, sans rien modifier ;POST /v1/actions/confirml'applique. Le jeton est lié à l'action, aux arguments et à l'état de la cible au moment de la prévisualisation : si la cible a changé entre-temps, la confirmation renvoieconfirm_token_mismatchet n'écrit rien. Les actions couvrent les mots-clés, les concurrents, les apps, les liens de partage et les réponses aux avis (dès Pro) et, sur Studio, le texte de la fiche sur une version App Store modifiable, ainsi que la pause, la reprise et le budget quotidien Apple Ads. La liste complète se trouve dans la référence. - Les scopes d'écriture s'activent un par un. Chaque écriture demande son scope (
track:write,reports:write,reviews:write,ads:write,listing:write) ; ils sont décochés à la création d'une clé. La facturation reste dans les réglages de votre compte. - Vérifiez la date et l’état de l’observation. Une réponse peut contenir une mesure conservée, une absence de données vérifiée, un traitement en attente ou une erreur. Répéter la requête ne rend pas une ancienne observation plus récente.
- La couche revenus a ses propres scopes. Les dix endpoints de croissance (
revenue,subscriptions,funnel,pricing,change-impact,campaigns,ads-keywords,ads-search-terms,ads-commands,search-popularity) répondent à une clé créée avec les scopes sensiblesrevenue:read/ads:read: une clé n'ouvre les données de revenus que si vous le choisissez. GA4 se trouve dans le tableau de bord. - L'historique suit le plan.
historyetchartsutilisent tous deux la fenêtre du plan.
Erreurs
| Statut | error | Quand |
|---|---|---|
| 401 | missing_api_key | Aucune clé dans la requête. |
| 401 | invalid_api_key | La clé est inconnue ou a été révoquée. |
| 401 | account_deleted | Le compte associé à la clé n'existe plus. |
| 403 | plan_required | Le plan n'inclut pas l'accès à l'API. |
| 405 | method_not_allowed | Les lectures sont en GET ; POST est accepté sur /v1/actions, /v1 et /v1 (le brouillon passe dans le corps). |
| 400 | unknown_action | Ce nom d'action ne figure pas au catalogue ; la réponse liste ceux qui y figurent. |
| 400 | invalid_arguments | Un argument manque ou est mal formé ; la réponse nomme le champ. |
| 409 | confirm_token_expired | Le jeton a plus de 10 minutes. Relancez la prévisualisation. |
| 409 | confirm_token_mismatch | La cible a changé après la prévisualisation ; la réponse porte le nouveau diff. |
| 403 | write_limit_reached | L'écriture sort des garde-fous (pas de budget, nombre d'actions par jour). |
| 403 | test_key_read_only | Les clés de test n'écrivent jamais. |
| 404 | job_not_found | Aucun job avec cet id dans cet espace de travail. |
| 403 | workspace_suspended | L'espace de travail est suspendu ; le support peut en donner la raison. |
| 403 | ip_list_required | Cet espace de travail exige une liste d'IP autorisées sur chaque clé. |
| 404 | not_found | Cet id d'app n'appartient pas à ce compte. |
| 404 | unknown_endpoint | Ce chemin n'existe pas sous /v1. |
| 402 | credits_exhausted | Les crédits du mois sont épuisés ; la réponse renvoie vers le pack de crédits. |
| 429 | rate_limited | Trop de requêtes pour cette clé ; attendez le nombre de secondes indiqué par Retry-After. |
| 429 | daily_hive_limit | L'allocation Hive du jour pour ce plan est épuisée ; remise à zéro à 00:00 UTC. |
| 404 | not_measured | Aucune observation vérifiée n’est disponible pour l’application, le mot-clé ou le périmètre demandé. Une donnée absente ne vaut pas zéro. Vérifiez les paramètres et la documentation liée pour connaître les actions disponibles. |
| 400 | bad_query | /v1/search attend un q de 1 à 120 caractères. |
| 400 | bad_id | /v1/fetch attend un id exactement tel que /v1/search l'a renvoyé. |
| 403 | asc_required | update_listing demande une clé App Store Connect connectée. |
| 403 | asc_role | La clé App Store Connect doit avoir le rôle Admin ou App Manager pour modifier les métadonnées. |
| 409 | no_editable_version | Aucune version App Store n'est modifiable ; la réponse liste les états des versions actuelles. |
| 404 | locale_not_found | Cette langue de storefront n'est pas sur la version ; la réponse liste celles qui y sont. |
| 409 | changed_since_preview | La fiche a changé dans App Store Connect après la prévisualisation ; rien n'a été écrit. |
| 422 | asc_rejected | App Store Connect a refusé le changement ; son propre message se trouve dans detail. |
| 409 | in_progress | Une écriture sur la même cible est encore en cours. |
| 403 | ip_not_allowed | La clé a une liste d'IP autorisées et cette requête vient d'ailleurs. |
| 401 | key_leaked | La clé a été trouvée dans un dépôt public et révoquée automatiquement ; créez-en une nouvelle. |
Chaque erreur est un JSON avec un champ error. plan_required renvoie aussi plan, pour qu'un client puisse dire sur quel plan est la clé au lieu de deviner.
Questions fréquentes
Y a-t-il une limite de débit ?
Oui, par clé : un nombre de requêtes par seconde selon le plan (429 avec Retry-After), une allocation mensuelle de crédits visible dans les en-têtes x-credits-*, et une allocation Hive quotidienne. Chaque appel met aussi à jour un compteur d'utilisation sur la clé : vous voyez dans les réglages si une ancienne clé sert encore.
Puis-je l'utiliser avec le plan gratuit ?
Les clés live pour l'API commencent avec Pro. Le bac à sable sans clé et les clés de test fonctionnent sur tous les plans, le serveur MCP distant commence avec Pro, les outils gratuits de ce site ne demandent aucun compte, et le plan gratuit mesure une app chaque jour.
API ou serveur MCP ?
Un script veut l'API : formats fixes, un appel, aucun modèle dans la boucle. Un assistant veut le serveur MCP, parce que les outils portent leurs propres descriptions et qu'il peut choisir le bon appel sans que vous écriviez l'intégration. Les deux travaillent sur les mêmes mesures, et les deux écrivent via la même étape de prévisualisation puis confirmation.
Vérifiez-le pour votre propre app
Collez le lien de votre app et ajoutez vos mots-clés. Position, apps au-dessus de vous et demande sont mesurées chaque jour.
Offre gratuite : 1 app, 10 mots-clés dans chacun des 2 storefronts, 14 jours d'historique, sans carte ni date de fin. Pro coûte 29 $/mois.
Commencer gratuitement →
