App Store' Top Apps, by countries, pricing and genres. The data auto-updates every day.
const { isAppTop, getAppPositions } = require("app-store-top-apps");
console.log(isAppTop("com.alertus.zenly"));
// true
console.log(getAppPositions("com.alertus.zenly"));
// […, {country_code: 'fr', pricing: 'free', genre: 'social_networking', index: 13, total: 100}, …]The raw sets of top apps, as returned by Apple iTunes API, are made accessible:
// All top apps in France
const { fr } = require("app-store-top-apps");
// All top free apps in France
const { fr_free } = require("app-store-top-apps");
// All top paid entertainment apps in France
const { fr_paid_entertainment } = require("app-store-top-apps");
// OR
const appStore = require("app-store-top-apps");
// All top apps in France
console.log(appStore.data.fr);
// All top free apps in France
console.log(appStore.data.fr_free);
// All top paid entertainment apps in France
console.log(appStore.data.fr_paid_entertainment);isAppTop(bundleId, countryCode, pricing, genre) returns whether an app is top or not:
-
bundleIdthe app's bundle identifier -
countryCodethe country code (optional) -
pricingcan be eitherfreeorpaid(optional) -
genrethe app's genre (optional)
const { isAppTop } = require("app-store-top-apps");
console.log(isAppTop("com.alertus.zenly"));
// true
console.log(isAppTop("com.alertus.zenly"), "fr");
// true
console.log(isAppTop("com.alertus.zenly", "fr", "paid"));
// falsegetAppPositions(bundleId, countryCode, pricing, genre) returns the app top position(s):
-
bundleIdthe app's bundle identifier -
countryCodethe country code (optional) -
pricingcan be eitherfreeorpaid(optional) -
genrethe app's genre (optional)
const { getAppPositions } = require("app-store-top-apps");
console.log(getAppPositions("com.alertus.zenly"));
// […, {country_code: 'fr', pricing: 'free', genre: 'social_networking', index: 13, total: 100}, …]
console.log(getAppPositions("com.alertus.zenly", "fr"));
// [{country_code: 'fr', pricing: 'free', genre: 'social_networking', index: 13, total: 100}]app-store-top-apps is released under the MIT License. See the bundled LICENSE file for details.