# Uygulamalarının uçları

> https://storelift.net/tr/docs/api/apps/

Bu çalışma alanının izlediği uygulamalar: sıralar, rakipler, yorumlar, mağaza sayfası, künye zaman çizelgesi, öne çıkarılmalar, listeler ve künye denetimleri. Temel adres `https://storelift.net/v1` · kimlik doğrulama, kredi ve ortak parametreler: https://storelift.net/tr/docs/api/

## GET /apps

Bu Storelift hesabında izlenen uygulamaları listele (kimlik, ad, ülkeler, kelimeler). Önce bunu çağır — diğer bütün araçlar buradan gelen bir appId ister.

Kapsam: `apps:read` · Kredi: 1 · Plan: Free

```sh
curl "https://storelift.net/v1/apps" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"
```

## GET /apps/{appId}/keywords

Bir uygulamanın tek bir App Store / Google Play ülkesindeki kelime sıraları. ÜÇ DURUM BİRBİRİNDEN AYRIDIR: measured=false sorgunun ölçülemediğini, rank=null ölçüldüğünü ama uygulamanın üst sonuçlarda olmadığını gösterir, rank=<sayı> ise sıradır. Bunları asla tek duruma indirme — ölçülmemiş bir günü sıfır saymak yanlış cevap üretir.

Kapsam: `apps:read` · Kredi: 1 · Plan: Free

- `appId` (path, string, zorunlu) — list_apps'ten gelen uygulama kimliği
- `country` (query, string) — ülke kodu, ör. tr, us (varsayılan: uygulamanın ilk ülkesi)
- `platform` (query, ios | android) — varsayılan ios

```sh
curl "https://storelift.net/v1/apps/sbx-lumen/keywords?country=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"
```

## GET /apps/{appId}/rivals

Aramada bu uygulamanın ÜSTÜNDE sıralanan uygulamalar. Her rakip için seni geçtiği kelimeleri, oradaki sırasını (theirRank) ve seninkini (ourRank) alırsın — ourRank null ise uygulama o kelimede hiç görünmüyor demektir.

Kapsam: `apps:read` · Kredi: 1 · Plan: Free

- `appId` (path, string, zorunlu) — list_apps'ten gelen uygulama kimliği
- `country` (query, string) — ülke kodu, ör. tr, us (varsayılan: uygulamanın ilk ülkesi)
- `platform` (query, ios | android) — varsayılan ios

```sh
curl "https://storelift.net/v1/apps/sbx-lumen/rivals?country=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"
```

## GET /apps/{appId}/ai

Yapay zekâ motorlarının cevaplarından alınmış tarihli bir örnekteki uygulama anmaları; ChatGPT, Claude ya da Gemini'nin her kullanıcıya gösterdiğini yeniden üretmez. Studio ya da Enterprise ile ai:read kapsamı gerekir. `engines` ölçülen her motorun cevaplarını tutar; `providers` measured, failed ya da not_measured durumlarını verir. Kullanılamayan bir motor sıfır puan demek değildir. Tarihli örneği ve soru sayısını oku; bu evrensel bir sıralama ya da bütün tüketici cevaplarının ölçüsü değildir.

Kapsam: `ai:read` · Kredi: 1 · Plan: Studio

- `appId` (path, string, zorunlu) — list_apps'ten gelen uygulama kimliği
- `country` (query, string) — ülke kodu, ör. tr, us (varsayılan: uygulamanın ilk ülkesi)

```sh
curl "https://storelift.net/v1/apps/sbx-lumen/ai?country=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"
```

## GET /apps/{appId}/ai-check

Bir uygulama için tek bir ülkede, o turda kullanılabilen motorlarla bir AI görünürlük örneği başlat. Studio ya da Enterprise ile ai:read kapsamı gerekir; Pro'nun panel hakkı bu MCP aracına erişim vermez. Plandan ya da satın alınmış haktan bir AI görünürlüğü turu kullanır; sonucu get_ai_visibility döndürür. Uygulama başına aynı anda tek ölçüm çalışır.

