Skip to main content

Downloads apks from androzoo repository

Project description

Build Status

Downloads specified number of randomly chosen apks satisfying specified criteria from androzoo repository.
Saves specified metadata to metadata.csv. dexdate, apksize and vtdetection require specifying lower and upper bounds in format lower:upper, both inclusive.
One of the bounds can be omitted (i.e. you can write :upper or lower:)
pkgname, markets, metadata, sha256, sha1, md5 can be either single values or comma separated lists. Key and input file can be specified as options or via local or global config file. Allows downloading in the multiple threads.


  • Python 3.6


  1. pip install azoo

  2. create .az file in your home directory (~ on Linux and macOS, C:\Users%USERNAME% on Windows) or in the directory where you want to invoke az from with the following contents:


Alternatively, use cli options -k and -i

Request the api key from androzoo, download and uncompress the input file from here


You can configure api key and input file either using cli options or .az configuration file. The file can be placed locally (in directory where you want to invoke az from) or globally (in your home directory). The precedence for reading config values is as follows: cli -> local-> global.


az -n 10 -d 2015-12-11: -s :3000000 -m,appchina

This means: download 10 apks with the dexdate starting from the 2015-12-11 (inclusive), size up to 3000000 bytes (inclusive) and present on either or appchina

  -n, --number INTEGER     Number of apks to download.
  -d, --dexdate TEXT       The date on a dex file, format %Y-%m-%d, e.g.  2015-10-03.
  -s, --apksize TEXT       Apk size, in bytes.
  -vt, --vtdetection TEXT  Virus total rating, integer.
  -pn, --pkgname TEXT      Package names.
  -m, --markets TEXT       Markets, e.g. Possible values (can differ, since repository is updating): 1mobile,angeeks,anzhi,apk_bang,appchina,fdroid,freewarelovers,genome,hiapk,markets,,,proandroid,slideme,torrents.
  --sha256 TEXT            SHA256 hashes.
  --sha1 TEXT              SHA1 hashes of apks to download.
  --md5 TEXT               MD5 hashes of apks to download.
  -md, --metadata TEXT     Metadata. This is a subset of latest.csv column names to keep in metadata.csv. By default sha256,pkg_name,apk_size,dex_date,markets.  
  -o, --out TEXT           Output folder name. By default current directory.
  -sd, --seed INTEGER      Seed for a random algorithm.
  -k, --key TEXT           Androzoo api key.
  -i, --input-file TEXT    Path to input csv.
  -t, --threads INTEGER    Number of threads for concurrent download. 4 by default.
  --version                Show the version and exit.
  --help                   Show this message and exit.  

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

azoo-1.3.1.tar.gz (9.9 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page