Storelift

Storelift › Rehber › Storelift API'si

AI katmanı

Storelift API'si

Panelin gösterdiği her şey aynı zamanda bir JSON ucu. 33 GET ucu izlediğin uygulamaları ve pazarı okuyor; POST /v1/actions bir değişikliği önizliyor, POST /v1/actions/confirm onu uyguluyor — yani bir betik, bir tablo işi ya da bir CI adımı aynı sayıları okuyup üstüne iş yapabiliyor. API Pro ve Studio planlarında. Tam başvuru /tr/docs/api/ adresinde, makinenin okuyacağı şema /openapi.json'da (OpenAPI 3.1); aynı veriyle bir asistan çalışacaksa doğru yer genellikle yine Pro'dan başlayan MCP sunucusu.

Ücretsiz başla →Ücretsiz plan: 1 uygulama, 2 vitrinin her birinde 10 kelime, 14 gün geçmiş; kart yok, süre sınırı yok. Pro aylık 29 $.

Yazan Güncellendi: 8 dk okuma

Kelime takibi · sıra geçmişi, haftanın hareketleri ve takipteki kelimeler

Taban adres ve kimlik

Taban https://storelift.net/v1. Anahtarı Ayarlar → API'den üretiyorsun; bir kez gösteriliyor ve yalnız özeti saklanıyor, yani kaybolan anahtar kurtarılmıyor, yenisiyle değiştiriliyor.

Anahtarı x-api-key başlığında gönder; istemcin yalnız Authorization başlığı kuruyorsa bearer jetonu olarak da kabul ediliyor:

Terminal
curl -s https://storelift.net/v1/apps \
  -H "x-api-key: sl_live_..."
API erişimi Pro ve Studio planlarında — ayda 29 $'dan başlıyor, Studio 99 $. Plan düştüğünde anahtar saklanıyor; tekrar yükseltince aynı entegrasyon kaldığı yerden çalışıyor.

33 uç

UçNe döndürüyor
GET /v1/appsHesabın izlediği uygulamalar. Her çağrı buradan başlıyor — id buradan geliyor.
GET /v1/apps/{id}Tek uygulama ve son turun anlık görüntüsü.
GET /v1/apps/{id}/featuringÜlke başına editoryal kartlar, In-App Event'ler ve Apple'ın "You Might Also Like" rafı; öne çıkarılma ve yeni etkinliklerin tarihli geçmişiyle. dedicated uygulamaya ait hikâyeyi içinde yer aldığı derlemeden ayırır.
GET /v1/apps/{id}/keywordsBir vitrindeki her izlenen kelimenin güncel sırası — ölçüm hâli ve taranan derinlikle.
GET /v1/apps/{id}/rivalsÜstünde duran uygulamalar; her biri hangi terimlerde önünde ve iki sıra da yanında.
GET /v1/apps/{id}/aiAsistan kategorinde uygulamanı anıyor mu, saklanan seriyle. Pro, Studio veya Enterprise gerekir.
GET /v1/apps/{id}/historyKelime başına sıra serisi, planın geçmiş penceresine kırpılmış.
GET /v1/apps/{id}/pageKendi künyen, mağazanın sunduğu hâliyle, iki platform ve üzerinde yakalanan tarihli değişikliklerle.
GET /v1/apps/{id}/reviewsSon yorumlar; yıldız özeti, bu turda gelen yeni sayısı ve ölçüldüyse Play tarafı. /reviews/search arşivin tamamında metin, yıldız, sürüm ve tarihle arar; /reviews/stats dağılımı, gün gün eğriyi ve sürüm kırılımını verir.
GET /v1/apps/{id}/timelineTarihli künye değişiklikleri — sürüm, kare, etkinlik, öne çıkarılma, keyword alanı — her birinin çevresindeki kelime sırası hareketiyle.
GET /v1/apps/{id}/chartsUygulamanın türü ve vitrini için top liste sırası, seriyle.
GET /v1/apps/{id}/revenueUygulamanın bağlı kaynaklardan gelir ve indirmesi: App Store Connect birimleri, Google Play kurulumları, RevenueCat MRR, abonelik ve deneme. Hiçbir şey bağlı değilse connected:false. Kapsam revenue:read.
GET /v1/apps/{id}/subscriptionsRevenueCat / Adapty webhook'undan abonelik olay sayıları — gün, ülke ve aylık cohort başına. Kapsam revenue:read.
GET /v1/apps/{id}/funnelApp Store gösterim → sayfa görüntüleme → indirme: bugünkü nokta ve App Store Connect analitiğinden gün gün geçmiş. Kapsam revenue:read.
GET /v1/apps/{id}/pricingRevenueCat / Adapty webhook'undan ürün ve ülke başına geçerli fiyat, her sabit fiyat dönemi denemesi, ücretli başlangıcı ve geliriyle, artı offer code'lar. Kapsam revenue:read.
GET /v1/apps/{id}/campaignsUygulamayı tanıtan Apple Ads kampanyaları (App Store kimliğiyle eşlenir): harcama, dokunma, kurulum, bütçe ve durum, artı en çok harcayan kelimeler ve arama terimleri. Kapsam ads:read.

