# Hive uçları

> https://storelift.net/tr/docs/api/hive/

Storelift ağının ölçtüğü herhangi bir uygulama ya da pazar; sen izlesen de izlemesen de. Hive Explorer'ın parçası. Temel adres `https://storelift.net/v1` · kimlik doğrulama, kredi ve ortak parametreler: https://storelift.net/tr/docs/api/

## GET /rank-check

Uygulamalarından birinin tek bir vitrinde herhangi bir arama terimindeki canlı sırası, mağazanın şu anda gösterdiği hâliyle — terimin izleniyor olması gerekmez. Durum, halleri birbirinden ayırır: sıra ve hemen üstteki uygulamalarla `ranked`, üst sonuçlarla `absent` (uygulama orada satılıyor ve bu sonuçların dışında kalıyor), `not_in_store` (uygulama o vitrinde satılmıyor).

Kapsam: `apps:read` · Kredi: 10 · Plan: Free

- `app` (query, string, zorunlu) — App Store bağlantısı ya da kimliği, veya Google Play bağlantısı ya da paket adı
- `term` (query, string, zorunlu) — arama terimi, ör. habit tracker
- `cc` (query, string) — vitrin kodu, ör. us
- `platform` (query, ios | android) — isteğe bağlı; uygulama bağlantısından okunur

```sh
curl "https://storelift.net/v1/rank-check?app=us&term=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"
```

## GET /keyword-difficulty

Tek bir vitrinde bir App Store arama terimi için talep ve zorluk girdileri: talebi (`demand`) ve ilgili aramalar, puan sayılarıyla ve terimin başlıklarında geçip geçmediğiyle üst sonuçlar, bunlar arasındaki en yüksek ve medyan puan sayısı ve sonuçların ne kadar derine indiği. `thin`, ondan az sonucu olan terimi; `zayifEslesme`, mağazanın gevşek eşleştirdiği terimi işaretler. Free, hesabın o vitrinde izlediği terimleri okur; Pro ve üstü her terimi okur.

Kapsam: `apps:read` · Kredi: 10 · Plan: Free

- `term` (query, string, zorunlu) — arama terimi, ör. habit tracker
- `cc` (query, string) — vitrin kodu, ör. us

```sh
curl "https://storelift.net/v1/keyword-difficulty?term=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"
```

## GET /hive/find

Ölçtüğümüz üst listelerde uygulama bul: kategoriye, vitrine, listeye (Top Grossing, Top Free, Top Paid ya da Top iPad), sıra aralığına, ilk görülme tarihine, ada ya da yayıncıya ve aylık gelire, aylık indirmeye ya da 30 günlük büyümeye göre süz. Her satırın aylık gelirini ve indirmesini Hive'dan almak için `estimates: true` gönder; her biri tek rakam, rakamın günüyle birlikte. Gelir, indirme ya da büyüme süzgeci ayarlandığında Hive'ın henüz rakamı olmayan uygulamalar dışarıda kalır ve `noEstimate` içinde sayılır. Liste için 20 kredi; rakamlarla ya da gelir, indirme veya büyüme süzgeciyle, dönen satır başına 50 kredi daha. Cevap, ilk görülme dizininin açıldığı günü gösteren `coverage` alanını taşır; böylece okuduğun her tarih dizine aldığımız bir gündür.

Kapsam: `hive:read` · Kredi: 20 · Plan: Hive Explorer

- `genre` (query, string) — en fazla 3 Apple genre kimliği, virgülle ayrılmış, ör. 6007,6012
- `country` (query, string) — en fazla 5 vitrin kodu, virgülle ayrılmış, ör. us,gb
- `kind` (query, string) — grossing, free, paid ya da ipad (uygulamanın hangi listede olduğu)
- `released` (query, number) — son N ay içinde ilk kez görülen
- `rankMin` (query, number) — en iyi liste sırası en az bu değer
- `rankMax` (query, number) — en iyi liste sırası en fazla bu değer
- `revenueMin` (query, number) — aylık brüt gelir en az bu değer (USD)
- `revenueMax` (query, number) — aylık brüt gelir en fazla bu değer (USD)
- `downloadsMin` (query, number) — aylık indirme en az bu değer
- `downloadsMax` (query, number) — aylık indirme en fazla bu değer
- `growthMin` (query, number) — 30 günlük değişim en az bu değer, yüzde olarak (ör. 20)
- `growthMax` (query, number) — 30 günlük değişim en fazla bu değer, yüzde olarak
- `text` (query, string) — uygulama adında ya da yayıncı adında eşleşme
- `publisher` (query, string) — market_publisher'dan gelen yayıncı kimliği
- `estimates` (query, boolean) — true, her satıra aylık gelir ve indirmeyi ekler (satır başına 50 kredi)
- `limit` (query, number) — sayfa başına satır, varsayılan 50, en fazla 200
- `page` (query, number) — sonuç sayfası, varsayılan 1

