Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

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: 3 months 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 5 years ago)
Default Branch: master
Last Pushed: 2023-05-06T14:13:40.000Z (about 1 year ago)
Last Synced: 2024-03-30T11:44:50.207Z (3 months ago)
Topics: crawler, gem, instagram, instagram-crawler, instagram-scraper, ruby, rubygems, scraper
Language: Ruby
Homepage:
Size: 5.26 MB
Stars: 196
Watchers: 7
Forks: 16
Open Issues: 6
Metadata Files:
- Readme: README.md
- License: LICENSE.txt

Lists

awesome-stars - mgleon08/instagram-crawler - Crawl instagram photos, posts and videos for download. (Ruby)

README

        # Instagram Crawler

[![Gem Version](https://badge.fury.io/rb/instagram-crawler.svg)](https://badge.fury.io/rb/instagram-crawler)

[![Maintainability](https://api.codeclimate.com/v1/badges/a1625a5a812f515bdd91/maintainability)](https://codeclimate.com/github/mgleon08/instagram-crawler/maintainability)

[![Build Status](https://travis-ci.org/mgleon08/instagram-crawler.svg?branch=master)](https://travis-ci.org/mgleon08/instagram-crawler)

[![Coverage Status](https://coveralls.io/repos/github/mgleon08/instagram-crawler/badge.svg?branch=master)](https://coveralls.io/github/mgleon08/instagram-crawler?branch=master)

[![security](https://hakiri.io/github/mgleon08/instagram-crawler/master.svg)](https://hakiri.io/github/mgleon08/instagram-crawler/master)

[![MIT licensed](https://img.shields.io/badge/license-MIT-blue.svg)](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]

```

![](screenshots/sessionid.png)

## Getting Started

![](screenshots/instagram_crawler_demo.gif)

### 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).