/apps/{id} altındaki uçlar country (vitrin kodu, örneğin tr; boşsa uygulamanın ilk vitrini) ve iki mağaza da ölçülüyorsa platform=ios|android parametrelerini alıyor.

Üç ölçüm hâli sınırdan geçerken korunuyor

Entegrasyonu yazmadan önce okunacak yer burası. Sıra alanı bir sayı olabilir, ama sayının yokluğu iki ayrı şey ve API ikisini ayrı tutuyor:

  • measured: true, rank: 7 — uygulama 7. sırada bulundu.
  • measured: true, rank: null — arama koştu, uygulama searchDepth derinliğine kadar sonuçlarda yoktu.
  • measured: false — o gün arama koşturulamadı. Sıra hakkında hiçbir şey bilinmiyor.
JSON
{
  "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 }
  ]
}

Son ikisini sıfıra katlamak, yaşanmamış bir çöküşü anlatmak olur; üstüne kurulan her ortalama da yanlış çıkar. Kodun tek bir sayı istiyorsa measured: false'u seride boşluk say, değer sayma.

Hesap, kullanım ve arama

Anahtarın kendisi ve hesabın kendi kayıtları üstüne dört uç. İlk ikisi kredi harcamıyor; bir betik başlamadan neyi okuyabildiğini ve ne kadar hakkı kaldığını sorabiliyor. search ve fetch ChatGPT'nin derin araştırma bağlayıcısından beklediği biçimde: sorgu kimlik döner, kimlik kaydı.

UçNe döndürüyor
GET /v1/accountAnahtar kimin: plan, kimlik yöntemi, kapsamlar, okunabilen uygulamalar, kredi bakiyesi. 0 kredi.
GET /v1/usageHer kota kullanılan / tavan / yenilenme ile, bugünkü Hive hakkı ve saniyelik hız. 0 kredi.
GET /v1/search?q=Kendi uygulamalarında, izlenen kelimelerde ve rakiplerde arama; /v1/fetch için kimlik döner (ChatGPT derin araştırma biçimi).
GET /v1/fetch?id=Bir arama kimliğinin tam kaydı: uygulama kartı, geçmişiyle bir kelime ya da seni geçtiği terimlerle bir rakip.

Hive: herhangi bir uygulama, herhangi bir pazar

Yukarıdaki uçlar senin izlediğin uygulamaları okuyor. Hive uçları bütün ağın ölçtüğünü okuyor — listeler, herhangi bir uygulamanın günlük ölçüsü, kelime sonuç listeleri, bir rakibin kelimeleri ve herhangi bir uygulamanın geliri ile indirmesi. Anahtarda kendi kapsamlarını istiyor ve çağrı başına daha çok kredi harcıyor; her planın ayrıca günlük bir Hive hakkı var, böylece bir ayın kredisi bir ay yetiyor.