```sh
curl "https://storelift.net/v1/hive/find?country=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"
```

## GET /hive/charts

Son ölçtüğümüz hâliyle tek bir üst liste: bir vitrin, liste türü ve isteğe bağlı kategori için sıralı uygulama kimlikleri, okunduğu günle birlikte. Her sıranın aylık değeri (Top Grossing'de gelir, Top Free'de indirme) ve 10., 50. ve 100. sıradan girmek için gereken değer için `estimates: true` gönder. Liste için 10 kredi; estimates ile, dönen satır başına 50 kredi daha. Yalnız App Store — Google Play'in herkese açık bir üst listesi yok; orada bir sayı uydurma olurdu.

Kapsam: `hive:read` · Kredi: 10 · Plan: Hive Explorer

- `country` (query, string) — vitrin kodu, ör. us (varsayılan us)
- `kind` (query, string) — free, paid ya da grossing
- `genre` (query, string) — Apple genre kimliği, ör. 6007; genel liste için boş bırak
- `limit` (query, number) — satır sayısı, en fazla 100

```sh
curl "https://storelift.net/v1/hive/charts?country=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"
```

## GET /hive/movers

Tek bir üst listede kim yükseldi, kim düştü, kim girdi, kim çıktı; N gün önceki aynı listeye göre. `measured`, karşılaştırma gününün elde olduğunu söyler; böylece okuduğun her fark ölçülmüş iki gün arasındadır. Listeden çıkan uygulamalar fark yerine son sıralarını taşır, çünkü bugün listenin dışındadırlar.

Kapsam: `hive:read` · Kredi: 10 · Plan: Hive Explorer

- `country` (query, string) — vitrin kodu, ör. us (varsayılan us)
- `kind` (query, string) — free, paid ya da grossing
- `genre` (query, string) — Apple genre kimliği; genel liste için boş bırak
- `days` (query, number) — N gün öncesiyle karşılaştır, en fazla 90
- `limit` (query, number) — yön başına satır, en fazla 100

```sh
curl "https://storelift.net/v1/hive/movers?country=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"
```

## GET /hive/new

Bir üst listede ilk kez görülen uygulamalar, en yeni en üstte, her birinin arkasındaki yayıncıyla. `daysCovered`, istenen günlerin kaçının dizinde olduğunu söyler; böylece okuduğun her ilk görülme tarihi dizine aldığımız bir gündür.

Kapsam: `hive:read` · Kredi: 10 · Plan: Hive Explorer

- `days` (query, number) — N gün geriye bak, en fazla 30
- `country` (query, string) — vitrin kodu; bütün vitrinler için boş bırak
- `limit` (query, number) — satır sayısı, en fazla 200

```sh
curl "https://storelift.net/v1/hive/new?country=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"
```

## GET /hive/publisher/{publisherId}

Bir yayıncının bir listede gördüğümüz bütün uygulamaları, her birinin ilk görüldüğü günle. Yayıncının hiç listeye girmemiş uygulamaları burada yok — var olanı değil, ölçtüğümüzü listeleriz.

Kapsam: `hive:read` · Kredi: 10 · Plan: Hive Explorer

- `publisherId` (path, string, zorunlu) — yayıncı kimliği, ör. market_new_apps'ten

```sh
curl "https://storelift.net/v1/hive/publisher/1000000900" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"
```

## GET /hive/resolve

Herhangi bir uygulamanın kimliğini bul: ada ya da geliştiriciye göre (o vitrindeki en iyi eşleşmeler; yayıncı, kategori, puan ve puan sayısıyla) ya da bir App Store / Google Play bağlantısından, yalın bir App Store kimliğinden veya paket adından. Elinde yalnızca ad varken hive_app_details, hive_similar_apps ya da hive_app_reviews'tan önce kullan.