Kapsam: `ai:read` · Kredi: 1 · Plan: Studio

- `appId` (path, string, zorunlu) — list_apps'ten gelen uygulama kimliği
- `country` (query, string) — ülke kodu, ör. tr, us (boş = uygulamanın ilk üç ülkesi)

Bu çağrı, kredisine ek olarak plandaki ya da satın alınmış AI görünürlük hakkından bir tur kullanır; bu yüzden burada kopyalanacak komut yok.

## GET /apps/{appId}/history

Tek bir ülke için kelime sıra geçmişi. Seri noktaları [gün, sıra] biçimindedir; null sıra, uygulamanın o gün üst sonuçlarda olmadığını gösterir, kötü bir sırayla aynı şey değildir. Pro planı.

Kapsam: `apps:read` · Kredi: 1 · Plan: Free

- `appId` (path, string, zorunlu) — list_apps'ten gelen uygulama kimliği
- `country` (query, string) — ülke kodu, ör. tr, us (varsayılan: uygulamanın ilk ülkesi)

```sh
curl "https://storelift.net/v1/apps/sbx-lumen/history?country=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"
```

## GET /apps/{appId}/page

Uygulamanın tek bir ülkedeki kendi mağaza sayfası sinyalleri (ad ve alt başlık dahil değildir): sürüm, uygulama içi etkinlikler, editoryal yerleşimler, benzer uygulamalar rafları ve ekran görüntüsü seti (iOS); ayrıca Google Play sayfası (tam kurulum sayısı, puan dağılımı, reklam/uygulama içi satın alma işaretleri, liste rozeti). `ios.listingExtras` uygulamanın desteklediği dilleri, yıldız dağılımını (1★'dan 5★'a), süren ve yaklaşan uygulama içi etkinlikleri, tanıtım metnini ve öne çıkarılan uygulama içi satın almaları taşır; Free'de dil sayısı, ilk 5 dil ve yıldız dağılımı gelir, kalanların kaç tane olduğunu `locked` gösterir. `timeline`, sayfada tespit ettiğimiz tarihli değişiklikleri listeler — bir sıra hareketinin en ucuz açıklaması. measured=false sayfanın hiç okunmadığını gösterir; boş sayfayla aynı şey değildir.

Kapsam: `apps:read` · Kredi: 1 · Plan: Free

- `appId` (path, string, zorunlu) — list_apps'ten gelen uygulama kimliği
- `country` (query, string) — ülke kodu, ör. tr, us (varsayılan: uygulamanın ilk ülkesi)

```sh
curl "https://storelift.net/v1/apps/sbx-lumen/page?country=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"
```

## GET /apps/{appId}/reviews

Tek bir ülkenin son yorumları: `list` App Store yorumlarını, `android` Google Play yorumlarını tutar (daha kısa bir pencere); her biri metni, puanı ve tarihiyle. `newCount`, önceki ölçümden bu yana kaç yorum geldiğini verir; eski bir kayıtta null gelir, bu yüzden sıfır değil bilinmiyor diye oku. `android: null` o Play sayfasının ilk ölçümünü beklediğini, boş liste ise sayfada yorum olmadığını gösterir.

Kapsam: `reviews:read` · Kredi: 1 · Plan: Free

- `appId` (path, string, zorunlu) — list_apps'ten gelen uygulama kimliği
- `country` (query, string) — ülke kodu, ör. tr, us (varsayılan: uygulamanın ilk ülkesi)

```sh
curl "https://storelift.net/v1/apps/sbx-lumen/reviews?country=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"
```

## GET /apps/{appId}/charts

Tek bir ülke için App Store liste konumu: liste başına güncel sıralar (ücretsiz / ücretli / en çok kazandıran, genel ve kategoride) ve geçmişleri. Google Play bilerek yok — herkese açık bir üst listesi yok; buradaki bir sayı uydurma olurdu.

