https://github.com/mgleon08/instagram-crawler
Crawl instagram photos, posts and videos for download.
https://github.com/mgleon08/instagram-crawler
crawler gem instagram instagram-crawler instagram-scraper ruby rubygems scraper
Last synced: 19 days ago
JSON representation
Crawl instagram photos, posts and videos for download.
- Host: GitHub
- URL: https://github.com/mgleon08/instagram-crawler
- Owner: mgleon08
- License: mit
- Created: 2018-11-21T14:32:59.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2023-05-06T14:13:40.000Z (almost 2 years ago)
- Last Synced: 2025-03-30T19:35:06.257Z (26 days ago)
- Topics: crawler, gem, instagram, instagram-crawler, instagram-scraper, ruby, rubygems, scraper
- Language: Ruby
- Homepage:
- Size: 5.26 MB
- Stars: 200
- Watchers: 7
- Forks: 16
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
README
# Instagram Crawler
[](https://badge.fury.io/rb/instagram-crawler)
[](https://codeclimate.com/github/mgleon08/instagram-crawler/maintainability)
[](https://travis-ci.org/mgleon08/instagram-crawler)
[](https://coveralls.io/github/mgleon08/instagram-crawler?branch=master)
[](https://hakiri.io/github/mgleon08/instagram-crawler/master)
[](https://github.com/mgleon08/instagram-crawler/blob/master/LICENSE.txt)
> The easiest way to download instagram photos, posts and videos.
### Instagram Crawler is a ruby gem to crawl instagram photos, posts and videos for download.
## Installation
```
$ gem install instagram-crawler
```
## Setting env variable
```
export sessionid=[your instagram sessionid]
```
## Getting Started
### Show all file link
`-u || --user_name`
```ruby
instagram-crawler -u
```
### Download files after this date (YYYYMMDD)
`-a || --after `
```ruby
instagram-crawler -u -d -a 20181120
```
### Download files before this date (YYYYMMDD)
`-b || --before `
```ruby
instagram-crawler -u -d -b 20181120
```
### Generate log file
`-l || --log `
```ruby
instagram-crawler -u -l
```
### Proxy
`-P || --proxyname ` `-p || --port`
```ruby
instagram-crawler -u -P http://example.com -p 1234
```
### Help
`instagram-crawler -h | --help`
```ruby
Usage:
instagram-crawler [options]
See https://github.com/mgleon08/instagram-crawler for more information.
options:
-u, --username USERNAME Instagram username
-d, --download Download files
-a, --after DATE Download files after this date (YYYYMMDD)
-b, --before DATE Download files before this date (YYYYMMDD)
-l, --log Generate a log file in the current directory
-P, --proxyname PROXYNAME Specify proxyname of your proxy server
-p, --port PORT Specify port of your proxy server (default port: 8080)
-v, --version Show the instagram-crawler version
-h, --help Show this message
```
## Docker
```docker
# make sure already setting env variable
# you can setting sessionid in local use $sessionid or pass sessionid to docker
# $PWD/instagram-crawler is file store path
# pull image
docker pull mgleon08/instagram-crawler
# docker run
docker run -it --rm -v $PWD/instagram-crawler:/instagram-crawler -e sessionid=$sessionid --name marvel mgleon08/instagram-crawler -u marvel -a 20181124 -d -l
```
## Terms of Use
[Instagram Terms of Use](https://www.instagram.com/about/legal/terms/before-january-19-2013/)
> 9.You must not access Instagram's private API by any other means other than the Instagram application itself.
10.You must not crawl, scrape, or otherwise cache any content from Instagram including but not limited to user profiles and photos.
## Contributing
Bug reports and pull requests are welcome on GitHub at [`https://github.com/mgleon08/instagram-crawler/pulls`](https://github.com/mgleon08/instagram-crawler/pulls)
## License
* Copyright (c) 2018 Leon Ji. See [LICENSE.txt](https://github.com/mgleon08/instagram-crawler/blob/master/LICENSE.txt) for further details.
* The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).