# Storelift API'si

URL: https://storelift.net/tr/rehber/storelift-api/
Language: tr
Updated: 2026-09-20

Panelin gösterdiği her şey aynı zamanda bir JSON ucu. 9 tane, hepsi GET, hepsi senin izlediğin uygulamaların üstünde — yani bir betik, bir tablo işi ya da bir CI adımı aynı sayıları sayfa kazımadan okuyabiliyor. API Pro ve Studio planlarında; aynı veriyi bir asistan okuyacaksa doğru yer genellikle MCP sunucusu.

## 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_..."

NOTE: API erişimi Pro ve Studio planlarında — ayda 20 $'dan başlıyor, Studio 60 $. Plan düşerse anahtar çalışmayı bırakıyor ama silinmiyor; tekrar yükseltince aynı entegrasyon kaldığı yerden çalışıyor.

## 9 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.

## Üç ö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.

## Yapmadığı şeyler

- Yazmıyor. Her uç GET; başka bir yöntem method_not_allowed dö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. history ve charts aynı pencereyi uyguluyor; aynı anahtar bir uçtan ötekinden daha geriye uzanamıyor.

## Hatalar

| 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.

## FAQ

Q: Hız sınırı var mı?
A: 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.

Q: Ücretsiz planda kullanabilir miyim?
A: 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.

Q: API mi MCP sunucusu mu?
A: 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.