App Store Top Charts & App Search API
Pricing
from $0.18 / 1,000 app returneds
App Store top charts by category and country — free, paid, grossing, new — as ranked rows. Plus Google Play category listings, and app search across both stores: title, developer, price, rating, installs, icon, store link. No API key, no login. Google Play top charts are not available.
One entry per chart, written as country/chart or country/chart/genreId. Charts: top-free, top-paid, top-grossing, new, new-free, new-paid. The country is a two-letter storefront code (us, gb, de, jp) — every storefront has its own chart. The optional third part is Apple's numeric genre ID: 6014 Games, 6013 Health & Fitness, 6016 Entertainment, 6007 Productivity, 6015 Finance, 7012 Games — Puzzle, 7017 Games — Strategy. Genre names are not accepted and an unknown genre ID is refused with a free diagnostic row: Apple answers an unknown genre with the overall chart and HTTP 200, so a typo would otherwise return the wrong chart and look right. Duplicates are read, and billed, once.
[ "us/top-free", "gb/top-paid", "us/top-grossing/6014", "de/new-free/7012"]How deep each App Store chart goes, 10 to 100. Apple's chart feeds stop at 100 ranks — both the modern feed (published at exactly 10, 25, 50 and 100; any other number is served from the next size up and trimmed) and the older feed used for grossing, new and per-genre charts, which ignores anything above 100. There is no top 200 any more (checked 2026-09-11).
One entry per Google Play category page, written as country/CATEGORY — for example us/HEALTH_AND_FITNESS, de/GAME_PUZZLE, gb/FINANCE. You get the apps Play shows on that category's page: its carousels, deduplicated, ranked by where each app first appears. Categories are ART_AND_DESIGN, BOOKS_AND_REFERENCE, BUSINESS, COMMUNICATION, DATING, EDUCATION, ENTERTAINMENT, FINANCE, FOOD_AND_DRINK, HEALTH_AND_FITNESS, LIFESTYLE, MAPS_AND_NAVIGATION, MEDICAL, MUSIC_AND_AUDIO, NEWS_AND_MAGAZINES, PERSONALIZATION, PHOTOGRAPHY, PRODUCTIVITY, SHOPPING, SOCIAL, SPORTS, TOOLS, TRAVEL_AND_LOCAL, VIDEO_PLAYERS, WEATHER and the GAME_* family. This is not a Google Play top-sellers chart — Play no longer serves one publicly, and this Actor does not pretend otherwise.
[ "us/HEALTH_AND_FITNESS", "us/GAME_PUZZLE", "de/FINANCE"]Keywords to search the app stores for. Each query returns up to maxResultsPerQuery app rows per store in the store's own ranking order — which is the ranking an app store optimisation report is about. This is the input for "every meditation app on both stores", or for tracking where your app sits for a keyword week to week.
[ "meditation", "habit tracker", "budget planner"]Which stores the search queries go to. It has no effect on appleCharts (App Store only) or googleCategories (Google Play only). Leave both selected to get one row per app per store, which is how you compare a keyword's results side by side.
[ "apple", "google"]How many apps each search query returns per store. The App Store's own ceiling is 200 and asking for more does not get more. Google Play serves one page of results — around 20 to 30 apps, 22 on the capture this was built against — and there is no "next page" to ask for, so a larger number has no effect on the Play side.
Fill in the columns a chart or a listing does not carry: description, screenshots, version, sizeBytes, minimumOs, contentRating, and — on App Store charts — the star rating, rating count and price. The two stores charge very different amounts of work for this. Apple looks up 100 apps in one request, so an enriched Top 200 is two extra requests. Google Play has no such endpoint: every app is its own 1.2 MB page, so an enriched 50-app category listing is fifty extra requests and takes a few minutes. Off by default. It adds nothing to App Store search rows, which already carry every field Apple has.
Two-letter ISO country code, lower case. It is the default for any appleCharts or googleCategories entry that does not name its own country, and it is the storefront every search query runs in. Both stores are per-country: catalogues, rankings, prices and currencies all differ, and an app published only in Germany is not in the us store at all.
Two-letter language code for Google Play's hl parameter — it decides the language of the titles, descriptions and category names Play returns. It does not change which apps come back; country does that. Apple's endpoints are keyed on the storefront rather than on a language, so this has little effect on App Store rows.
How many charts, category pages or searches are read at once. Each parallel worker keeps its own proxy session, so one blocked page burns only its own exit IP. Google Play category pages are around 2 MB each, so raising this raises memory as well as speed.
Wall-clock budget for the whole run. When it is reached the Actor stops fetching, keeps and bills for every row it already wrote, and files a free diagnostic row for each entry it never reached. A chart stopped part-way keeps its ranks. Nothing is charged for work that did not happen. Raise it when you turn on includeAppDetails for Google Play.
Apple's chart, search and lookup endpoints and Google Play's store pages all answered Apify's datacenter proxy in every capture this Actor was built against, so the default is datacenter — much cheaper than residential, and the proxy cost is already inside the per-row price. Switch to residential if you are reading many Play pages in one run and start seeing blocked rows. Sessions rotate automatically when an exit IP is refused.
{ "useApifyProxy": true}