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:
curl -s https://storelift.net/v1/apps \
-H "x-api-key: sl_live_..."33 uç
| Uç | Ne döndürüyor |
|---|---|
GET /v1/apps | Hesabın izlediği uygulamalar. Her çağrı buradan başlıyor — id buradan geliyor. |
GET | Tek uygulama ve son turun anlık görüntüsü. |
GET | Ü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 | Bir vitrindeki her izlenen kelimenin güncel sırası — ölçüm hâli ve taranan derinlikle. |
GET | Üstünde duran uygulamalar; her biri hangi terimlerde önünde ve iki sıra da yanında. |
GET | Asistan kategorinde uygulamanı anıyor mu, saklanan seriyle. Pro, Studio veya Enterprise gerekir. |
GET | Kelime başına sıra serisi, planın geçmiş penceresine kırpılmış. |
GET | Kendi künyen, mağazanın sunduğu hâliyle, iki platform ve üzerinde yakalanan tarihli değişikliklerle. |
GET | Son 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 | Tarihli künye değişiklikleri — sürüm, kare, etkinlik, öne çıkarılma, keyword alanı — her birinin çevresindeki kelime sırası hareketiyle. |
GET | Uygulamanın türü ve vitrini için top liste sırası, seriyle. |
GET | Uygulamanı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 | RevenueCat / Adapty webhook'undan abonelik olay sayıları — gün, ülke ve aylık cohort başına. Kapsam revenue:read. |
GET | App 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 | RevenueCat / 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 | Uygulamayı 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, uygulamasearchDepthderinliğine kadar sonuçlarda yoktu.measured: false— o gün arama koşturulamadı. Sıra hakkında hiçbir şey bilinmiyor.
{
"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/account | Anahtar kimin: plan, kimlik yöntemi, kapsamlar, okunabilen uygulamalar, kredi bakiyesi. 0 kredi. |
GET /v1/usage | Her kota kullanılan / tavan / yenilenme ile, bugünkü Hive hakkı ve saniyelik hız. 0 kredi. |
GET | Kendi uygulamalarında, izlenen kelimelerde ve rakiplerde arama; /v1/fetch için kimlik döner (ChatGPT derin araştırma biçimi). |
GET | 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üyor | Kapsam |
|---|---|---|
GET | Bir vitrinin Ücretsiz, Hasılat ya da iPad listesi (100 derin), en son günü itibarıyla. | hive:read |
GET | 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 | Bir kelimede kimin sıralandığı, gün gün (çağrı başına 1.000 satır). | hive:read |
GET | Bir rakibin sıralandığı kelimeler — panelle aynı gizlilik süzgeci ve aylık spy hakkı. | hive:spy |
GET | Herhangi bir App Store uygulamasının dünya genelinde aylık geliri ve indirmesi (ilk okuma sürerken 202). | hive:estimate |
GET | 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 | 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 | Ö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 | 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 | Hive'ın gördüğü, bir yayıncıya ait bütün uygulamalar; her birinin ilk listelendiği günle. | hive:read |
GET | 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 | 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 | 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.
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/actionshiçbir şeyi değiştirmeden önce/sonra farkını, kredi tutarını ve tek kullanımlık bir jeton döner;POST /v1/actions/confirmonu uygular. Jeton eyleme, argümanlara ve hedefin önizleme anındaki hâline bağlı; arada hedef değiştiyse onay yeni farkla birlikteconfirm_token_mismatchdö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) hassasrevenue:read/ads:readkapsamıyla açılmış anahtara cevap veriyor; yani bir anahtar gelir verisini ancak sen seçersen açar. GA4 panelde. - Geçmiş plana göre.
historyvechartsplanın penceresini uyguluyor; aynı anahtar iki uçtan da tam olarak aynı yere kadar uzanıyor.
Hatalar
| Durum | error | Ne zaman |
|---|---|---|
| 400 | key_in_url | Anahtar 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. |
| 401 | missing_api_key | İstekte anahtar yok. |
| 401 | invalid_api_key | Anahtar tanınmıyor ya da iptal edilmiş. |
| 401 | account_deleted | Anahtarın ait olduğu hesap silinmiş. |
| 403 | plan_required | Plan API erişimi içermiyor. Yanıt mevcut planı da taşıyor. |
| 405 | method_not_allowed | Okumalar GET; POST /v1/actions, /v1 ve /v1 yollarında (taslak gövdede gider). |
| 400 | unknown_action | Eylem adı katalogda yok; yanıt olanları listeliyor. |
| 400 | invalid_arguments | Bir argüman eksik ya da hatalı; yanıt alanın adını veriyor. |
| 409 | confirm_token_expired | Jeton 10 dakikadan eski. Yeniden önizle. |
| 409 | confirm_token_mismatch | Önizlemeden sonra hedef değişti; yanıt yeni farkı taşıyor. |
| 403 | write_limit_reached | Yazma korkulukların dışında (bütçe adımı, günlük Apple Ads eylemi, günlük yazma: 200 takip / 50 yorum cevabı). |
| 403 | test_key_read_only | Test anahtarları yazmıyor. |
| 404 | job_not_found | Bu çalışma alanında o kimlikle bir iş yok. |
| 403 | workspace_suspended | Çalışma alanı askıya alınmış; sebebini destek söyleyebilir. |
| 403 | ip_list_required | Bu çalışma alanı her anahtarın IP izin listesi taşımasını istiyor. |
| 404 | not_found | O uygulama kimliği bu hesapta yok. |
| 404 | unknown_endpoint | /v1 altında böyle bir yol yok. |
| 402 | credits_exhausted | Bu ayın kredisi bitti; yanıt kredi paketine bağlantı taşıyor. |
| 429 | rate_limited | Bu anahtar için çok fazla istek; Retry-After saniyesi kadar bekle. |
| 429 | daily_hive_limit | Planın bugünkü Hive hakkı bitti; 00:00 UTC'de yenilenir. |
| 404 | not_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. |
| 400 | bad_query | /v1/search 1–120 karakterlik q ister. |
| 400 | bad_id | /v1/fetch kimliği /v1/search'ün döndürdüğü gibi ister. |
| 403 | asc_required | update_listing bağlı bir App Store Connect anahtarı ister. |
| 403 | asc_role | App Store Connect anahtarının metadata yazması için Admin ya da App Manager rolü gerekiyor. |
| 409 | no_editable_version | Düzenlenebilir App Store sürümü yok; yanıt sürümlerin o anki hâllerini listeliyor. |
| 404 | locale_not_found | O vitrin dili sürümde yok; yanıt olanları listeliyor. |
| 409 | changed_since_preview | Önizlemeden sonra vitrin App Store Connect'te değişti; hiçbir şey yazılmadı. |
| 422 | asc_rejected | App Store Connect değişikliği reddetti; kendi mesajı detail alanında. |
| 409 | in_progress | Aynı hedef için bir yazma hâlâ sürüyor. |
| 403 | ip_not_allowed | Anahtarın IP izin listesi var ve istek başka bir adresten geldi. |
| 401 | key_leaked | Anahtar 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 →