UçNe döndürüyorKapsam
GET /v1/hive/charts?country=&kind=&genre=Bir vitrinin Ücretsiz, Hasılat ya da iPad listesi (100 derin), en son günü itibarıyla.hive:read
GET /v1/hive/apps/{storeId}?country=Herhangi bir uygulamanın son günlük ölçüsü: oy, puan, sürüm, fiyat, yıldız dağılımı, kategori rozeti; ayrıca desteklenen diller, yaklaşan uygulama içi etkinlikler, tanıtım metni ve öne çıkarılan uygulama içi satın almalar.hive:read
GET /v1/hive/keywords/{term}/ranks?country=&days=&top=Bir kelimede kimin sıralandığı, gün gün (çağrı başına 1.000 satır).hive:read
GET /v1/hive/spy/{storeId}?country=Bir rakibin sıralandığı kelimeler — panelle aynı gizlilik süzgeci ve aylık spy hakkı.hive:spy
GET /v1/hive/estimate/{storeId}?country=Herhangi bir App Store uygulamasının dünya genelinde aylık geliri ve indirmesi (ilk okuma sürerken 202).hive:estimate
GET /v1/hive/movers?country=&kind=&genre=&days=&limit=Bir listede kim yükseldi, kim düştü, kim girdi, kim çıktı — N gün önceki aynı listeye göre. Her Δ, ölçülmüş iki gün arasında çıkıyor ve yanıt ikisini de adıyla yazıyor.hive:read
GET /v1/hive/new?days=&country=&limit=Bir listede İLK kez görülen uygulamalar, yeniden eskiye. Yanıt indeksin kaç günü kapsadığını taşır; her “ilk görülme” tarihi indekslediğimiz bir gündür.hive:read
GET /v1/hive/find?genre=&country=&kind=&released=&rankMin=&rankMax=&text=&publisher=&page=Ölçtüğümüz listelerde uygulama bul: kategori, vitrin, liste (Top Grossing, Top Free, Top Paid, Top iPad), sıra aralığı, ilk görülme tarihi, ad ya da yayıncı. Her satır uygulamanın gelirini ve indirmesini taşıyor.hive:read
GET /v1/hive/gap?ids=&country=&platform=En çok beş uygulama yan yana kelime farkı: hangi terimde kim var, kim yok. Hive Explorer. Spy ile aynı gizlilik süzgeci; her uygulama kendi ölçüm durumunu taşıyor, yani tablodaki her hücre ölçülmüş bir gerçek.hive:spy
GET /v1/hive/publisher/{publisherId}Hive'ın gördüğü, bir yayıncıya ait bütün uygulamalar; her birinin ilk listelendiği günle.hive:read
GET /v1/hive/resolve?q=&country=&limit=Ad, geliştirici, mağaza bağlantısı, App Store kimliği ya da paket adından herhangi bir uygulamanın kimliği. Adlar o vitrinde App Store aramasından geçiyor.hive:read
GET /v1/hive/similar/{storeId}?country=Herhangi bir uygulama için mağazanın benzer uygulama rafı; raf sırasıyla, her uygulamanın kategorisi, adı ve rafın okunduğu gün.hive:read
GET /v1/hive/reviews/{storeId}?country=&limit=Herhangi bir uygulamanın bir vitrindeki son yorumları, yıldız dağılımıyla; yazan adı dönmez.hive:read

Bu sınırdan kişisel hiçbir şey geçmiyor: yorum yazarları hiç görünmüyor, bir rakibin kelimesi ancak en az iki başka hesap ya da sen izliyorsan dönüyor.

Anahtarsız dene

