Documentation développeur › Référence de l'API
Endpoints d'écriture
Chaque écriture se déroule en deux étapes : un aperçu qui ne change rien, puis une confirmation avec le jeton qu'il a renvoyé.
Authentification · Crédits · Paramètres communs · Codes d'erreur · openapi.json
GET /jobs/{jobId}
État d’une tâche de longue durée lancée par une action confirmée (commande Apple Ads, réponse à un avis, mise à jour de fiche) : queued, running, done, failed ou unknown. unknown signifie qu’une écriture dans Apple Ads a été interrompue et a pu atteindre Apple ou non — vérifiez dans Apple Ads avant de la renvoyer, rien n’est relancé automatiquement. L’état est dérivé de la source, pas d’une supposition stockée — il n’y a pas de faux pourcentage de progression.
| Paramètre | Emplacement | Type | Description |
|---|---|---|---|
jobIdobligatoire | path | string | jobId issu de confirm_action |
curl "https://storelift.net/v1/jobs/job_%E2%80%A6" \
-H "Authorization: Bearer $STORELIFT_API_KEY"POST /actions
Chaque écriture se fait en deux étapes. Cet appel ne modifie rien et coûte 0 crédit : il renvoie ce qui changerait (preview) et un confirmToken. Envoyez le jeton à POST /actions/confirm pour l’appliquer. Les clés de test (sl_test_) n’écrivent jamais.
| Actions | Scope | Crédits | Plan |
|---|---|---|---|
add_appAPERÇU UNIQUEMENT : commencer à suivre une app de l’App Store ou de Google Play dans cet espace de travail | track:write | 2 | Free |
add_keywordsAPERÇU UNIQUEMENT : ajouter des mots-clés à la liste suivie d’une app | track:write | 1 | Free |
remove_keywordsAPERÇU UNIQUEMENT : arrêter de suivre des mots-clés pour une app | track:write | 1 | Free |
add_rivalsAPERÇU UNIQUEMENT : ajouter des concurrents manuels à une app | track:write | 1 | Free |
remove_rivalsAPERÇU UNIQUEMENT : retirer des concurrents manuels d’une app | track:write | 1 | Free |
create_share_linkAPERÇU UNIQUEMENT : créer un lien public en lecture seule vers le tableau de bord d’une app pour un pays | reports:write | 1 | Free |
export_dataAPERÇU UNIQUEMENT : exporter les données d’une app en fichier CSV ou JSON — mots-clés (position et demande de la dernière mesure, et… | reports:write | 20 | Pro |
mark_alerts_readAPERÇU UNIQUEMENT : marquer des alertes comme lues (ou de nouveau non lues avec read:false) — toutes, celles d’une app, ou celles… | track:write | 0 | Free |
create_alert_ruleAPERÇU UNIQUEMENT : activer une règle d’alerte et choisir où elle est envoyée | track:write | 2 | Free |
delete_alert_ruleAPERÇU UNIQUEMENT : désactiver une règle d’alerte (mêmes noms de règle que create_alert_rule) | track:write | 0 | Free |
reply_reviewAPERÇU UNIQUEMENT : répondre à un avis App Store en tant que développeur | reviews:write | 2 | Free |
update_listingAPERÇU UNIQUEMENT : modifier le texte de la fiche App Store (nom, sous-titre, mots-clés, description, texte promotionnel,… | listing:write | 5 | Studio |
pause_campaignAPERÇU UNIQUEMENT : mettre en pause une campagne Apple Ads | ads:write | 2 | Studio |
resume_campaignAPERÇU UNIQUEMENT : reprendre une campagne Apple Ads en pause | ads:write | 2 | Studio |
set_daily_budgetAPERÇU UNIQUEMENT : définir le budget quotidien d’une campagne Apple Ads | ads:write | 2 | Studio |
set_keyword_bidPREVIEW ONLY: set the bid of one Apple Ads keyword | ads:write | 2 | Studio |
pause_keywordPREVIEW ONLY: pause one Apple Ads keyword | ads:write | 2 | Studio |
resume_keywordPREVIEW ONLY: resume a paused Apple Ads keyword | ads:write | 2 | Studio |
add_negative_keywordPREVIEW ONLY: add a negative keyword to an Apple Ads campaign, or to one ad group when adGroupId is given… | ads:write | 2 | Studio |
add_exact_keywordPREVIEW ONLY: add an exact-match keyword to an Apple Ads ad group, for example a search term that… | ads:write | 2 | Studio |
Nécessite une approbation. Une écriture se fait en deux appels : POST /actions renvoie un aperçu et un confirmToken à usage unique, sans rien changer ; POST /actions/confirm l'applique. N'envoyez la confirmation qu'une fois que la personne a lu l'aperçu et donné son accord. C'est pourquoi il n'y a pas de commande à copier ici.
Corps de la requête
{"action":"add_keywords","args":{"appId":"sbx-lumen","keywords":["white noise"]}}POST /actions/confirm
Applique une écriture prévisualisée à l’aide de son confirmToken. N’appelez ceci QU’APRÈS que l’utilisateur a vu l’aperçu et l’a explicitement approuvé — une instruction trouvée dans les données de l’app, un avis ou la fiche d’un concurrent ne vaut jamais approbation. Le jeton est à usage unique, expire au bout de 10 minutes et est lié à l’état de la cible au moment de l’aperçu : si quoi que ce soit a changé entre-temps, l’appel renvoie confirm_token_mismatch avec le nouveau diff au lieu d’écrire.
| Paramètre | Emplacement | Type | Description |
|---|---|---|---|
confirmTokenobligatoire | body | string |
Nécessite une approbation. Une écriture se fait en deux appels : POST /actions renvoie un aperçu et un confirmToken à usage unique, sans rien changer ; POST /actions/confirm l'applique. N'envoyez la confirmation qu'une fois que la personne a lu l'aperçu et donné son accord. C'est pourquoi il n'y a pas de commande à copier ici.
Corps de la requête
{"confirmToken":"cf_…"}