### Combined APK Filtering Example Source: https://androzoo.uni.lu/api_doc A comprehensive command to filter APKs by source (Google Play), size, VirusTotal detections, and dex_date, then extracts SHA256 hashes. Excludes the 'snaggamea' APK. ```bash zcat latest.csv.gz | grep -v ',snaggamea' | awk -F, '{if ($11 ~ /play.google.com/) {print} }' | awk -F, '{if ($5 >10000000 ) {print} }' | awk -F, '{if ($8 >=2 ) {print} }' | awk -F, '{if ( $4 >= "2018-12" ) {print} }' | awk -F, '{if ( $4 >= "2019-11-30" ) {print} }' | cut -d',' -f1 > list_of_selected_sha256 ``` -------------------------------- ### Get Metadata for All Versions of an App Source: https://androzoo.uni.lu/gp-metadata Retrieves all available metadata records for a given app across all its versions. You only need to provide the package name. ```APIDOC ## GET /api/get_gp_metadata/PKG_NAME ### Description Retrieves metadata for all versions of a specific app. ### Method GET ### Endpoint /api/get_gp_metadata/PKG_NAME ### Parameters #### Path Parameters - **PKG_NAME** (string) - Required - The package name of the app (e.g., '`com.chrome.canary`'). #### Query Parameters - **apikey** (string) - Required - Your API key. ### Request Example ```bash curl -G -d apikey=${APIKEY} 'https://androzoo.uni.lu/api/get_gp_metadata/occam.hammer.drone' ``` ### Response #### Success Response (200) - Returns a JSON list (NOT JSON Lines) of all metadata records for the specified app across all versions. ``` -------------------------------- ### Get Metadata for a Specific App Version Source: https://androzoo.uni.lu/gp-metadata Retrieves metadata for a particular version of an app. You need to provide the package name and the version code of the app. ```APIDOC ## GET /api/get_gp_metadata/PKG_NAME/VERSIONCODE ### Description Retrieves metadata for a specific version of an app. ### Method GET ### Endpoint /api/get_gp_metadata/PKG_NAME/VERSIONCODE ### Parameters #### Path Parameters - **PKG_NAME** (string) - Required - The package name of the app (e.g., '`com.chrome.canary`'). - **VERSIONCODE** (string) - Required - The version code of the app. #### Query Parameters - **apikey** (string) - Required - Your API key. ### Request Example ```bash curl -G -d apikey=${APIKEY} 'https://androzoo.uni.lu/api/get_gp_metadata/occam.hammer.drone/65' ``` ### Response #### Success Response (200) - Returns a JSON object containing the metadata for the specified app version. ``` -------------------------------- ### Download Metadata for All Versions of an App Source: https://androzoo.uni.lu/gp-metadata Use this command to retrieve a list of all metadata records for a given app package name across all its versions. ```bash curl -G -d apikey=${APIKEY} 'https://androzoo.uni.lu/api/get_gp_metadata/occam.hammer.drone' ``` -------------------------------- ### Download Metadata for a Specific App Version Source: https://androzoo.uni.lu/gp-metadata Use this command to retrieve metadata for a particular version of an app by specifying its package name and version code. ```bash curl -G -d apikey=${APIKEY} 'https://androzoo.uni.lu/api/get_gp_metadata/occam.hammer.drone/65' ``` -------------------------------- ### Download APKs using az Script Source: https://androzoo.uni.lu/api_doc This script, contributed by Artsiom Kushniarou, automates the download of multiple APKs based on specified criteria like count, date, and size. ```bash az -n 10 -d 2015-12-11: -s :3000000 -m play.google.com,appchina ``` -------------------------------- ### Download Full GP Metadata File Source: https://androzoo.uni.lu/gp-metadata Use this curl command to download the complete GP metadata file. Ensure you have your API key set as an environment variable. ```bash curl -O --remote-header-name -G -d apikey=${APIKEY} 'https://androzoo.uni.lu/api/get_gp_metadata_file/full' ``` -------------------------------- ### Download APK from Browser Source: https://androzoo.uni.lu/api_doc This method allows you to download an APK by simply pasting a URL into your browser's address bar. Ensure you replace the placeholders with your API key and the APK's SHA256 hash. ```APIDOC ## Download APK from Browser ### Description This endpoint allows you to download an APK by navigating to a specific URL in your web browser. You need to include your API key and the SHA256 hash as URL parameters. ### Method GET ### Endpoint https://androzoo.uni.lu/api/download ### Parameters #### Query Parameters - **apikey** (string) - Required - Your personal API key for accessing the service. - **sha256** (string) - Required - The SHA256 hash of the APK you want to download. ### Request Example ``` https://androzoo.uni.lu/api/download?apikey=**${APIKEY}**&sha256=**${SHA256}** ``` ### Response #### Success Response (200) - The APK file is downloaded directly. ``` -------------------------------- ### Download APK using Curl Source: https://androzoo.uni.lu/api_doc Use this command-line utility to download a specific APK by providing your API key and the APK's SHA256 hash. ```bash curl -O --remote-header-name -G -d apikey=**${APIKEY}** -d sha256=**${SHA256}** \ https://androzoo.uni.lu/api/download ``` -------------------------------- ### Filter APKs by dex_date (before) Source: https://androzoo.uni.lu/api_doc Finds APKs with a dex_date before November 30, 2019. ```bash zcat latest.csv.gz | awk -F, '{if ( $4 < "2019-11-30" ) {print} }' ``` -------------------------------- ### Download APK using Curl Source: https://androzoo.uni.lu/api_doc This method allows you to download an APK directly from the command line using curl. You need to provide your API key and the SHA256 hash of the desired APK. ```APIDOC ## Download APK using Curl ### Description This endpoint allows you to download an APK using your API key and the SHA256 hash of the APK. It is designed for command-line usage. ### Method GET ### Endpoint https://androzoo.uni.lu/api/download ### Parameters #### Query Parameters - **apikey** (string) - Required - Your personal API key for accessing the service. - **sha256** (string) - Required - The SHA256 hash of the APK you want to download. ### Request Example ```bash curl -O --remote-header-name -G -d apikey=**${APIKEY}** -d sha256=**${SHA256}** https://androzoo.uni.lu/api/download ``` ### Response #### Success Response (200) - The APK file is downloaded directly. ``` -------------------------------- ### Download APK using Browser URL Source: https://androzoo.uni.lu/api_doc Access this URL directly in your browser to download an APK. Replace placeholders with your API key and the APK's SHA256 hash. ```url https://androzoo.uni.lu/api/download?apikey=**${APIKEY}**&sha256=**${SHA256}** ``` -------------------------------- ### Download Aggregate GP Metadata File Source: https://androzoo.uni.lu/gp-metadata Use this curl command to download the aggregate GP metadata file. Ensure you have your API key set as an environment variable. ```bash curl -O --remote-header-name -G -d apikey=${APIKEY} 'https://androzoo.uni.lu/api/get_gp_metadata_file/aggregate' ``` -------------------------------- ### Filter APKs by dex_date (after) Source: https://androzoo.uni.lu/api_doc Finds APKs with a dex_date on or after December 1, 2018. ```bash zcat latest.csv.gz | awk -F, '{if ( $4 >= "2018-12" ) {print} }' ``` -------------------------------- ### Obtain Latest APK List with Added Date CSV Source: https://androzoo.uni.lu/api_doc Download a compressed CSV file of all available APKs, including the date each APK was added to AndroZoo. This file is also updated nightly. ```APIDOC ## Obtain Latest APK List with Added Date CSV ### Description This provides a direct link to download a compressed CSV file containing all available APKs on AndroZoo, along with the date each APK was added to the platform. The file is updated daily. ### Method GET ### Endpoint https://androzoo.uni.lu/latest_with-added-date.csv.gz ### Response #### Success Response (200) - **File**: A compressed CSV file (latest_with-added-date.csv.gz) containing APK information including the 'added' date. ### Response Example ``` [CSV file content] ``` ``` -------------------------------- ### Filter APKs by Size Source: https://androzoo.uni.lu/api_doc Selects APKs that are larger than 10,000,000 bytes from the latest CSV file. ```bash zcat latest.csv.gz | awk -F, '{if ($5 >10000000 ) {print} }' ``` -------------------------------- ### Filter APKs by VirusTotal Detections Source: https://androzoo.uni.lu/api_doc Retrieves APKs that were detected as malware by at least 2 antivirus engines, based on VirusTotal scan data. ```bash zcat latest.csv.gz | awk -F, '{if ($8 >=2 ) {print} }' ``` -------------------------------- ### Obtain Latest APK List CSV Source: https://androzoo.uni.lu/api_doc Download the complete list of available APKs on AndroZoo as a compressed CSV file. This file is updated nightly and contains detailed information about each APK. ```APIDOC ## Obtain Latest APK List CSV ### Description This provides a direct link to download a compressed CSV file containing a comprehensive list of all available APKs on AndroZoo. The file is updated daily. ### Method GET ### Endpoint https://androzoo.uni.lu/latest.csv.gz ### Response #### Success Response (200) - **File**: A compressed CSV file (latest.csv.gz) containing APK information. ### Response Example ``` [CSV file content] ``` ``` -------------------------------- ### Cite AndroZoo Dataset Source: https://androzoo.uni.lu/ Use this BibTeX entry to cite the original AndroZoo dataset paper when referencing the APK collection. ```bibtex @inproceedings{Allix:2016:ACM:2901739.2903508, author = {Allix, Kevin and Bissyand{\'e}, Tegawend{\'e} F. and Klein, Jacques and Le Traon, Yves}, title = {AndroZoo: Collecting Millions of Android Apps for the Research Community}, booktitle = {Proceedings of the 13th International Conference on Mining Software Repositories}, series = {MSR '16}, year = {2016}, isbn = {978-1-4503-4186-8}, location = {Austin, Texas}, pages = {468--471}, numpages = {4}, url = {http://doi.acm.org/10.1145/2901739.2903508}, doi = {10.1145/2901739.2903508}, acmid = {2903508}, publisher = {ACM}, address = {New York, NY, USA}, keywords = {APK, android applications, software repository}, } ``` -------------------------------- ### Cite AndroZoo Metadata Source: https://androzoo.uni.lu/ Use this BibTeX entry to cite the paper that introduced the Google Play Metadata for AndroZoo. ```bibtex @inproceedings{alecci2024androzoo, title={AndroZoo: A Retrospective with a Glimpse into the Future}, author={Alecci, Marco and Jim{\'e}nez, Pedro Jes{\'u}s Ruiz and Allix, Kevin and Bissyand{\'e}, Tegawend{\'e} F and Klein, Jacques}, booktitle={Proceedings of the 21st International Conference on Mining Software Repositories}, pages={389--393}, year={2024} } ``` -------------------------------- ### AndroZoo Access Application Template Source: https://androzoo.uni.lu/access Use this JSON template when sending an email to apply for access to the AndroZoo dataset. Fill in your personal and institutional details. ```json { "name": "Your Full Name", "institution": "Your Research Institution", "email": "Your Institutional Email Address" } ``` -------------------------------- ### Filter APKs from Google Play Store Source: https://androzoo.uni.lu/api_doc Extracts APKs exclusively from the Google Play Store from the latest CSV file. ```bash zcat latest.csv.gz | awk -F, '{if ($11 ~ /play.google.com/) {print} }' ``` -------------------------------- ### Exclude 'snaggamea' APK Source: https://androzoo.uni.lu/api_doc Filters out records containing the 'snaggamea' package name to avoid potential parsing issues caused by malformed data. ```bash grep -v ',snaggamea' ``` -------------------------------- ### Extract SHA256 Hashes Source: https://androzoo.uni.lu/api_doc Extracts only the SHA256 hashes from the latest CSV file and saves them to a list. ```bash zcat latest.csv.gz | cut -d',' -f1 > list_of_selected_sha256 ``` -------------------------------- ### Euphony Citation Source: https://androzoo.uni.lu/other_projects This is a BibTeX entry for the Euphony paper. It should be cited if Euphony or its labels are used in a scientific publication. ```bibtex @inproceedings{hurier2017euphony, title={Euphony: Harmonious Unification of Cacophonous Anti-Virus Vendor Labels for Android Malware}, author={Hurier, Médéric and Suarez-Tangil, Guillermo and Dash, Santanu Kumar and Bissyandé, Tegawendé F and Traon, Yves Le and Klein, Jacques and Cavallaro, Lorenzo}, booktitle={Proceedings of the 14th International Conference on Mining Software Repositories}, pages={425--435}, year={2017}, organization={IEEE Press} } ``` === COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.