Hive uçları

Storelift ağının ölçtüğü herhangi bir uygulama ya da pazar; sen izlesen de izlemesen de. Hive Explorer'ın parçası.

Kimlik doğrulama · Kredi · Ortak parametreler · Hata kodları · openapi.json

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

Parametre	Yer	Tür	Açıklama
`app`zorunlu	query	string	App Store bağlantısı ya da kimliği, veya Google Play bağlantısı ya da paket adı
`term`zorunlu	query	string	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

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

Parametre	Yer	Tür	Açıklama
`term`zorunlu	query	string	arama terimi, ör. habit tracker
`cc`	query	string	vitrin kodu, ör. us

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

Parametre	Yer	Tür	Açıklama
`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

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

Parametre	Yer	Tür	Açıklama
`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

Ayrıca kabul ettikleri: country

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

Kum havuzunda aç

Örnek yanıt

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

Parametre	Yer	Tür	Açıklama
`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

Ayrıca kabul ettikleri: country

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

Parametre	Yer	Tür	Açıklama
`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

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

Parametre	Yer	Tür	Açıklama
`publisherId`zorunlu	path	string	yayıncı kimliği, ör. market_new_apps'ten

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

Parametre	Yer	Tür	Açıklama
`q`zorunlu	query	string	uygulama adı, geliştirici adı, mağaza bağlantısı, App Store kimliği ya da paket adı
`limit`	query	number	sonuç sayısı, en fazla 25 (varsayılan 10)

Ayrıca kabul ettikleri: country

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

Parametre	Yer	Tür	Açıklama
`appId`zorunlu	path	string	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)

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

Parametre	Yer	Tür	Açıklama
`appId`zorunlu	path	string	App Store kimliği (ör. 570060128) ya da Google Play paket adı
`limit`	query	number	yorum sayısı, en fazla 200 (varsayılan 50)

Ayrıca kabul ettikleri: country

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

Parametre	Yer	Tür	Açıklama
`term`zorunlu	path	string	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

{"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

Parametre	Yer	Tür	Açıklama
`id`zorunlu	path	string	App Store kimliği (5–12 rakam) ya da Google Play paket adı.

Ayrıca kabul ettikleri: country

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

Kum havuzunda aç

Örnek yanıt

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

Parametre	Yer	Tür
`term`zorunlu	path	string
`top`	query	integer
`days`	query	integer

Ayrıca kabul ettikleri: country · platform

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

Kum havuzunda aç

Örnek yanıt

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

Parametre	Yer	Tür	Açıklama
`term`zorunlu	path	string	NFC ile normalleştirilmiş, baştaki ve sondaki boşlukları kırpılmış ve küçük harfe çevrilmiş. İçteki boşluklar anlamlıdır.
`platform`	query	ios	varsayılan ios

Ayrıca kabul ettikleri: country

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

Kum havuzunda aç

Örnek yanıt

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

Parametre	Yer	Tür	Açıklama
`term`zorunlu	path	string	NFC ile normalleştirilmiş, baştaki ve sondaki boşlukları kırpılmış ve küçük harfe çevrilmiş. İçteki boşluklar anlamlıdır.
`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.

Ayrıca kabul ettikleri: country

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

Kum havuzunda aç

Örnek yanıt

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

Parametre	Yer	Tür	Açıklama
`id`zorunlu	path	string	App Store kimliği (5–12 rakam) ya da Google Play paket adı.

Ayrıca kabul ettikleri: country · platform

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

Kum havuzunda aç

Örnek yanıt

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

Parametre	Yer	Tür	Açıklama
`id`zorunlu	path	string	App Store kimliği.

Ayrıca kabul ettikleri: country

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

Kum havuzunda aç

Örnek yanıt

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

Parametre	Yer	Tür	Açıklama
`ids`zorunlu	query	string	Virgülle ayrılmış uygulama kimlikleri, en az 2.

Ayrıca kabul ettikleri: country · platform

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

Parametre	Yer	Tür	Açıklama
`seed`zorunlu	query	string	Tohum kelime.
`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ı.

Ayrıca kabul ettikleri: country

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

Parametre	Yer	Tür	Açıklama
`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.

Ayrıca kabul ettikleri: country

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

Hive uçları

GET /rank-check

GET /keyword-difficulty

GET /hive/find

GET /hive/charts

GET /hive/movers

GET /hive/new

GET /hive/publisher/{publisherId}

GET /hive/resolve

GET /hive/similar/{appId}

GET /hive/reviews/{appId}

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

GET /hive/apps/{id}

GET /hive/keywords/{term}/ranks

GET /hive/keywords/{term}/metrics

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

GET /hive/spy/{id}

GET /hive/estimate/{id}

GET /hive/gap

GET /hive/research

GET /hive/landscape

GET `/rank-check`

GET `/keyword-difficulty`

GET `/hive/find`

GET `/hive/charts`

GET `/hive/movers`

GET `/hive/new`

GET `/hive/publisher/{publisherId}`

GET `/hive/resolve`

GET `/hive/similar/{appId}`

GET `/hive/reviews/{appId}`

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

GET `/hive/apps/{id}`

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

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

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

GET `/hive/spy/{id}`

GET `/hive/estimate/{id}`

GET `/hive/gap`

GET `/hive/research`

GET `/hive/landscape`