# Endpoints de Hive

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

Cualquier app o mercado que mida la red de Storelift, la siga usted o no. Forma parte de Hive Explorer. URL base `https://storelift.net/v1` · autenticación, créditos y parámetros comunes: https://storelift.net/es/docs/api/

## GET /rank-check

The live rank of one of your apps for any search term in one storefront, as the store shows it right now — the term does not need to be tracked. The state keeps the cases apart: `ranked` with the rank and the apps just above, `absent` with the top results (the app is sold there and sits outside those results), `not_in_store` (the app is not sold in that storefront).

Scope: `apps:read` · Créditos: 10 · Plan: Free

- `app` (query, string, obligatorio) — App Store link or id, or Google Play link or package name
- `term` (query, string, obligatorio) — search term, e.g. habit tracker
- `cc` (query, string) — storefront code, e.g. us
- `platform` (query, ios | android) — optional; read from the app link

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

## GET /keyword-difficulty

Demand and difficulty inputs for one App Store search term in one storefront: its demand (`demand`) and the related searches, the top results with their rating counts and whether the term is in their title, the strongest and median rating count among them, and how deep the results go. `thin` marks a term with fewer than ten results; `zayifEslesme` marks a term the store matches loosely. Free reads the terms the account tracks in that storefront; Pro and above read any term.

Scope: `apps:read` · Créditos: 10 · Plan: Free

- `term` (query, string, obligatorio) — search term, e.g. habit tracker
- `cc` (query, string) — storefront code, e.g. us

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

## GET /hive/find

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.

Scope: `hive:read` · Créditos: 20 · Plan: Hive Explorer

- `genre` (query, string) — up to 3 Apple genre ids, comma separated, e.g. 6007,6012
- `country` (query, string) — up to 5 storefront codes, comma separated, e.g. us,gb
- `kind` (query, string) — grossing, free, paid or ipad (which chart the app is on)
- `released` (query, number) — first seen within the last N months
- `rankMin` (query, number) — best chart rank at least this
- `rankMax` (query, number) — best chart rank at most this
- `revenueMin` (query, number) — monthly gross revenue at least this (USD)
- `revenueMax` (query, number) — monthly gross revenue at most this (USD)
- `downloadsMin` (query, number) — monthly downloads at least this
- `downloadsMax` (query, number) — monthly downloads at most this
- `growthMin` (query, number) — 30-day change at least this, in percent (e.g. 20)
- `growthMax` (query, number) — 30-day change at most this, in percent
- `text` (query, string) — match on app name or publisher name
- `publisher` (query, string) — publisher id from market_publisher
- `estimates` (query, boolean) — true adds monthly revenue and downloads to every row (50 credits per row)
- `limit` (query, number) — rows per page, 50 by default, up to 200
- `page` (query, number) — result page, 1 by default

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

## GET /hive/charts

One top chart as we last measured it: the ranked app ids for a storefront, list kind and optional category, with the day it was read. Pass `estimates: true` for each rank's monthly value (revenue on Top Grossing, downloads on Top Free) and what it takes to enter at #10, #50 and #100. 10 credits for the list; with estimates, 50 more per row returned. App Store only — Google Play has no public top chart, and a number there would be invented.

Scope: `hive:read` · Créditos: 10 · Plan: Hive Explorer

- `country` (query, string) — storefront code, e.g. us (defaults to us)
- `kind` (query, string) — free, paid or grossing
- `genre` (query, string) — Apple genre id, e.g. 6007; omit for the overall chart
- `limit` (query, number) — how many rows, up to 100

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

## GET /hive/movers

Who climbed, who fell, who entered and who left one top chart, against the same chart N days ago. `measured` tells you the comparison day is in hand, so every delta you read sits between two measured days; apps that left carry their last rank rather than a delta, since today they sit off the chart.

Scope: `hive:read` · Créditos: 10 · Plan: Hive Explorer

- `country` (query, string) — storefront code, e.g. us (defaults to us)
- `kind` (query, string) — free, paid or grossing
- `genre` (query, string) — Apple genre id; omit for the overall chart
- `days` (query, number) — compare against N days ago, up to 90
- `limit` (query, number) — rows per direction, up to 100

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

## GET /hive/new

