Hive

Find apps across the top charts we measure: filter by category, storefront, chart (Top Grossing, Top Free,…

Find apps across the top charts we measure: filter by category, storefront, chart (Top Grossing, Top Free, Top Paid or Top iPad), rank range, first-seen date, name or publisher, and by monthly revenue, monthly downloads or 30-day growth. Pass estimates: true to get each row's monthly revenue and downloads from Hive, one figure each, with the day of the figure. When a revenue, download or growth filter is set, apps Hive has no figure for yet are left out and counted in noEstimate. 20 credits for the list; with figures, or with a revenue, download or growth filter, 50 more per row returned. The answer carries coverage, the day the first-seen index opens, so every date you read is a day we indexed.

get/hive/find

Request

  • Base URL: https://storelift.net/v1
  • URL: https://storelift.net/v1/hive/find
  • Auth: one of:
    • HTTP bearer
    • API key in header x-api-key

Query parameters

genrestring

up to 3 Apple genre ids, comma separated, e.g. 6007,6012

countrystring

up to 5 storefront codes, comma separated, e.g. us,gb

kindstring

grossing, free, paid or ipad (which chart the app is on)

releasednumber

first seen within the last N months

rankMinnumber

best chart rank at least this

rankMaxnumber

best chart rank at most this

revenueMinnumber

monthly gross revenue at least this (USD)

revenueMaxnumber

monthly gross revenue at most this (USD)

downloadsMinnumber

monthly downloads at least this

downloadsMaxnumber

monthly downloads at most this

growthMinnumber

30-day change at least this, in percent (e.g. 20)

growthMaxnumber

30-day change at most this, in percent

textstring

match on app name or publisher name

publisherstring

publisher id from market_publisher

estimatesboolean

true adds monthly revenue and downloads to every row (50 credits per row)

limitnumber

rows per page, 50 by default, up to 200

pagenumber

result page, 1 by default

Response

OK

filtersunknown required
measuredListsunknown required
noEstimateunknown required
poolTruncatedunknown required
estimatesReadunknown required
metaHiveMeta (unresolved $ref)

Changes

No recorded changes to this operation across all 1 revision of this API.