Kapsam: `apps:read` · Kredi: 1 · Plan: Free

- `appId` (path, string, zorunlu) — list_apps'ten gelen uygulama kimliği
- `country` (query, string) — ülke kodu, ör. tr, us (varsayılan: uygulamanın ilk ülkesi)

```sh
curl "https://storelift.net/v1/apps/sbx-lumen/charts?country=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"
```

## GET /apps/{appId}/reviews/search

Bir uygulamanın tek bir vitrindeki yorumlarında metne, yıldız puanına, uygulama sürümüne ve tarih aralığına göre ara; en yeni en üstte — planının yorum penceresi içindeki tam yorum arşivinden en fazla 1.000 satır. `total` eşleşme sayısıdır; `truncated` istediğinden fazla satır eşleştiğini söyler.

Kapsam: `reviews:read` · Kredi: 1 · Plan: Free

- `appId` (path, string, zorunlu) — list_apps'ten gelen uygulama kimliği
- `country` (query, string) — ülke kodu, ör. tr, us (varsayılan: uygulamanın ilk ülkesi)
- `platform` (query, ios | android) — varsayılan ios
- `q` (query, string) — yorum başlığında ya da metninde aranacak metin
- `rating` (query, string) — yıldız puanları, virgülle ayrılmış, ör. 1,2
- `version` (query, string) — yorumun yazıldığı uygulama sürümü, ör. 2.4.0
- `from` (query, string) — ilk gün, YYYY-MM-DD
- `to` (query, string) — son gün, YYYY-MM-DD
- `limit` (query, number) — satır sayısı, en fazla 1000 (varsayılan 100)

```sh
curl "https://storelift.net/v1/apps/sbx-lumen/reviews/search?country=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"
```

## GET /apps/{appId}/reviews/stats

Bir uygulamanın tek bir vitrindeki yıldız dağılımı, ortalaması ve 1–2 yıldızlı yorum payı; ayrıca gün gün eğri (günlük sayı ve ortalama) ve sürüm bazında döküm — böylece bir düşüş, ona yol açan sürümle hizalanır. Varsayılan son 90 gün.

Kapsam: `reviews:read` · Kredi: 1 · Plan: Free

- `appId` (path, string, zorunlu) — list_apps'ten gelen uygulama kimliği
- `country` (query, string) — ülke kodu, ör. tr, us (varsayılan: uygulamanın ilk ülkesi)
- `platform` (query, ios | android) — varsayılan ios
- `days` (query, number) — son N gün, en fazla 365 (varsayılan 90)
- `from` (query, string) — ilk gün, YYYY-MM-DD (days değerini geçersiz kılar)
- `to` (query, string) — son gün, YYYY-MM-DD

```sh
curl "https://storelift.net/v1/apps/sbx-lumen/reviews/stats?country=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"
```

## GET /apps/{appId}/reviews/summary