Apps seen on a top chart for the first time, newest first, with the publisher behind each one. `daysCovered` says how many of the requested days the index holds, so every first-seen date you read is a day we indexed.

Scope: `hive:read` · Créditos: 10 · Plan: Hive Explorer

- `days` (query, number) — look back N days, up to 30
- `country` (query, string) — storefront code; omit for every storefront
- `limit` (query, number) — rows, up to 200

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

## GET /hive/publisher/{publisherId}

Every app of one publisher that we have seen on a chart, with the day each was first seen. Apps the publisher never charted are not here — we list what we measured, not what exists.

Scope: `hive:read` · Créditos: 10 · Plan: Hive Explorer

- `publisherId` (path, string, obligatorio) — publisher id, e.g. from market_new_apps

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

## GET /hive/resolve

Find any app's id: by name or developer (the top matches in that storefront, with publisher, category, rating and rating count), or from an App Store / Google Play link, a bare App Store id or a package name. Use it before hive_app_details, hive_similar_apps or hive_app_reviews when you only have a name.

Scope: `hive:read` · Créditos: 10 · Plan: Hive Explorer

- `q` (query, string, obligatorio) — app name, developer name, store link, App Store id or package name
- `country` (query, string) — storefront code, e.g. us (defaults to us)
- `limit` (query, number) — results, up to 25 (default 10)

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

## GET /hive/similar/{appId}

The store's own similar-apps shelf for any app (Apple's You Might Also Like, Google's Similar apps), in shelf order, with each app's category, name and publisher and the day the shelf was read. The categories on the shelf show which crowd the store places the app in.

Scope: `hive:read` · Créditos: 10 · Plan: Hive Explorer

- `appId` (path, string, obligatorio) — App Store id (e.g. 570060128) or Google Play package name
- `country` (query, string) — storefront code, e.g. us (empty = the newest shelf read in any storefront)

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

## GET /hive/reviews/{appId}

Any app's recent reviews in one storefront, newest first: stars, title, text, version and date, plus the star distribution of the rows returned. Reviewer names are left out. An app Hive does not hold yet is added on the first call.

Scope: `hive:read` · Créditos: 10 · Plan: Hive Explorer