Her yol /v1/sandbox/ altında anahtarsız da var: aynı biçim, sabit iki uygulamalık veri seti, düne göre kayan tarihler. Yanıtlar x-sandbox: true taşıyor. CI için Ayarlar'dan bir test anahtarı (sl_test_) açabilirsin — yalnız sandbox'tan cevap veriyor, kredi harcamıyor ve her planda çalışıyor; sızan bir test anahtarı hiçbir şey açığa çıkarmıyor.

Terminal
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'

Yazma ve kapsamlar nasıl çalışıyor

  • Her yazma önce önizleniyor. Okumalar GET. POST /v1/actions hiçbir şeyi değiştirmeden önce/sonra farkını, kredi tutarını ve tek kullanımlık bir jeton döner; POST /v1/actions/confirm onu uygular. Jeton eyleme, argümanlara ve hedefin önizleme anındaki hâline bağlı; arada hedef değiştiyse onay yeni farkla birlikte confirm_token_mismatch döner ve hiçbir şey yazılmaz. Eylemler kelime, rakip, uygulama ve paylaşım bağlantısını ve yorum yanıtını (Pro ve üstünde), Studio'da da düzenlenebilir App Store sürümünde vitrin metnini ve Apple Ads duraklatma, sürdürme ve günlük bütçeyi kapsıyor. Tam liste başvuru sayfasında.
  • Yazma kapsamlarını sen açıyorsun. Her yazma kendi kapsamını ister (track:write, reports:write, reviews:write, ads:write, listing:write); anahtar açılırken hepsi işaretsiz gelir. Test anahtarları sandbox'tan cevap verir, verine dokunmaz. Faturalandırma hesap ayarlarında duruyor.
  • Ölçümün tarihini ve durumunu kontrol et. Yanıtta kayıtlı bir ölçüm, doğrulanmış veri yokluğu, bekleyen işlem veya hata bulunabilir. İsteği yinelemek eski gözlemin tarihini yenilemez.
  • Gelir katmanı kendi kapsamının arkasında. On büyüme ucu (revenue, subscriptions, funnel, pricing, change-impact, campaigns, ads-keywords, ads-search-terms, ads-commands, search-popularity) hassas revenue:read / ads:read kapsamıyla açılmış anahtara cevap veriyor; yani bir anahtar gelir verisini ancak sen seçersen açar. GA4 panelde.
  • Geçmiş plana göre. history ve charts planın penceresini uyguluyor; aynı anahtar iki uçtan da tam olarak aynı yere kadar uzanıyor.

Hatalar

