Uygulamalarının uçları

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

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

Kum havuzunda aç

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

Ayrıca kabul ettikleri: appId (zorunlu) · country · platform

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

Kum havuzunda aç

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

Ayrıca kabul ettikleri: appId (zorunlu) · country · platform

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

Kum havuzunda aç

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

Ayrıca kabul ettikleri: appId (zorunlu) · country

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

Kum havuzunda aç

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

Ayrıca kabul ettikleri: appId (zorunlu)

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

Ayrıca kabul ettikleri: appId (zorunlu) · country

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

Kum havuzunda aç

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

Ayrıca kabul ettikleri: appId (zorunlu) · country

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

Kum havuzunda aç

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

Ayrıca kabul ettikleri: appId (zorunlu) · country

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

Kum havuzunda aç

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

Ayrıca kabul ettikleri: appId (zorunlu) · country

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

Kum havuzunda aç

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

Ayrıca kabul ettikleri: appId (zorunlu) · country · platform

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

Ayrıca kabul ettikleri: appId (zorunlu) · country · platform

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

Ayrıca kabul ettikleri: appId (zorunlu) · country

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

Ayrıca kabul ettikleri: appId (zorunlu) · country

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

Ayrıca kabul ettikleri: appId (zorunlu) · country · platform

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

Ayrıca kabul ettikleri: appId (zorunlu)

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

Ayrıca kabul ettikleri: appId (zorunlu) · country · platform

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

Ayrıca kabul ettikleri: appId (zorunlu) · country · platform

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

Ayrıca kabul ettikleri: appId (zorunlu) · platform

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

Ayrıca kabul ettikleri: appId (zorunlu) · country · platform

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

Ayrıca kabul ettikleri: appId (zorunlu)

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

Ayrıca kabul ettikleri: appId (zorunlu)

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

Ayrıca kabul ettikleri: appId (zorunlu)

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

Ayrıca kabul ettikleri: appId (zorunlu) · platform

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

Ayrıca kabul ettikleri: appId (zorunlu)

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

Ayrıca kabul ettikleri: appId (zorunlu)

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

Ayrıca kabul ettikleri: appId (zorunlu) · country

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

Ayrıca kabul ettikleri: appId (zorunlu)

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

Ayrıca kabul ettikleri: appId (zorunlu)

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

Kum havuzunda aç

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

Ayrıca kabul ettikleri: appId (zorunlu)

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