{"id":15107929,"url":"https://github.com/vanyasem/vk-scraper","last_synced_at":"2025-10-23T02:31:35.336Z","repository":{"id":62587661,"uuid":"95310221","full_name":"vanyasem/VK-Scraper","owner":"vanyasem","description":"Scrape VK media","archived":false,"fork":false,"pushed_at":"2023-09-26T17:14:52.000Z","size":78,"stargazers_count":57,"open_issues_count":6,"forks_count":17,"subscribers_count":7,"default_branch":"master","last_synced_at":"2025-02-07T18:04:43.742Z","etag":null,"topics":["api","downloader","python","scrape","scraper","vk","vk-api","vkontakte","vkontakte-api"],"latest_commit_sha":null,"homepage":"https://pypi.org/project/VK-Scraper/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/vanyasem.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}},"created_at":"2017-06-24T16:44:59.000Z","updated_at":"2024-11-28T11:09:22.000Z","dependencies_parsed_at":"2022-11-04T08:21:57.988Z","dependency_job_id":null,"html_url":"https://github.com/vanyasem/VK-Scraper","commit_stats":null,"previous_names":[],"tags_count":8,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vanyasem%2FVK-Scraper","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vanyasem%2FVK-Scraper/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vanyasem%2FVK-Scraper/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vanyasem%2FVK-Scraper/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/vanyasem","download_url":"https://codeload.github.com/vanyasem/VK-Scraper/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":237769067,"owners_count":19363250,"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":["api","downloader","python","scrape","scraper","vk","vk-api","vkontakte","vkontakte-api"],"created_at":"2024-09-25T21:43:12.863Z","updated_at":"2025-10-23T02:31:34.915Z","avatar_url":"https://github.com/vanyasem.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"VK Scraper\n==========\n![Python 3.5, 3.6, 3.7](https://img.shields.io/pypi/pyversions/vk_scraper.svg)\n[![PyPI](https://img.shields.io/pypi/v/vk-scraper.svg)](https://pypi.python.org/pypi/VK-Scraper)\n[![AUR](https://repology.org/badge/version-for-repo/aur/vk-scraper.svg)](https://aur.archlinux.org/packages/vk-scraper)\n\nvk-scraper is a command-line application written in Python that scrapes and downloads VK user's / community's data. Use responsibly.\n\nTo get a better understanding of how it works, head to [the docs](DOCS.md).\n\nFeatures\n--------\n- Scrape photos\n- Scrape videos (both uploaded and external)\n- Scrape saved photos\n- Scrape stories\n\nInstall\n-------\n\n#### Arch GNU/Linux\nFor the **stable** version ([vk-scraper](https://aur.archlinux.org/packages/vk-scraper)):\n\n    git clone https://aur.archlinux.org/vk-scraper.git vk-scraper\n\nFor the **git** version ([vk-scraper-git](https://aur.archlinux.org/packages/vk-scraper-git)):\n\n    git clone https://aur.archlinux.org/vk-scraper-git.git vk-scraper\n\nThen build \u0026 install:\n\n    cd vk-scraper \n    makepkg -sic\n\nOr [use an AUR helper](https://wiki.archlinux.org/title/AUR_helpers) of your choice.\n\n#### Other distros\nFor the **stable** version:\n\n    $ pip3 install vk-scraper --upgrade --user\n\nFor the **git** version:\n\n    $ pip3 install git+https://github.com/vanyasem/VK-Scraper.git --upgrade --user\n\nUsage\n-----\nTo scrape media:\n```bash\nvk-scraper \u003cusername/community\u003e -u \u003cyour username\u003e -p \u003cyour password\u003e\n```\n*By default, downloaded media will be placed in `\u003ccurrent working directory\u003e/\u003cusername\u003e`.*\n\nTo specify multiple users/communities, pass a comma separated list of users:\n```bash\nvk-scraper username1,community1,username2,username3,community2\n```\n\nYou can also supply a file containing a list of users/communities:\n```bash\nvk-scraper -f scrape_list.txt\n```\n\n```\n$ cat vk_users.txt\nusername1\ncommunity1\nusername2\nusername3\ncommunity2\n...\n```\n*Usernames may be separated by newlines, commas, semicolons, or whitespace.*\n\nArguments\n---------\n```\n--help -h             Show help message and exit\n\n--login-user  -u      Your VK username\n\n--login-pass  -p      Your VK password\n\n--filename    -f      Path to a file containing a list of users/communities to scrape\n\n--destination -d      Specify destination folder. By default, media will\n                      be downloaded to \u003ccurrent working directory\u003e/\u003cusername\u003e\n\n--retain-username -n  Creates a subdirectory for each scraped name when the flag is set\n\n--media-types -t      Specify media types to scrape. Enter as space separated values.\n                      Valid values are image, saved, video, story, wall, or none\n                      (defaults to image)\n\n--latest              Scrape only new media since the last scrape. Uses the last modified\n                      time of the latest media item in the destination directory for comparasion\n\n--quiet       -q      Be quiet while scraping\n\n--maximum     -m      Maximum number of items to scrape\n\n--offset      -o      Offset from which the scrape starts. 0 is from the oldest. (Defaults to 0)\n```\n\nContribution\n------------\n1. Check open issues, or open a new one to start a discussion around\n   your idea or a bug you found\n2. Fork the repository and make your changes\n3. Send a pull request\n\nFuturelog\n---------\n- Scrape by hashtag\n- Scrape by location\n- Save metadata to a file (likes, comments, etc)\n- Sort photos by their albums\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvanyasem%2Fvk-scraper","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvanyasem%2Fvk-scraper","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvanyasem%2Fvk-scraper/lists"}