Hive

Read stored keyword metric observations over time

Read a keyword's stored daily history: the search results, the difficulty score and the Apple popularity recorded on each day. Past difficulty values stay as they were recorded. Failed and incomplete days are marked as such; a day without a stored record is not a zero or a verified absence. Follow pagination.nextCursor with the same keyword, storefront and days. Each series is paged on its own, with up to 200 records per page. This GET reads stored history only and never starts a measurement. Requires the full Hive Explorer product; Android is explicitly unsupported. 10 credits for up to 7 days, 20 for up to 30, 40 for up to 90.

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

Request

  • Base URL: https://storelift.net/v1
  • URL: https://storelift.net/v1/hive/keywords/{term}/metrics/history
  • Auth: one of:
    • HTTP bearer
    • API key in header x-api-key

Path parameters

termstring required

NFC-normalized, trimmed and lowercased. Internal whitespace remains significant.

Query parameters

countrystring

storefront code, e.g. us (defaults to us)

platform'ios'

defaults to ios

daysinteger

UTC calendar days including today. Popularity revisions are selected by their source week start within this range.

cursorstring

Opaque continuation from this exact query's pagination.nextCursor.

Response

OK

metricReadVersionunknown required
historicalunknown required
countrystring required
platform'ios' required
termstring required
fromstring date required
tostring date required
readStatusobject required
measurementStartedunknown required

Changes

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