A store's top chart (free, paid, grossing or new) overall or in one category, in chart order.
Use when: "top free business apps", "what is grossing in the App Store's finance chart", spotting rising apps in a category.
Not for: apps matching a word, use apps_search_apps. One app's details, use apps_get_app.
Returns: List. rows[]: rank, app_id, title, url, developer (Google Play only), rating, ratings_count (App Store only), is_free, price, currency.
Params: store (required; google_play | app_store), chart ("top_free" | "top_paid" | "top_grossing" | "new_free" | "new_paid", default top_free), category (optional; the store's id in lower case with underscores, and a name such as "Health & Fitness" is turned into one; a wrong id is refused free. App Store: books, business, education, entertainment, finance, food_and_drink, games, health_and_fitness, lifestyle, magazines_and_newspapers, medical, music, navigation, news, photo_and_video, productivity, reference, shopping, social_networking, sports, travel, utilities, weather, and games_puzzle and other games_ genres. Google Play: art_and_design, auto_and_vehicles, beauty, books_and_reference, business, comics, communication, dating, education, entertainment, events, family, finance, food_and_drink, health_and_fitness, house_and_home, libraries_and_demo, lifestyle, maps_and_navigation, medical, music_and_audio, news_and_magazines, parenting, personalization, photography, productivity, shopping, social, sports, tools, travel_and_local, video_players, weather, game, and game_puzzle and other game_ genres), limit (100; max 200 on Google Play, 100 on the App Store), location ("United States"), language ("en"), max_credits, dry_run.
Cost: 1 credit per 100 rows. Default 100 rows = 1 credit. Cached 1 day. Can take up to a minute.
Example: {"store": "app_store", "chart": "top_free", "category": "health_and_fitness"}