app-store-top-apps
v1.0.609
Published
App Store' Top Apps
Downloads
470
Maintainers
Readme
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 identifiercountryCode
the country code (optional)pricing
can be eitherfree
orpaid
(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 identifiercountryCode
the country code (optional)pricing
can be eitherfree
orpaid
(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.