---
title: "Any app's latest daily measurement"
method: GET
path: "/hive/apps/{id}"
tags: ["Hive"]
---

# Any app's latest daily measurement

`GET /hive/apps/{id}`

## Request

- Base URL: `https://storelift.net/v1`
- URL: `https://storelift.net/v1/hive/apps/{id}`
- Auth: one of:
  - HTTP bearer
  - API key in header `x-api-key`

Store details the network measured for any app on its latest day: name, ratings, rating, version, price, distribution, badge and in-app purchase count. For App Store apps, `listingExtras` adds supported languages, the star breakdown (1★ to 5★), live and upcoming in-app events, promotional text and featured in-app purchases, with its own `measuredAt`; it is null when not measured. `not_measured` points to the storefronts to add the app to.

## Path parameters

- `id` string, required

## Query parameters

- `country` string

## Response `200`

OK

- object
  - `id` string, required
  - `country` string, required
  - `platform` string, required
  - `day` string, required
  - `name` string, required
  - `ratings` integer, nullable, required
  - `rating` number, required
  - `version` string, required
  - `price` integer, required
  - `distribution` unknown[], required
    - unknown
  - `badge` object, required
  - `iapCount` integer, required
  - `listingExtras` ListingExtras, required: Listing extras measured for one App Store storefront, with their own `measuredAt`. A field that was not measured is null; an empty list was measured and holds nothing.
    - `measuredAt` string, date, nullable, required
    - `localeCount` integer, nullable, required: How many languages the app supports.
    - `locales` string[], nullable, required: BCP-47 tags in the app's own order; the first is its primary language.
    - `ratingHistogram` integer[], nullable, required: Rating counts from 1★ to 5★.
    - `upcomingEvents` object[], nullable: Live (`happening`) and scheduled (`available`) in-app events, soonest first.
      - `id` string, required
      - `name` string, nullable, required
      - `kind` unknown, required
      - `badge` unknown, required
      - `startsAt` string, date-time, nullable, required
      - `endsAt` string, date-time, nullable, required
    - `promoText` string, nullable
    - `featuredIaps` object[], nullable
      - `id` string, required
      - `name` string, nullable, required
      - `kind` 'subscription' | 'purchase', required
    - `locked` object: Only on your own apps' Free answers, never on Hive: how many of the held-back items there are. The held-back fields are left out.
      - `upcomingEvents` integer
      - `featuredIaps` integer
      - `promoText` unknown
  - `meta` HiveMeta (unresolved $ref)

## Other responses

- `400`: A parameter is missing or malformed.
- `401`: No key, or the key is not valid.
- `402`: This month's credits are used up.
- `403`: The key's plan or scopes do not cover this call.
- `404`: No such app, or Storelift has not measured it yet.
- `429`: Too many requests.

---

[API](https://skmtc.dev/storelift/apis/storelift-api.md) · [All operations](https://skmtc.dev/storelift/apis/storelift-api/llms.txt) · [OpenAPI document](https://skmtc.dev/storelift/apis/storelift-api/revisions/4489f2d077a4?raw)