Skip to main content
You import the apps you want to follow, AsoBeast collects their data every day, and the API reads that history back. No route looks up apps in a store in bulk. Read this page before you design a client around it.

What the API is for

The API is the same one the dashboard uses, so it reads everything the dashboard shows for a tracked app: All of it is history. A tracked app builds up days of positions, scores and listings, and that history is what the API serves.

What it is not

It is not a bulk store lookup. No route takes a list of store ids and answers with their listings.
  • An app is readable only after you import it. POST /apps takes a store URL, fetches the listing once and starts tracking it. Until then, there is no app id to read. See Import an app.
  • An import takes an app slot and one of the day’s imports. The slot stays taken for as long as the app is tracked. The import allowance resets every day.
  • Tracking means daily collection. AsoBeast reads each tracked app from the store on its own schedule and answers your request from what it stored. A read is not a request to the store, and capturedAt on the listing says when the store was last asked.
  • The routes that do ask a store on the spot are limited separately. Refreshing a listing and searching a store by name each spend a store allowance of their own. They help you find and update what you track, not list a store. See Three request classes.
The numbers for each plan are in What each plan allows and Pricing. A self-hosted instance sets none of these plan limits; see Self-hosted instances are unlimited.

Requests are not apps

Two different things are counted, and neither tells you the other. A daily request allowance is not a number of apps. Reading a stored app again costs a request each time and never a slot. A large request allowance buys many reads of the apps you track, not a longer list of them. To read more apps, you need more app slots.

What an app record holds

GET /apps/{id} answers the app, its latest stored listing and its competitors. It is built from stored rows, so reading it asks no store. A field is null when the store did not say. AsoBeast never fills one with a guess.

The app

The latest listing

latestSnapshot is the newest stored copy of the listing.

Only on the app’s own listing

A competitor’s listing leaves these two out, so a detail with many competitors stays small. Google Play has no subtitle and indexes the short description in its place; see App Store and Google Play.

What lives elsewhere

The record is the listing. Everything AsoBeast collects over time has its own route and its own page.

What AsoBeast does not serve

Some things a store listing carries are not on the record and have no route:
  • Developer contact details, such as an email address, a website or a postal address.
  • Data safety declarations.
  • App permissions.
  • The descriptors behind a content rating. The record carries the rating itself, in contentRating.
  • Similar apps as a field. Competitor suggestions are a route of their own and are not part of the app.
  • Lists of in app purchases.
If you need one of these, AsoBeast is not the source for it.

Importing many apps

Send imports one at a time and wait for each answer before you send the next. Importing an app the workspace already tracks answers with the stored app and spends nothing, so repeating an import after a timeout is safe. See Importing twice costs nothing extra. Every import also queues store work behind it, such as the first rank checks and scores. A server busy with that work can have no store capacity free for a moment, and then answers 503 with a Retry-After header and asks nothing of the store. Wait that many seconds and send the same import again. See Status codes. A 429 is a different answer: an allowance has closed, and the envelope names which. A 403 with a quota object means every app slot is taken. See A rate limit is not a quota.

Rate limits and quotas

What a metered instance allows and what a 429 means.

Import an app

What an import does and what it costs.
Last modified on November 20, 2026