Appfigures
App Store and Google Play downloads, revenue, ratings, reviews and chart positions, ready for Hawkings and your coding agents to read.
Dashboard → Tools → Appfigures → Connect.
Appfigures already collects what the stores report about your app. Connect it and Fictura keeps a copy, so Hawkings and your coding agents can answer store questions. There is no dashboard page for these numbers yet, so connecting adds nothing to your sidebar.
Create an API client in Appfigures.
Sign in to Appfigures and open Account, then API (appfigures.com/developers/keys). Create an API client with the private:read, public:read and products:read scopes. Scopes cannot be changed later, so pick them now.
Make a personal access token.
Open the client and create a personal access token. It starts with pat_.
Connect it in Fictura.
Paste the token and click Connect. Fictura only ever reads with it. If the account has more than one app, pick yours, or All apps on this account.
Two boxes are optional. Rank countries says where to track chart positions, such as US, GB, CA; blank means US. Reporting currency is the currency set in your Appfigures account; blank means USD.
Get your numbers.
Click Sync now. The first sync pulls three years of history.
If it says there are no apps
The token works, but Appfigures has no apps on that account. Connect your App Store or Google Play account inside Appfigures first, then try again.
What you get
- Downloads — new downloads, re-downloads, updates and uninstalls, plus the top countries.
- Store revenue — after the store's cut, split into subscriptions, in-app purchases and ads.
- Ratings — the average, the total, the star breakdown and the new ratings in the window.
- Reviews — recent ones, with their text.
- Chart positions — where the app sits in its categories on the newest synced day.
Ask Hawkings, or have a coding agent call get_store_analytics over the MCP server. Both read Fictura's copy, so they cost no Appfigures requests.
Do not add this to your RevenueCat revenue
Store revenue here is what Apple and Google report through Appfigures. Fictura keeps it as a separate figure and never adds it to the revenue from RevenueCat, so the same sale is not counted twice.
Three things worth knowing
Ratings and chart positions need public:read. On a free Appfigures plan they also need the Public Data API add-on. A token without it still syncs downloads, revenue and reviews.
Fictura syncs every six hours and re-reads the last two weeks each time, because the stores keep changing recent days.
Appfigures allows 1,000 requests per account each UTC day. A first sync is about 150. If the account runs out, the sync tries again after the quota resets at midnight UTC.