{"id":21626069,"url":"https://github.com/animeshshaw/python-malshare","last_synced_at":"2025-04-11T12:45:04.150Z","repository":{"id":73610976,"uuid":"129841564","full_name":"AnimeshShaw/python-malshare","owner":"AnimeshShaw","description":"Complete implementation of the Malshare API and a toolkit to interact with it","archived":false,"fork":false,"pushed_at":"2018-08-09T07:27:09.000Z","size":9,"stargazers_count":7,"open_issues_count":0,"forks_count":4,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-03-25T09:03:08.062Z","etag":null,"topics":["malshare","malshare-api","malware","malware-research","malware-samples","malwareanalysis","virustotal"],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/AnimeshShaw.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-04-17T03:37:54.000Z","updated_at":"2023-12-21T05:21:24.000Z","dependencies_parsed_at":null,"dependency_job_id":"e578e499-0a1d-4d2d-8adb-e7cd0a498870","html_url":"https://github.com/AnimeshShaw/python-malshare","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AnimeshShaw%2Fpython-malshare","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AnimeshShaw%2Fpython-malshare/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AnimeshShaw%2Fpython-malshare/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AnimeshShaw%2Fpython-malshare/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/AnimeshShaw","download_url":"https://codeload.github.com/AnimeshShaw/python-malshare/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248402541,"owners_count":21097331,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["malshare","malshare-api","malware","malware-research","malware-samples","malwareanalysis","virustotal"],"created_at":"2024-11-25T01:12:01.186Z","updated_at":"2025-04-11T12:45:04.128Z","avatar_url":"https://github.com/AnimeshShaw.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# python-malshare\nComplete implementation of the [Malshare API](https://malshare.com/doc.php) and a toolkit to interact with it.\n\n## Malshare Kit - Help Options\n```text\n\nC:\\Users\\Psycho_Coder\\Documents\\GitHub\\python-malshare\u003epython malsharekit.py --help\n\n              _     _                            _ _\n  /\\/\\   __ _| |___| |__   __ _ _ __ ___    /\\ /(_) |_\n /    \\ / _` | / __| '_ \\ / _` | '__/ _ \\  / //_/ | __|\n/ /\\/\\ \\ (_| | \\__ \\ | | | (_| | | |  __/ / __ \\| | |_\n\\/    \\/\\__,_|_|___/_| |_|\\__,_|_|  \\___| \\/  \\/|_|\\__|\n\n            CLI interface to interact with Malshare API\n            Developed By: Animesh Shaw \u003cPsycho_Coder\u003e\n            Email: coder@animeshshaw.com\n            Twitter: @Psycho__Coder\n\nusage: main.py [-h] -k APIKEY [-l DIR] [--save] [-gl] [-gtl TYPELIST] [-gtl24]\n               [-gs] [-d DOWNLOAD] [-i DETAILS] [-u UPLOAD] [-s SEARCH] [-al]\n\nComplete implementation of the Malshare API and a toolkit to interact with it\n\noptional arguments:\n  -h, --help            show this help message and exit\n  -k APIKEY, --apikey APIKEY\n                        Malshare API Key.\n  -l DIR, --dir DIR     Directory location to save the samples data as json.\n                        By default, stored in the current directory.\n  --save, --save        Save the results in a file in the current directory.\n  -gl, --latest         List hashes from the past 24 hours\n  -gtl TYPELIST, --typelist TYPELIST\n                        List MD5/SHA1/SHA256 hashes of a specific type from\n                        the past 24 hours. Sample File Types: C, XML, PHP,\n                        HTML, ASCII, PE-32, PE32, ISO-8859, UTF-8, MSVC,\n                        Composite, data, 80386, current, BSD, Zip, 7-zip\n  -gtl24, --typelist24  Get list of file types \u0026 count from the past 24 hours\n  -gs, --sources        List of sample sources from the past 24 hours\n  -d DOWNLOAD, --download DOWNLOAD\n                        Provide the malware hash to download the sample.\n  -i DETAILS, --details DETAILS\n                        Provide the malware hash to get the stored file\n                        details.\n  -u UPLOAD, --upload UPLOAD\n                        Upload a Malware Sample to Malshare. Provide the file\n                        location.\n  -s SEARCH, --search SEARCH\n                        Search Malshare for different Malware\n                        Samples/Signatures.\n  -al, --apilimit       GET allocated number of API key requests per day and\n                        remaining\n```\n\n## Sample Usage\n\n__1. Get List hashes from the past 24 hours__\n\n```text\npython malsharekit.py --apikey \u003cYour-Key-Here\u003e -gl\n```\n\nThe Above will print the data to the console. Use `--save` to store them in the current directory or `--dir` to \nsave the data in a custom location (must be directory).\n\n```text\npython malsharekit.py --apikey \u003cYour-Key-Here\u003e --save -gl\n```\n\nor \n\n```text\npython malsharekit.py --apikey \u003cYour-Key-Here\u003e --dir /home/myuser/data -gl\n```\n\n__2. Downloading a Sample from Malshare__\n\n```text\npython malsharekit.py --apikey \u003cYour-Key-Here\u003e --save -d d25ca94d2e43d0b8addca830297e169f\n```\n\n## Contact\n\n_Email:_ coder[at]animeshshaw[dot]com\n\n_Twitter:_ https://twitter.com/Psycho__Coder\n\n## License\nThis software is under [MIT License](https://en.wikipedia.org/wiki/MIT_License)","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fanimeshshaw%2Fpython-malshare","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fanimeshshaw%2Fpython-malshare","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fanimeshshaw%2Fpython-malshare/lists"}