App Store Top Apps

App Store' Top Apps, by countries, pricing and genres. The data auto-updates every day.

Usage

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}, …]

API

Access to data

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);

Check if an app is top

isAppTop(bundleId, countryCode, pricing, genre) returns whether an app is top or not:

• bundleId the app's bundle identifier
• countryCode the country code (optional)
• pricing can be either free or paid (optional)
• genre the 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"));
// false

Get app top position(s)

getAppPositions(bundleId, countryCode, pricing, genre) returns the app top position(s):

• bundleId the app's bundle identifier
• countryCode the country code (optional)
• pricing can be either free or paid (optional)
• genre the 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}]

License

app-store-top-apps is released under the MIT License. See the bundled LICENSE file for details.