Kapsam: `hive:read` · Kredi: 10 · Plan: Hive Explorer

- `q` (query, string, zorunlu) — uygulama adı, geliştirici adı, mağaza bağlantısı, App Store kimliği ya da paket adı
- `country` (query, string) — vitrin kodu, ör. us (varsayılan us)
- `limit` (query, number) — sonuç sayısı, en fazla 25 (varsayılan 10)

```sh
curl "https://storelift.net/v1/hive/resolve?q=sleep&country=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"
```

## GET /hive/similar/{appId}

Herhangi bir uygulama için mağazanın kendi benzer uygulamalar rafı (Apple'ın You Might Also Like, Google'ın Similar apps rafı), raf sırasıyla; her uygulamanın kategorisi, adı ve yayıncısı ile rafın okunduğu günle birlikte. Raftaki kategoriler, mağazanın uygulamayı hangi kalabalığın içine koyduğunu gösterir.

Kapsam: `hive:read` · Kredi: 10 · Plan: Hive Explorer

- `appId` (path, string, zorunlu) — App Store kimliği (ör. 570060128) ya da Google Play paket adı
- `country` (query, string) — vitrin kodu, ör. us (boş = herhangi bir vitrinde en son okunan raf)

```sh
curl "https://storelift.net/v1/hive/similar/sbx-lumen?country=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"
```

## GET /hive/reviews/{appId}

Herhangi bir uygulamanın tek bir vitrindeki son yorumları, en yeni en üstte: yıldız, başlık, metin, sürüm ve tarih; ayrıca dönen satırların yıldız dağılımı. Yorumcu adları çıkarılır. Hive'da henüz olmayan bir uygulama ilk çağrıda eklenir.

Kapsam: `hive:read` · Kredi: 10 · Plan: Hive Explorer

- `appId` (path, string, zorunlu) — App Store kimliği (ör. 570060128) ya da Google Play paket adı
- `country` (query, string) — vitrin kodu, ör. us (varsayılan us)
- `limit` (query, number) — yorum sayısı, en fazla 200 (varsayılan 50)

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

## POST /hive/keywords/{term}/metrics/measure

Saklanan değer eksik ya da eskiyse, tek bir vitrinde bir kelimenin popülerliği ve/veya zorluğu için ölçüm başlat. Taze bir değer ya da doğrulanmış yokluk yeni iş yapılmadan döner; zaten çalışan bir işe katılan istek günlük ölçüm biriminden harcamaz; yeni iş başlatan istek, çalışma alanının günlük Hive ölçüm hakkından bir birim kullanır. İki metrik birbirinden bağımsızdır: başarısız bir kaynak, geçerli olan diğer metriği cevapta bırakır. `wait` (0–20 saniye) sonuç saklanana kadar çağrıyı açık tutar; 202 hâlâ çalıştığını gösterir — sonra hive_keyword_metrics ile oku. Ayrıca açılması gereken hive:measure kapsamını ister: API anahtarında seçilir ya da OAuth ile bağlanırken ayrıca onaylanır. Yalnız iOS.

Kapsam: `hive:measure` · Kredi: 50 · Plan: Hive Explorer

- `term` (path, string, zorunlu) — tam kelime, ör. habit tracker
- `country` (body, string) — vitrin kodu, ör. us (varsayılan us)
- `platform` (body, string)
- `metrics` (body, array) — hangi metriklerin ölçüleceği (varsayılan ikisi de)
- `wait` (body, number) — saklanan sonuç için beklenecek saniye, 0–20 (boş bırakılırsa bu araç 15 gönderir; HTTP API varsayılanı 0)

Yeni bir iş başlatmak çalışma alanının günlük Hive ölçüm hakkından bir tane kullanır; bu yüzden burada kopyalanacak komut yok.

İstek gövdesi:

```json
{"country":"us","platform":"ios","metrics":["popularity","difficulty"],"wait":15}
```

## GET /hive/apps/{id}

