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:- Keyword rankings and keyword metrics, in Read rankings and SERPs and Track keywords.
- Listings and the changes between them, in Watch listing changes.
- Reviews and ratings, in Sync reviews, reply to them and mine keyword ideas.
- Category ranks and top charts, in Follow category ranks and Read top charts.
- Competitors and the actions AsoBeast recommends, in Track competitors and Work the Action Center.
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 /appstakes 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
capturedAton 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.
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.
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 answers503 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.
Related
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.