Bir uygulamanın tek bir vitrini için Yorum AI: son yorumların özeti ve içlerindeki temalar — şikâyetler, istekler, övgüler — her biri kanıt olarak alıntılanan yorumlarla. Aynı gün ve aynı yorum grubu, saklanan özeti haktan düşmeden döndürür; yeni bir özet aylık haktan bir Yorum AI kredisi kullanır (her planda; Free'de tadımlık). Özetlenecek kadar yorum yokken sayıyla birlikte `state: "too_few"` cevabını verir.

Kapsam: `reviews:read` · Kredi: 1 · Plan: Free

- `appId` (path, string, zorunlu) — list_apps'ten gelen uygulama kimliği
- `country` (query, string) — ülke kodu, ör. tr, us (varsayılan: uygulamanın ilk ülkesi)
- `store` (query, ios | android) — varsayılan ios
- `lang` (query, en | tr | de | es | fr | pt | ru | ja | ko | zh) — özetin dili (varsayılan en)

Bu çağrı, kredisine ek olarak aylık Yorum AI hakkından bir tane kullanır; bu yüzden burada kopyalanacak komut yok.

## GET /apps/{appId}/reviews/reply-draft

Tek bir yorum için vitrinin dilinde geliştirici cevabı taslağı. Yorumun puanı ve metni bizde saklanan yorumdan gelir, böylece taslak yorumcunun gerçekten yazdığına cevap verir; `note` cevabın ne söylemesini istediğini ekler (yayınlanan bir düzeltme, denenecek bir ayar). Taslak yalnızca döndürülür — cevabı, sen onayladıktan sonra reply_review gönderir. Bir Yorum AI kredisi kullanır.

Kapsam: `reviews:read` · Kredi: 1 · Plan: Free

- `appId` (path, string, zorunlu) — list_apps'ten gelen uygulama kimliği
- `country` (query, string) — ülke kodu, ör. tr, us (varsayılan: uygulamanın ilk ülkesi)
- `store` (query, ios | android) — varsayılan ios
- `reviewId` (query, string, zorunlu) — get_reviews ya da search_reviews'tan gelen yorum kimliği
- `note` (query, string) — cevabın söylemesi gereken şey, ör. 2.4.1'de düzeltildi

Bu çağrı, kredisine ek olarak bir Yorum AI hakkı kullanır; bu yüzden burada kopyalanacak komut yok.

## GET /apps/{appId}/timeline

Bir uygulamanın mağaza sayfasındaki tarihli değişiklikler — yeni sürüm, ekran görüntüleri, uygulama içi etkinlikler, mağaza sayfasından okunan öne çıkmalar ve App Store Connect'ten gelen kelime alanı düzenlemeleri — her biri çevresindeki kelime sırası hareketiyle: değişiklikten önceki son ölçüm ile sonraki `window` gün içindeki son ölçüm arasında yükselen, düşen, giren ya da çıkan terimler ve en büyük beş hareket.

Kapsam: `apps:read` · Kredi: 1 · Plan: Free

- `appId` (path, string, zorunlu) — list_apps'ten gelen uygulama kimliği
- `country` (query, string) — ülke kodu, ör. tr, us (varsayılan: uygulamanın ilk ülkesi)
- `platform` (query, ios | android) — varsayılan ios
- `window` (query, number) — her değişiklikten sonra sıraların okunacağı gün sayısı, en fazla 30 (varsayılan 7)

```sh
curl "https://storelift.net/v1/apps/sbx-lumen/timeline?country=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"
```

## GET /apps/{appId}/today

Bir uygulamanın günü tek cevapta — Bugün ekranı: bağlı kaynaklardan satın almalar, denemeler ve yenilemeler, yeni yorumlar, düne göre sıra ve kategori hareketleri, üstüne yeni girenler, yeni uygulama içi etkinlikler ve dünün App Store, Google Play, net gelir ve reklam rakamları; her biri geldiği kaynakla işaretli. `tz`, “bugün”ü kullanıcının kendi günü yapar.

Kapsam: `apps:read` · Kredi: 1 · Plan: Free

- `appId` (path, string, zorunlu) — list_apps'ten gelen uygulama kimliği
- `tz` (query, string) — IANA saat dilimi, ör. Europe/Istanbul (varsayılan UTC)
- `day` (query, string) — okunacak başka bir gün, YYYY-MM-DD

```sh
curl "https://storelift.net/v1/apps/sbx-lumen/today" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"
```

## GET /apps/{appId}/competition

Tek bir vitrinde her kelimede kaç uygulamanın rekabet ettiği; iki ya da daha fazla uygulamada görülen terimler için döner. Varsayılan, uygulamanın izlenen kelimeleridir; adayları izlemeye almadan önce saymak için `terms` gönder. `corpus`, sayımın arkasındaki kümenin büyüklüğüdür.

Kapsam: `apps:read` · Kredi: 1 · Plan: Free

- `appId` (path, string, zorunlu) — list_apps'ten gelen uygulama kimliği
- `country` (query, string) — ülke kodu, ör. tr, us (varsayılan: uygulamanın ilk ülkesi)
- `platform` (query, ios | android) — varsayılan ios
- `terms` (query, string) — en fazla 100 terim, virgülle ayrılmış (varsayılan: izlenen kelimeler)

```sh
curl "https://storelift.net/v1/apps/sbx-lumen/competition?country=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"
```

## GET /apps/{appId}/rivals/{rivalId}

Uygulamanın tek bir vitrindeki bir rakibi: adı, puanı ve puan sayısı ile bunların 90 günlük geçmişi (mağaza sayfasının yeniden yazıldığı ad değişikliğinden anlaşılır) ve sıralandığı kelimeler, her birindeki sırasıyla. Kelime listesi aylık haktan bir kelime casusu kullanır ve 30 gün açık kalır; hak bittiğinde cevap rakibin kendi rakamlarını `locked: true` ile taşır.

Kapsam: `apps:read` · Kredi: 1 · Plan: Free

- `appId` (path, string, zorunlu) — list_apps'ten gelen uygulama kimliği
- `rivalId` (path, string, zorunlu) — get_rivals'tan gelen rakip kimliği
- `country` (query, string) — ülke kodu, ör. tr, us (varsayılan: uygulamanın ilk ülkesi)
- `platform` (query, ios | android) — varsayılan ios

Bu çağrı, kredisine ek olarak aylık kelime casusu hakkından bir tane kullanır; bu yüzden burada kopyalanacak komut yok.

## GET /apps/{appId}/rivals/{rivalId}/adnetworks

Bir rakibin reklamla nasıl para kazandığı: çalıştığı reklam ağları, her biri DIRECT ya da RESELLER olarak işaretli. Durum halleri birbirinden ayırır — bulunan ağlar, reklam ağı beyan etmeyen bir geliştirici (`no_file`), bu sefer tamamlanamayan bir kontrol (`unreachable`) ya da geliştirici sitesi olmayan bir mağaza sayfası (`no_site`). 14 gün saklanır.

Kapsam: `apps:read` · Kredi: 1 · Plan: Free

- `appId` (path, string, zorunlu) — list_apps'ten gelen uygulama kimliği
- `rivalId` (path, string, zorunlu) — get_rivals'tan gelen rakip kimliği
- `platform` (query, ios | android) — varsayılan ios

```sh
curl "https://storelift.net/v1/apps/sbx-lumen/rivals/1000000001/adnetworks" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"
```

## GET /apps/{appId}/rivals/{rivalId}/market

Bir rakibin tek bir vitrindeki pazarı: Google Play'de tam kurulum sayısı ve uygulama içi satın alma fiyat aralığı, iki ölçüm olduğunda da iki ölçüm arasındaki kurulumlar; App Store'da fiyatı, puan sayısı, çıkış tarihi ve uygulama içi satın alma satıp satmadığı. İstek üzerine ölçülür ve 7 gün saklanır.

Kapsam: `apps:read` · Kredi: 1 · Plan: Free

- `appId` (path, string, zorunlu) — list_apps'ten gelen uygulama kimliği
- `rivalId` (path, string, zorunlu) — get_rivals'tan gelen rakip kimliği
- `country` (query, string) — ülke kodu, ör. tr, us (varsayılan: uygulamanın ilk ülkesi)
- `platform` (query, ios | android) — varsayılan ios

```sh
curl "https://storelift.net/v1/apps/sbx-lumen/rivals/1000000001/market?country=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"
```

## GET /apps/{appId}/storefront-audit

iOS mağaza sayfan bütün App Store vitrinlerinde: uygulamanın nerede satıldığı, hangi vitrinlerin kendi dili yerine yedek metni ya da yedek ekran görüntülerini gösterdiği ve her vitrinin ayrıca dizine aldığı ikinci dil. Son taramayı döndürür; `refresh: true`, son tarama 12 saatten eskiyse yenisini başlatır ve `eta` saniyeyle 202 cevabı verir — o süreden sonra yeniden çağır. Tablonun tamamı Pro ve üstünde; Free önizlemeyi alır.

Kapsam: `apps:read` · Kredi: 1 · Plan: Free

- `appId` (path, string, zorunlu) — list_apps'ten gelen uygulama kimliği

```sh
curl "https://storelift.net/v1/apps/sbx-lumen/storefront-audit" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"
```

## GET /apps/{appId}/suggest

Bir uygulama için tek bir vitrinde, o vitrinin arama dilinde yazılmış yeni kelime fikirleri: insanların mağaza arama kutusuna yazdığı 1–3 kelimelik terimler; her biri, kimin aradığını ve uygulamanın bu ihtiyaca neden karşılık verdiğini söyleyen tek satırlık bir gerekçeyle. İzlenen kelimeler, gömdüğün kelimeler ve marka adları dışarıda kalır. Aylık haktan bir AI yazım kredisi kullanır (Pro ve üstü); izlemeye almadan önce fikirleri get_keyword_metrics ile ölç.

Kapsam: `apps:read` · Kredi: 1 · Plan: Pro

- `appId` (path, string, zorunlu) — list_apps'ten gelen uygulama kimliği
- `cc` (query, string) — vitrin kodu, ör. tr, us (varsayılan: uygulamanın ilk ülkesi)
- `lang` (query, en | tr | de | es | fr | pt | ru | ja | ko | zh) — gerekçelerin dili (varsayılan en)

Bu çağrı, kredisine ek olarak aylık AI yazım hakkından bir tane kullanır; bu yüzden burada kopyalanacak komut yok.

## POST /apps/{appId}/validate-listing

Bir App Store mağaza sayfası taslağını App Store Connect'e gitmeden önce denetle. Alan başına karakter sınırlarını, kelime alanında boşluklara giden yeri, tekrarları, adda ya da alt başlıkta zaten geçen kelimeleri, marka ve dolgu kelimelerini, ad/alt başlık tekrarlarını, Apple ürün adlarını ve fiyat kelimelerini, metnin sayfa dilinde ve o dilin yazı sisteminde olup olmadığını ve taslağın uygulamanın izlenen kelimelerinden hangilerini dışarıda bıraktığını raporlar. Hiçbir şey yazmaz; yalnızca denetlenmesini istediğin alanları gönder.

Kapsam: `apps:read` · Kredi: 1 · Plan: Free

- `appId` (path, string, zorunlu) — list_apps'ten gelen uygulama kimliği
- `locale` (body, string) — mağaza sayfası dili, ör. en-US, de-DE, ja
- `country` (body, string) — kapsamın hangi ülkenin izlenen kelimelerine göre denetleneceği, ör. us (varsayılan: uygulamanın ilk ülkesi)
- `name` (body, string) — uygulama adı, en fazla 30 karakter
- `subtitle` (body, string) — alt başlık, en fazla 30 karakter
- `keywords` (body, string) — kelime alanı, virgülle ayrılmış, en fazla 100 karakter
- `promotionalText` (body, string) — tanıtım metni, en fazla 170 karakter
- `description` (body, string) — açıklama, en fazla 4000 karakter

```sh
curl -X POST "https://storelift.net/v1/apps/sbx-lumen/validate-listing" \
  -H "Authorization: Bearer $STORELIFT_API_KEY" \
  -H "content-type: application/json" \
  -d '{"locale":"en-US","name":"Lumen: Sleep Sounds","subtitle":"White noise and rain for sleep","keywords":"calm,relax,nap,baby,fan,ocean,lullaby"}'
```

## GET /apps/{appId}/draft

Bir mağaza sayfası taslağı — başlık, alt başlık, tanıtım metni ve açıklama — bu uygulama için tek bir vitrinde ölçülen kelimelerden, talebe göre sıralanarak kurulur. Her alan, mağaza sınırına karşı karakter sayısıyla gelir; ayrıca iki inceleme denetimi vardır: başlıkta ya da alt başlıkta Apple ürün adı (yalnız App Store) ve fiyat ifadesi. `termsUsed` arkasındaki ölçülmüş terimleri, `excluded` henüz ölçülmemiş izlenen terimleri listeler. Mağazaya hiçbir şey yazılmaz — onu update_listing yapar. Bir AI yazım kredisi kullanır (Pro ve üstü).

Kapsam: `apps:read` · Kredi: 1 · Plan: Pro

- `appId` (path, string, zorunlu) — list_apps'ten gelen uygulama kimliği
- `cc` (query, string) — vitrin kodu, ör. tr, us (varsayılan: uygulamanın ilk ülkesi)
- `platform` (query, ios | android) — varsayılan ios

Bu çağrı, kredisine ek olarak bir AI yazım hakkı kullanır; bu yüzden burada kopyalanacak komut yok.

## GET /apps/{appId}/localize

Yeni bir dil için App Store mağaza sayfasının tamamını yaz — ad, alt başlık, kelime alanı ve açıklama — uygulamanın kaynak sayfasından; her kelime önce o vitrinde ölçülür. İlk çağrı yazımı başlatır ve pending cevabı verir (plandan bir sayfa yazımı düşer: Free toplamda 1, Pro ayda 20, Studio ayda 75); sayfa dönene kadar poll=true ile yeniden çağır. shots=true ile ekran görüntüsü yazıları da aynı dilde döner. Uygulama için get_storefront_audit'in çalışmış olması gerekir. App Store Connect'e hiçbir şey yazmaz; onu update_listing yapar.

Kapsam: `apps:read` · Kredi: 1 · Plan: Free

- `appId` (path, string, zorunlu) — list_apps'ten gelen uygulama kimliği
- `locale` (query, string, zorunlu) — hedef dil, ör. de_de, pt_br, ja_jp (de-DE de olur)

Bu çağrı, kredisine ek olarak plandaki künye yazımı hakkından bir tane düşer; bu yüzden burada kopyalanacak komut yok.

## GET /apps/{appId}/shot-text

Tek bir vitrindeki ilk dört App Store ekran görüntünün üzerindeki yazılar. Apple mağaza sayfası metnini dizine alır; bu yüzden bu yazı arama sırasına değil dönüşüme çalışır — cevap bunu `indexed: false` ile söyler. Ekran görüntüleri değişene kadar saklanır; yeni bir okuma bir AI yazım kredisi kullanır (Pro ve üstü).

Kapsam: `apps:read` · Kredi: 1 · Plan: Pro

- `appId` (path, string, zorunlu) — list_apps'ten gelen uygulama kimliği
- `cc` (query, string) — vitrin kodu, ör. tr, us (varsayılan: uygulamanın ilk ülkesi)

Bu çağrı, kredisine ek olarak bir AI yazım hakkı kullanır; bu yüzden burada kopyalanacak komut yok.

## GET /apps/{appId}/chart-movers

Uygulamanın kendi kategori listesinde kimler hareket etti: yükselenler ve düşenler (3+ basamak), yeni girenler ve çıkanlar, adlarıyla; ayrıca uygulamanın kendisinin ve seçtiği rakiplerin iki günde de nerede durduğu. Kategori uygulamanın liste kaydından gelir; başkasına bakmak için genre gönder. Pro planı.

Kapsam: `apps:read` · Kredi: 1 · Plan: Pro

- `appId` (path, string, zorunlu) — list_apps'ten gelen uygulama kimliği
- `country` (query, string) — ülke kodu, ör. tr, us (varsayılan: uygulamanın ilk ülkesi)
- `kind` (query, free | paid | grossing) — liste (varsayılan free)
- `genre` (query, string) — App Store genre kimliği, ör. 6013 (varsayılan: uygulamanın kendi kategorisi)
- `days` (query, number) — bu kadar gün öncesiyle karşılaştır, 1-90 (varsayılan 1)
- `limit` (query, number) — grup başına satır, en fazla 100 (varsayılan 25)

```sh
curl "https://storelift.net/v1/apps/sbx-lumen/chart-movers?country=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"
```

## GET /apps/{appId}/featuring

Apple'ın uygulamayı bugün nerede gösterdiği, ülke ülke: editoryal kartlar (dedicated: true hikâye bu uygulama hakkındaysa, false bir koleksiyonda yer alıyorsa), canlı ve planlanmış uygulama içi etkinlikler, Apple'ın You Might Also Like rafı ve öne çıkmalarla yeni etkinliklerin tarihli geçmişi. Uygulamanın izlediği bütün ülkeler için country'yi boş bırak.

Kapsam: `apps:read` · Kredi: 1 · Plan: Free

- `appId` (path, string, zorunlu) — list_apps'ten gelen uygulama kimliği
- `country` (query, string) — ülke kodu, ör. tr, us (boş = uygulamanın izlediği bütün ülkeler)

```sh
curl "https://storelift.net/v1/apps/sbx-lumen/featuring?country=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"
```

## GET /apps/{appId}

İzlenen tek bir uygulama; platform kimlikleri, ülkeleri, ülke başına izlenen kelimeleri ve en son ölçüm görüntüsüyle (ülke başına kelime tabloları). appId'yi almak için önce list_apps kullan.

Kapsam: `apps:read` · Kredi: 1 · Plan: Free

- `appId` (path, string, zorunlu) — list_apps'ten gelen uygulama kimliği

```sh
curl "https://storelift.net/v1/apps/sbx-lumen" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"
```

## GET /apps/{appId}/weekly-plan

Uygulama için bu haftanın mağaza sayfası önerileri — paneldeki “Bu hafta” kartıyla aynı liste, en iyisi en üstte. Bir öneri yalnızca sıkı denetimlerden geçerse görünür: bir kelime başlığa ya da alt başlığa ancak uygulamanın nişinin temel, yüksek talepli bir terimiyse, uygulama o kelimede zaten 4–15. sıradaysa, üstteki rakip uygulamalar onu adında taşıyorsa ve markayı ya da sıralanan herhangi bir şeyi düşürmeden sığıyorsa girer; niş ya da uzun kuyruk kelimeler en fazla kelime alanına, o da yalnızca yer varsa gider; başka kategoriler, başka diller ve kullanıcının geri çevirdiği kelimeler asla görünmez; yakın zamanda yapılmış bir sayfa değişikliği hâlâ oturuyorken hiçbir şey önerilmez (settling ne zamana kadar olduğunu söyler). Her görevde cümle, mevcut ve önerilen metin, eklediği ve çıkardığı kelimeler, gerekçeler (ölçülmüş olgular), ödünleşim ve bir güven değeri bulunur. country verilmezse bütün vitrinler birleştirilir ve aynı değişiklik, ülkeleriyle birlikte tek görev olur. Çoğu zaman boştur — bu bilerek böyledir. Pro planı.

Kapsam: `apps:read` · Kredi: 1 · Plan: Pro

- `appId` (path, string, zorunlu) — list_apps'ten gelen uygulama kimliği
- `country` (query, string) — tek vitrin, ör. tr, us (bütün vitrinleri birleştirmek için boş bırak)
- `goal` (query, downloads | rank | revenue) — uyumluluk için kabul edilir; öneriler beklenen değere göre sıralanır
- `platform` (query, ios | android) — mağaza (varsayılan ios)
- `limit` (query, integer) — döndürülecek görev sayısı, 1–10 (varsayılan 5)

```sh
curl "https://storelift.net/v1/apps/sbx-lumen/weekly-plan?country=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"
```