Ağın herhangi bir uygulama için en son gününde ölçtüğü mağaza ayrıntıları: ad, puan sayısı, puan, sürüm, fiyat, dağılım, rozet ve uygulama içi satın alma sayısı. App Store uygulamalarında `listingExtras`; desteklenen 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ı kendi `measuredAt` günüyle ekler; ölçülmediyse null'dır. `not_measured`, uygulamanın eklenmesi gereken vitrinleri gösterir.

Kapsam: `hive:read` · Kredi: 10 · Plan: Hive Explorer

- `id` (path, string, zorunlu) — App Store kimliği (5–12 rakam) ya da Google Play paket adı.
- `country` (query, string) — vitrin kodu, ör. us (varsayılan us)

```sh
curl "https://storelift.net/v1/hive/apps/1000000001?country=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"
```

## GET /hive/keywords/{term}/ranks

Ağın ölçtüğü herhangi bir kelimenin üst sonuçları, gün gün. `top` büyük olduğunda `days` küçülür; böylece tek çağrı 1.000 satırın altında kalır. 7 güne kadar 10 kredi, 30 güne kadar 20, 90 güne kadar 40.

Kapsam: `hive:read` · Kredi: 10 · Plan: Hive Explorer

- `term` (path, string, zorunlu)
- `country` (query, string) — vitrin kodu, ör. us (varsayılan us)
- `platform` (query, ios | android) — varsayılan ios
- `top` (query, integer)
- `days` (query, integer)

```sh
curl "https://storelift.net/v1/hive/keywords/sleep/ranks?country=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"
```

## GET /hive/keywords/{term}/metrics

Tam bir kelime ve vitrin için mevcut Hive gözlemlerini oku. Popülerlik 1 ile 100 arasında bir tam sayıdır; zorluk 0 ile 100 arasında bir puandır. Eksik veri null kalır. Her metrik kendi kanıtını, kaynak zamanını, tazeliğini ve son deneme durumunu taşır. Bu GET asla kaynak isteği ya da ölçüm işi başlatmaz. Hive Explorer ürününün tamamını gerektirir; Android açıkça desteklenmez.

Kapsam: `hive:read` · Kredi: 10 · Plan: Hive Explorer

- `term` (path, string, zorunlu) — NFC ile normalleştirilmiş, baştaki ve sondaki boşlukları kırpılmış ve küçük harfe çevrilmiş. İçteki boşluklar anlamlıdır.
- `country` (query, string) — vitrin kodu, ör. us (varsayılan us)
- `platform` (query, ios) — varsayılan ios

```sh
curl "https://storelift.net/v1/hive/keywords/sleep/metrics?country=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"
```

## GET /hive/keywords/{term}/metrics/history

Bir kelimenin saklanan günlük geçmişini oku: her gün kaydedilen arama sonuçları, zorluk puanı ve Apple popülerliği. Geçmiş zorluk değerleri kaydedildikleri gibi kalır. Başarısız ve eksik günler öyle işaretlenir; saklanmış kaydı olmayan bir gün sıfır ya da doğrulanmış yokluk değildir. pagination.nextCursor'ı aynı keyword, storefront ve days ile izle. Her seri kendi başına sayfalanır, sayfa başına en fazla 200 kayıtla. Bu GET yalnız saklanan geçmişi okur, asla ölçüm başlatmaz. Hive Explorer ürününün tamamını gerektirir; Android açıkça desteklenmez. 7 güne kadar 10 kredi, 30 güne kadar 20, 90 güne kadar 40.

Kapsam: `hive:read` · Kredi: 20 · Plan: Hive Explorer

- `term` (path, string, zorunlu) — NFC ile normalleştirilmiş, baştaki ve sondaki boşlukları kırpılmış ve küçük harfe çevrilmiş. İçteki boşluklar anlamlıdır.
- `country` (query, string) — vitrin kodu, ör. us (varsayılan us)
- `platform` (query, ios) — varsayılan ios
- `days` (query, integer) — Bugün dahil UTC takvim günleri. Popülerlik revizyonları, bu aralıktaki kaynak hafta başlangıcına göre seçilir.
- `cursor` (query, string) — Tam olarak bu sorgunun pagination.nextCursor değerinden gelen opak devam belirteci.

```sh
curl "https://storelift.net/v1/hive/keywords/sleep/metrics/history?country=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"
```

## GET /hive/spy/{id}

