app.appfigures.com APIapp.appfigures.com ↗
Access top-ranked iOS App Store apps by category, including rankings, ratings, revenue estimates, demographics, and app metadata via 3 endpoints.
curl -X GET 'https://api.parse.bot/scraper/c27a2990-1e5e-405c-938e-8e06c46d27ff/get_top_apps?limit=5&category=education&list_type=free' \ -H 'X-API-Key: $PARSE_API_KEY'
Get the top-ranked apps list for a given iOS App Store category. Returns up to 200 apps for grossing lists and up to 500 for free/paid lists. Supports filtering by list type, category, country, and device.
| Param | Type | Description |
|---|---|---|
| limit | integer | Maximum number of apps to return (up to 200 for grossing, 500 for free/paid). |
| store | string | App store identifier. |
| device | string | Device type: 'iphone' or 'ipad'. |
| country | string | Country slug (e.g. 'united-states', 'united-kingdom', 'japan', 'germany'). |
| category | string | Category slug. Accepted values: 'books', 'business', 'developer-tools', 'education', 'entertainment', 'finance', 'food-drink', 'games', 'graphics-design', 'health-fitness', 'kids', 'lifestyle', 'magazines-newspapers', 'medical', 'music', 'navigation', 'news', 'photo-video', 'productivity', 'reference', 'shopping', 'social-networking', 'sports', 'stickers', 'top-overall', 'travel', 'utilities', 'weather'. Use get_categories to confirm all options. |
| list_type | string | Type of ranking list: 'topgrossing', 'free', or 'paid'. |
{
"type": "object",
"fields": {
"apps": "array of ranked app objects with rank, id, name, developer, developer_id, storefront, vendor_identifier, price, currency",
"category": "string - Category name",
"list_type": "string - List type (free/paid/topgrossing)",
"timestamp": "string - When the ranking was last updated (ISO 8601)",
"category_id": "integer - Internal category ID",
"total_count": "integer - Total apps available in this list",
"apps_returned": "integer - Number of apps in response"
},
"sample": {
"data": {
"apps": [
{
"id": 214139329,
"name": "Duolingo: Language Lessons",
"rank": 1,
"price": "0.00",
"currency": "USD",
"developer": "Duolingo",
"storefront": "apple:ios",
"developer_id": 160476,
"vendor_identifier": "570060128"
}
],
"category": "Education",
"list_type": "free",
"timestamp": "2026-05-14T11:00:00Z",
"category_id": 6017,
"total_count": 500,
"apps_returned": 5
},
"status": "success"
}
}About the app.appfigures.com API
The Appfigures API exposes iOS App Store ranking data across 3 endpoints, letting you pull top-ranked apps by category with get_top_apps, retrieve full app metadata and revenue estimates with get_app_details, and enumerate all valid category slugs with get_categories. A single call to get_top_apps returns up to 500 ranked apps with fields covering developer identity, price, currency, and list type for free, paid, or top-grossing charts.
Ranking Data from get_top_apps
The get_top_apps endpoint returns ranked app lists for a given iOS App Store category. You can filter by list_type (free, paid, or topgrossing), country (e.g. united-states, japan, germany), device (iphone or ipad), and category slug. The response includes each app's rank, id, name, developer, developer_id, vendor_identifier, price, and currency, along with metadata like timestamp, total_count, and apps_returned. Grossing lists support up to 200 results; free and paid lists go up to 500.
App Details from get_app_details
Once you have a product id from get_top_apps, pass it to get_app_details to retrieve full app metadata. The response covers icon URL, price object with currency and amount, rating with star score and review count, devices, version, countries (available storefronts), active status, and more. This endpoint also surfaces monetization info, download and revenue estimates, and demographic breakdowns that are not present in the ranking list response.
Category Discovery with get_categories
The get_categories endpoint returns all available iOS App Store categories as an array of objects, each containing a slug and a category_id. The slug values map directly to the category parameter in get_top_apps. This avoids hardcoding category slugs and ensures your code handles any future category additions without changes. The response also includes the store identifier (ios-app-store) and a total count of available categories.
Coverage Notes
All endpoints target the iOS App Store specifically. The country parameter accepts slugs rather than ISO codes (e.g. united-states not us). Rankings reflect the Appfigures-tracked snapshot timestamp returned in the timestamp field, not necessarily a real-time chart position.
- Monitor daily chart movement for apps in a specific iOS category using
rankfromget_top_appsacross multiplecountryvalues. - Identify top-grossing apps in a category to benchmark competitor monetization strategies using the
topgrossinglist type. - Collect developer IDs and
vendor_identifierfields from ranking lists to build a database of active iOS app publishers. - Retrieve
ratingstar scores and review counts fromget_app_detailsto track user sentiment for apps that appear in top charts. - Pull
devicesandcountriesarrays fromget_app_detailsto analyze which apps prioritize iPad or specific regional storefronts. - Use
get_categoriesto enumerate all category slugs and automate cross-category ranking sweeps without hardcoded values. - Compare free vs. paid chart compositions in the same category by calling
get_top_appstwice with differentlist_typevalues.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Appfigures have an official developer API?+
What does `get_app_details` return beyond what the ranking list provides?+
get_top_apps returns rank-focused fields like rank, developer_id, and vendor_identifier. get_app_details adds icon URL, detailed price object, rating with star score and count, devices array, version, countries, active status, and revenue and download estimates. You need the id field from a get_top_apps result to call get_app_details.Does the API cover Android (Google Play) rankings?+
store field returning apple or ios-app-store. You can fork this API on Parse and revise it to add a Google Play ranking endpoint.Is historical ranking data available — for example, chart positions from prior weeks?+
get_top_apps endpoint returns the most recent snapshot, identified by the timestamp field in the response. Historical time-series ranking data is not exposed by the current endpoints. You can fork this API on Parse and revise it to add a historical rankings endpoint if that data is available on the source.How specific can category filtering get — are subcategories supported?+
category parameter in get_top_apps accepts the slugs returned by get_categories. The available slugs map to the top-level and subcategory structure that Appfigures tracks for the iOS App Store. Use get_categories to see the full list of supported values, including their category_id integers, rather than assuming which subcategories exist.