https://github.com/fitomad/app-store-ranking
Obtain your app ranking inside App Store and Mac App Store in every country
https://github.com/fitomad/app-store-ranking
app-store aso mac-app-store mac-appstore python ranking
Last synced: 6 months ago
JSON representation
Obtain your app ranking inside App Store and Mac App Store in every country
- Host: GitHub
- URL: https://github.com/fitomad/app-store-ranking
- Owner: fitomad
- License: mit
- Created: 2018-02-09T21:27:09.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2023-02-08T17:11:22.000Z (over 2 years ago)
- Last Synced: 2025-04-11T19:23:15.110Z (6 months ago)
- Topics: app-store, aso, mac-app-store, mac-appstore, python, ranking
- Language: Python
- Size: 130 KB
- Stars: 30
- Watchers: 3
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# App-Store-Ranking
Obtain your app ranking in realtime inside App Store and Mac App Store for every country
    
## Usage
This repository contains two scripts, one for App Store (iosr.py) and the other one for Mac App Store (macr.py)
You can obtain command information by typing command listed below in your Terminal or Command Prompt:
```bash
python iosr.py --help
# or
python macr.py --help
```
To obtain a list with all possible values for all script parameters run this command in Terminal or Command Prompt:
```bash
python iosr.py
#or
python macr.py
```
## Packages
If you have an error related to enums maybe you have to install **enum34** module to obtain compatibility. Type this on your Terminal or Command Prompt
```bash
pip instal enum34
```
Mac and Linux user maybe have to prefix command with `sudo`
### App Store Ranking. Parameters
To obtain an application ranking inside the App Store you have to type this command in Terminal or Command Prompt
```bash
python iosr.py -appid 361309726 -stores top -category 6007 -platform iphone
```
This returns the ranking for **Pages** app `(-appid 361309726)` in the **Top 10 countries by revenue** `(-stores top)` inside the **Productivity category** `(-category 6007)` for **iPhone** devices `(-platform iphone)`
Available stores sets are `world` for all countries where Apple has an App Store available and `top` for the ten countries with more revenues.
Platforms availables are `iphone` for iPhone only devices, `ipad` for iPad only devices and `appleTV` for Apple TV only devices.
To figure out the code related to yout app category type `python iosr.py` in your command line to get a list with all possible values.
### Mac App Store Ranking. Parameters
Request Mac App Store rankings is similar to App Store Ranking procedure. Type this command in Terminal or Command Prompt
```bash
python macr.py -appid 424389933 -category 12020 -stores world
```
This returns the **Final Cut Pro** application `(-appid 424389933)` ranking inside the **Video category** `(-category 12020)` in **all Mac App Store countries** `(-stores world)`
Available stores sets are `world` for all countries where Apple has a Mac App Store available and `top` for the ten countries with more revenues.
To figure out the code related to yout app category type `python macr.py` in your command line to get a list with all possible values.
## Contact
Comments and suggestions are welcome. Find me on twitter at [@fitomad](https://twitter.com/fitomad)