Documentation développeur › Référence de l'API
Endpoints du compte
Le plan, les scopes et l'usage de la clé elle-même, la recherche dans le compte et le flux d'alertes. Lire le plan et l'usage coûte 0 crédit.
Authentification · Crédits · Paramètres communs · Codes d'erreur · openapi.json
GET /alerts
Le flux d’alertes de cet espace de travail — baisses et hausses de position, mots-clés qui entrent dans les résultats ou en sortent, concurrents qui vous dépassent ou que vous dépassez, modifications de fiche des concurrents, étapes des règles Apple Ads et des frais de gestion, découvertes de mots-clés terminées — du plus récent au plus ancien, avec le nombre de non-lus. Le même flux que la cloche du tableau de bord.
| Paramètre | Emplacement | Type | Description |
|---|---|---|---|
limit | query | number | lignes, jusqu’à 500 (50 par défaut) |
curl "https://storelift.net/v1/alerts" \
-H "Authorization: Bearer $STORELIFT_API_KEY"GET /portfolio
La journée en cours pour toutes les apps de l’espace de travail, une ligne par app : utilisateurs en direct, utilisateurs et nouveaux utilisateurs, revenus publicitaires, revenus d’abonnement et essais, plus les totaux du portefeuille, les cartes par heure et par pays et le flux des événements d’abonnement. Les mêmes chiffres que l’écran Aujourd’hui du tableau de bord. Passez day pour un jour passé.
| Paramètre | Emplacement | Type | Description |
|---|---|---|---|
tz | query | string | fuseau horaire IANA pour la limite du jour, p. ex. Europe/Istanbul (UTC par défaut) |
day | query | string | jour passé au format YYYY-MM-DD (aujourd’hui par défaut) |
curl "https://storelift.net/v1/portfolio" \
-H "Authorization: Bearer $STORELIFT_API_KEY"GET /account
À qui appartient cette clé ou cette session : forfait, mode d’authentification, portées incluses, apps lisibles et solde de crédits. Ne coûte aucun crédit. Appelez-le lorsqu’un appel a été refusé pour une raison de forfait, de portée ou d’app.
curl "https://storelift.net/v1/account" \
-H "Authorization: Bearer $STORELIFT_API_KEY"Exemple de réponse
GET /usage
Tous les quotas de l’espace de travail, avec la consommation et l’heure de remise à zéro : mots-clés suivis, apps, découverte, questions IA, IA des avis, visibilité IA, espion, crédits API, quota Hive du jour et débit par seconde. Ne coûte aucun crédit. used=null signifie que le quota n’est pas décompté sur ce forfait, et non zéro.
curl "https://storelift.net/v1/usage" \
-H "Authorization: Bearer $STORELIFT_API_KEY"Exemple de réponse
GET /search
Recherche dans les enregistrements de ce compte — noms d’apps et identifiants de store, mots-clés suivis et apps concurrentes classées au-dessus de l’utilisateur — et renvoie une liste d’identifiants à passer à fetch. À utiliser pour retrouver un enregistrement ; pour découvrir de nouvelles apps dans le store, utilisez find_apps.
| Paramètre | Emplacement | Type | Description |
|---|---|---|---|
qobligatoire | query | string | texte libre : un nom d’app, un mot-clé, le nom d’un concurrent ou un identifiant de store |
curl "https://storelift.net/v1/search?q=sleep" \
-H "Authorization: Bearer $STORELIFT_API_KEY"Exemple de réponse
GET /fetch
L’enregistrement complet derrière un identifiant issu de search : une carte d’app, un mot-clé suivi avec son état actuel et son historique de positions, ou un concurrent avec les mots-clés sur lesquels il devance l’utilisateur. Renvoie id, title, url, un text d’une ligne et metadata.
| Paramètre | Emplacement | Type | Description |
|---|---|---|---|
idobligatoire | query | string | un identifiant tel que search l’a renvoyé (app:…, kw:…, rival:…) |
curl "https://storelift.net/v1/fetch?id=kw%3Asbx-lumen%3Aus%3Asleep%2520sounds" \
-H "Authorization: Bearer $STORELIFT_API_KEY"