- `appId` (path, string, obligatorio) — App Store id (e.g. 570060128) or Google Play package name
- `country` (query, string) — storefront code, e.g. us (defaults to us)
- `limit` (query, number) — reviews, up to 200 (default 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

Start a measurement of one keyword's popularity and/or difficulty in one storefront when the stored value is missing or stale. A fresh value or verified absence is returned without new work; a request that joins a job already running uses no daily measurement unit; the request that starts new work uses one from the workspace's daily Hive measurement allowance. The two metrics are independent: a failed source leaves the other valid metric in the answer. `wait` (0–20 seconds) keeps the call open until the result is stored; 202 means it is still running — read it later with hive_keyword_metrics. Needs the opt-in hive:measure scope: chosen on the API key, or approved separately when connecting over OAuth. iOS only.

Scope: `hive:measure` · Créditos: 50 · Plan: Hive Explorer

- `term` (path, string, obligatorio) — exact keyword, e.g. habit tracker
- `country` (body, string) — storefront code, e.g. us (defaults to us)
- `platform` (body, string)
- `metrics` (body, array) — which metrics to measure (default both)
- `wait` (body, number) — seconds to wait for the stored result, 0–20 (this tool sends 15 when left out; the HTTP API default is 0)

Iniciar un trabajo nuevo consume una medición de la cuota diaria de mediciones de Hive del espacio de trabajo, así que aquí no hay ningún comando para copiar.

Cuerpo de la petición:

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

## GET /hive/apps/{id}

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.

Scope: `hive:read` · Créditos: 10 · Plan: Hive Explorer

- `id` (path, string, obligatorio) — App Store id (5–12 digits) or a Google Play package name.
- `country` (query, string) — storefront code, e.g. us (defaults to us)

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

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

The top results for any keyword the network measures, per day. `days` shrinks when `top` is large so one call stays under 1,000 rows. 10 credits for up to 7 days, 20 for up to 30, 40 for up to 90.

Scope: `hive:read` · Créditos: 10 · Plan: Hive Explorer

- `term` (path, string, obligatorio)
- `country` (query, string) — storefront code, e.g. us (defaults to us)
- `platform` (query, ios | android) — defaults to 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

Read existing Hive observations for one exact keyword and storefront. Popularity is an integer from 1 to 100; difficulty is a score from 0 to 100. Missing data stays null. Each metric carries its own evidence, source time, freshness and last-attempt status. This GET never starts a source request or measurement job. Requires the full Hive Explorer product; Android is explicitly unsupported.

Scope: `hive:read` · Créditos: 10 · Plan: Hive Explorer

- `term` (path, string, obligatorio) — NFC-normalized, trimmed and lowercased. Internal whitespace remains significant.
- `country` (query, string) — storefront code, e.g. us (defaults to us)
- `platform` (query, ios) — defaults to 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

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.

Scope: `hive:read` · Créditos: 20 · Plan: Hive Explorer

- `term` (path, string, obligatorio) — NFC-normalized, trimmed and lowercased. Internal whitespace remains significant.
- `country` (query, string) — storefront code, e.g. us (defaults to us)
- `platform` (query, ios) — defaults to ios
- `days` (query, integer) — UTC calendar days including today. Popularity revisions are selected by their source week start within this range.
- `cursor` (query, string) — Opaque continuation from this exact query's pagination.nextCursor.

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

## GET /hive/spy/{id}

Every keyword the network measured an app on, with its rank. Every call is paid in credits; an app with no keywords to show costs 1.

Scope: `hive:spy` · Créditos: 200 · Plan: Hive Explorer

- `id` (path, string, obligatorio) — App Store id (5–12 digits) or a Google Play package name.
- `country` (query, string) — storefront code, e.g. us (defaults to us)
- `platform` (query, ios | android) — defaults to ios

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

## GET /hive/estimate/{id}

Monthly revenue and downloads for any App Store app, worldwide: one figure each (`value`, or `under` when the app is below that amount) and how many markets it covers. Every app gets an answer. Hive already knows them. The first request for an app starts the read and answers 202 with `eta` seconds. 500 credits for the figures; a pending answer is 1.

Scope: `hive:estimate` · Créditos: 500 · Plan: Hive Explorer

- `id` (path, string, obligatorio) — App Store id.
- `country` (query, string) — storefront code, e.g. us (defaults to us)

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

## GET /hive/gap

Up to 5 apps' keyword lists side by side, one row per keyword: each app's rank, how many hold it and which are missing. 200 credits per app compared; an app outside the index is not charged. Part of Explorer.

Scope: `hive:spy` · Créditos: 400 · Plan: Hive Explorer

- `ids` (query, string, obligatorio) — Comma-separated app ids, at least 2.
- `country` (query, string) — storefront code, e.g. us (defaults to us)
- `platform` (query, ios | android) — defaults to ios

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

## GET /hive/research

Type a seed keyword and get related App Store search terms, each with Apple popularity (1–100 when observed; missing values stay null), difficulty (0–100), how many apps rank for it and the top 10 apps. Metric evidence distinguishes a measured value, verified absence, pending work and source errors. Active measurement rows carry `state: "pending"`; repeat the request to read the result. When the App Store corrects the spelling of a term, its row carries `spell` with the corrected search. No app needed. Part of Explorer.

Scope: `hive:read` · Créditos: 50 · Plan: Hive Explorer

- `seed` (query, string, obligatorio) — Seed keyword.
- `country` (query, string) — storefront code, e.g. us (defaults to us)
- `compare` (query, string) — Up to 5 more storefronts, comma-separated (e.g. de,fr): popularity, difficulty and app count of the same terms in each.

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

## GET /hive/landscape

A storefront's category landscape from its top free list: the ratings wall of the top 10, median rating, name length, release and update freshness, languages, size and publishers with several apps. Each category carries its own measurement day.

Scope: `hive:read` · Créditos: 10 · Plan: Hive Explorer

- `country` (query, string) — storefront code, e.g. us (defaults to us)
- `genre` (query, string) — App Store genre id (e.g. 6014) or a category key (all, games, entertainment, photo-video, productivity, health-fitness, education, lifestyle, finance, social-networking). Leave out for every measured category.

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