01Taban 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_..."029 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 /v1/apps/{id} | Tek uygulama ve son turun anlık görüntüsü. |
GET /v1/apps/{id}/keywords | Bir 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}/ai | Asistan kategorinde uygulamanı anıyor mu, saklanan seriyle. Ölçümü Studio yapıyor. |
GET /v1/apps/{id}/history | Kelime başına sıra serisi, planın geçmiş penceresine kırpılmış. |
GET /v1/apps/{id}/page | Kendi künyen, mağazanın sunduğu hâliyle, iki platform ve üzerinde yakalanan tarihli değişikliklerle. |
GET /v1/apps/{id}/reviews | Son yorumlar; yıldız özeti, bu turda gelen yeni sayısı ve ölçüldüyse Play tarafı. |
GET /v1/apps/{id}/charts | Uygulamanın türü ve vitrini için top liste sırası, seriyle. |
/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.
03Üç ö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 okuduğumuz derinlikte 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.
04Yapmadığı şeyler
- Yazmıyor. Her uç
GET; başka bir yöntemmethod_not_alloweddönüyor. API'den künyene, izlediğin kelimelere ya da faturalandırmana giden bir yol yok. - İstek üzerine ölçmüyor. Uçlar gecelik turun topladığını okuyor. İki kez sormak mağazalara ikinci bir sorgu göndermiyor.
- Gelir katmanını taşımıyor. Bağlı hesaplar (App Store Connect, Apple Ads, RevenueCat, GA4) panelde kalıyor — bu bilinçli bir sınır, eksik değil.
- Geçmiş plana göre kırpılıyor.
historyvechartsaynı pencereyi uyguluyor; aynı anahtar bir uçtan ötekinden daha geriye uzanamıyor.
05Hatalar
| Durum | error | Ne zaman |
|---|---|---|
| 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 | Her uç GET. Hiçbiri yazmıyor. |
| 404 | not_found | O uygulama kimliği bu hesapta yok. |
| 404 | unknown_endpoint | /v1 altında böyle bir yol yok. |
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ı?
Anahtar başına kota yok. API'nin önündeki ağ geçidinde hesap genelinde bir tavan var, ayrıca her çağrı 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?
Hayır — API Pro'dan başlıyor. Bu sitedeki ücretsiz araçlar ise hiç hesap istemiyor ve ücretsiz plan bir uygulamayı yine 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çümü okuyor.
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 25 kelime, 30 gün geçmiş; kart yok, süre sınırı yok. Pro aylık 20 $.
Ücretsiz başla →