Ağın bir uygulamayı ölçtüğü bütün kelimeler, sırasıyla birlikte. Her çağrı krediyle ödenir; gösterilecek kelimesi olmayan bir uygulama 1 kredi tutar.

Kapsam: `hive:spy` · Kredi: 200 · Plan: Hive Explorer

- `id` (path, string, zorunlu) — App Store kimliği (5–12 rakam) ya da Google Play paket adı.
- `country` (query, string) — vitrin kodu, ör. us (varsayılan us)
- `platform` (query, ios | android) — varsayılan ios

```sh
curl "https://storelift.net/v1/hive/spy/1000000104?country=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"
```

## GET /hive/estimate/{id}

Herhangi bir App Store uygulamasının dünya genelindeki aylık geliri ve indirmesi: her biri tek rakam (`value`, ya da uygulama o tutarın altındaysa `under`) ve kaç pazarı kapsadığı. Her uygulama bir cevap alır. Hive onları zaten biliyor. Bir uygulama için ilk istek okumayı başlatır ve `eta` saniyeyle 202 cevabı verir. Rakamlar için 500 kredi; bekleyen cevap 1 kredi.

Kapsam: `hive:estimate` · Kredi: 500 · Plan: Hive Explorer

- `id` (path, string, zorunlu) — App Store kimliği.
- `country` (query, string) — vitrin kodu, ör. us (varsayılan us)

```sh
curl "https://storelift.net/v1/hive/estimate/1000000001?country=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"
```

## GET /hive/gap

En fazla 5 uygulamanın kelime listeleri yan yana, kelime başına bir satır: her uygulamanın sırası, kelimeyi kaçının tuttuğu ve hangilerinde eksik olduğu. Karşılaştırılan uygulama başına 200 kredi; dizin dışındaki bir uygulama ücretlendirilmez. Explorer'ın parçasıdır.

Kapsam: `hive:spy` · Kredi: 400 · Plan: Hive Explorer

- `ids` (query, string, zorunlu) — Virgülle ayrılmış uygulama kimlikleri, en az 2.
- `country` (query, string) — vitrin kodu, ör. us (varsayılan us)
- `platform` (query, ios | android) — varsayılan ios

```sh
curl "https://storelift.net/v1/hive/gap?ids=1000000001,1000000104&country=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"
```

## GET /hive/research

Bir tohum kelime yaz, ilgili App Store arama terimlerini al; her biri Apple popülerliği (gözlemlendiğinde 1–100; eksik değerler null kalır), zorluk (0–100), kaç uygulamanın sıralandığı ve ilk 10 uygulamayla. Metrik kanıtı ölçülmüş değeri, doğrulanmış yokluğu, bekleyen işi ve kaynak hatalarını birbirinden ayırır. Etkin ölçüm satırları `state: "pending"` taşır; sonucu okumak için isteği yinele. App Store bir terimin yazımını düzelttiğinde satır, düzeltilmiş aramayı `spell` alanında taşır. Uygulama gerekmez. Explorer'ın parçasıdır.

Kapsam: `hive:read` · Kredi: 50 · Plan: Hive Explorer

- `seed` (query, string, zorunlu) — Tohum kelime.
- `country` (query, string) — vitrin kodu, ör. us (varsayılan us)
- `compare` (query, string) — En fazla 5 vitrin daha, virgülle ayrılmış (ör. de,fr): aynı terimlerin her birindeki popülerliği, zorluğu ve uygulama sayısı.

```sh
curl "https://storelift.net/v1/hive/research?seed=us&country=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"
```

## GET /hive/landscape

Bir vitrinin üst ücretsiz listesinden kategori manzarası: ilk 10'un puan duvarı, medyan puan, ad uzunluğu, çıkış ve güncelleme tazeliği, diller, boyut ve birden çok uygulaması olan yayıncılar. Her kategori kendi ölçüm gününü taşır.

Kapsam: `hive:read` · Kredi: 10 · Plan: Hive Explorer

- `country` (query, string) — vitrin kodu, ör. us (varsayılan us)
- `genre` (query, string) — App Store genre kimliği (ör. 6014) ya da kategori anahtarı (all, games, entertainment, photo-video, productivity, health-fitness, education, lifestyle, finance, social-networking). Ölçülen bütün kategoriler için boş bırak.

```sh
curl "https://storelift.net/v1/hive/landscape?country=us" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"
```