DurumerrorNe zaman
400key_in_urlAnahtar adreste gönderildi; günlükler ve vekil sunucular onu saklar. x-api-key başlığında gönder ve anahtarı döndür; alan yöneticilerine anahtar başına bir posta gider.
401missing_api_keyİstekte anahtar yok.
401invalid_api_keyAnahtar tanınmıyor ya da iptal edilmiş.
401account_deletedAnahtarın ait olduğu hesap silinmiş.
403plan_requiredPlan API erişimi içermiyor. Yanıt mevcut planı da taşıyor.
405method_not_allowedOkumalar GET; POST /v1/actions, /v1/actions/confirm ve /v1/apps/{id}/validate-listing yollarında (taslak gövdede gider).
400unknown_actionEylem adı katalogda yok; yanıt olanları listeliyor.
400invalid_argumentsBir argüman eksik ya da hatalı; yanıt alanın adını veriyor.
409confirm_token_expiredJeton 10 dakikadan eski. Yeniden önizle.
409confirm_token_mismatchÖnizlemeden sonra hedef değişti; yanıt yeni farkı taşıyor.
403write_limit_reachedYazma korkulukların dışında (bütçe adımı, günlük Apple Ads eylemi, günlük yazma: 200 takip / 50 yorum cevabı).
403test_key_read_onlyTest anahtarları yazmıyor.
404job_not_foundBu çalışma alanında o kimlikle bir iş yok.
403workspace_suspendedÇalışma alanı askıya alınmış; sebebini destek söyleyebilir.
403ip_list_requiredBu çalışma alanı her anahtarın IP izin listesi taşımasını istiyor.
404not_foundO uygulama kimliği bu hesapta yok.
404unknown_endpoint/v1 altında böyle bir yol yok.
402credits_exhaustedBu ayın kredisi bitti; yanıt kredi paketine bağlantı taşıyor.
429rate_limitedBu anahtar için çok fazla istek; Retry-After saniyesi kadar bekle.
429daily_hive_limitPlanın bugünkü Hive hakkı bitti; 00:00 UTC'de yenilenir.
404not_measuredİstenen uygulama, kelime veya kapsam için doğrulanmış gözlem bulunamadı. Eksik veri sıfır değildir. İstek parametrelerini ve kullanılabilecek işlemler için yanıttaki belge bağlantısını kontrol et.
400bad_query/v1/search 1–120 karakterlik q ister.
400bad_id/v1/fetch kimliği /v1/search'ün döndürdüğü gibi ister.
403asc_requiredupdate_listing bağlı bir App Store Connect anahtarı ister.
403asc_roleApp Store Connect anahtarının metadata yazması için Admin ya da App Manager rolü gerekiyor.
409no_editable_versionDüzenlenebilir App Store sürümü yok; yanıt sürümlerin o anki hâllerini listeliyor.
404locale_not_foundO vitrin dili sürümde yok; yanıt olanları listeliyor.
409changed_since_previewÖnizlemeden sonra vitrin App Store Connect'te değişti; hiçbir şey yazılmadı.
422asc_rejectedApp Store Connect değişikliği reddetti; kendi mesajı detail alanında.
409in_progressAynı hedef için bir yazma hâlâ sürüyor.
403ip_not_allowedAnahtarın IP izin listesi var ve istek başka bir adresten geldi.
401key_leakedAnahtar herkese açık bir depoda bulunup otomatik iptal edildi; yenisini aç.

Her hata error alanı taşıyan bir JSON. plan_required ayrıca plan döndürüyor; istemci anahtarın hangi planda olduğunu tahmin etmek yerine söyleyebiliyor.

Sık sorulanlar

Hız sınırı var mı?

Evet, anahtar başına: plana göre saniyede istek (429 + Retry-After), x-credits-* başlıklarında görünen aylık kredi hakkı ve günlük Hive hakkı. Her çağrı ayrıca anahtarın üstündeki kullanım sayacını güncelliyor — Ayarlar'da eski bir anahtarın hâlâ kullanılıp kullanılmadığı böyle görünüyor.

Ücretsiz planda kullanabilir miyim?

API için canlı anahtar Pro'dan başlıyor. Anahtarsız sandbox ve test anahtarı her planda çalışıyor, uzak MCP sunucusu da Pro'dan başlıyor, bu sitedeki ücretsiz araçlar hiç hesap istemiyor ve ücretsiz plan bir uygulamayı her gün ölçüyor.

API mi MCP sunucusu mu?

Betik API ister: sabit biçim, tek çağrı, araya model girmez. Asistan MCP sunucusunu ister; araçlar kendi açıklamalarını taşıdığı için doğru çağrıyı sen entegrasyonu yazmadan seçer. İkisi de aynı ölçümle çalışıyor, ikisi de aynı önizle-onayla adımıyla yazıyor.

Bunu kendi uygulamanda gör

Mağaza linkini yapıştır, kelimelerini gir. Sıra, önündeki uygulamalar ve talep sinyali her gün ölçülür.

Ücretsiz plan: 1 uygulama, 2 vitrinin her birinde 10 kelime, 14 gün geçmiş; kart yok, süre sınırı yok. Pro aylık 29 $.

Ücretsiz başla →
Rakip setleri · bir rakiple ortak ve yalnız onda olan terimler

Devamı