Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/bartholomej/instagram-scraper-api

Get user data and posts by scraping Instagram's user page. Without any API keys or oAuths!
https://github.com/bartholomej/instagram-scraper-api

ig instagram instagram-api instagram-scraper

Last synced: 3 months ago
JSON representation

Get user data and posts by scraping Instagram's user page. Without any API keys or oAuths!

Host: GitHub
URL: https://github.com/bartholomej/instagram-scraper-api
Owner: bartholomej
License: mit
Created: 2020-11-21T12:02:30.000Z (about 4 years ago)
Default Branch: master
Last Pushed: 2023-01-07T05:06:07.000Z (about 2 years ago)
Last Synced: 2024-10-11T12:46:09.672Z (3 months ago)
Topics: ig, instagram, instagram-api, instagram-scraper
Language: TypeScript
Homepage:
Size: 345 KB
Stars: 10
Watchers: 2
Forks: 0
Open Issues: 7
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE

Awesome Lists containing this project

README

        [![npm version](https://badge.fury.io/js/instagram-scraper-api.svg)](https://badge.fury.io/js/instagram-scraper-api)

[![npm downloads](https://img.shields.io/npm/dt/instagram-scraper-api.svg)](https://npm.im/instagram-scraper-api)

[![Package License](https://img.shields.io/npm/l/instagram-scraper-api.svg)](https://www.npmjs.com/instagram-scraper-api)

[![Build & Publish](https://github.com/bartholomej/instagram-scraper-api/workflows/Build%20&%20Publish/badge.svg)](https://github.com/bartholomej/instagram-scraper-api/actions)

[![codecov](https://codecov.io/gh/bartholomej/instagram-scraper-api/branch/master/graph/badge.svg?token=YQH9UoVrGP)](https://codecov.io/gh/bartholomej/instagram-scraper-api)

# Instagram Scraper API

> Get user data and posts by scraping Instagram's user page. Without any API keys or oAuths!

>

> - API key NOT required!

> - Not any registration needed

> - Browser + Node.js (SSR) support

> - 100% TypeScript

## Demo

Here is the live [example](https://stackblitz.com/edit/instagram-scraper-api?file=index.ts)!

## Install

via yarn

```bash

yarn add instagram-scraper-api

```

via npm

```bash

npm install instagram-scraper-api --save

```

## Usage

Get latest posts from [Will Smith](https://www.instagram.com/willsmith)

```javascript

import { instagram } from 'instagram-scraper-api';

instagram

  .user('willsmith')

  .then((user) => console.log(user))

  .catch((err) => console.error(err));

```

#### Results

```javascript

{

  id: '3132929984',

  category: null,

  fullName: 'Will Smith',

  bio: 'New playground. Same kid from West Philly.⁣⁣⁣',

  website: 'https://fb.me/RTTWillTakeover',

  followersCount: 50410933,

  followingsCount: 185,

  isPrivate: false,

  isVerified: true,

  avatar: 'https://scontent-prg1-1.cdninstagram.com/v/t51.2885-19/s320x320/126947726_281263379986327_6281262352239007520_n.jpg?_nc_ht=scontent-prg1-1.cdninstagram.com&_nc_ohc=47FwFhMeHegAX_G_Efc&tp=1&oh=cb0674289129567814e591e1256131d2&oe=5FE33AAD',

  fbPage: null,

  postsCount: 1052,

  posts: [

    {

      id: '2447030206582756101',

      shortcode: 'CH1mQIKBBMF',

      photo: 'https://scontent-prg1-1.cdninstagram.com/v/t51.2885-15/e35/126151383_156030889537953_5358114580816397186_n.jpg?_nc_ht=scontent-prg1-1.cdninstagram.com&_nc_cat=1&_nc_ohc=SQAb3GhyBBwAX-KcYjc&tp=1&oh=07d2403de4db567647310872a81ab83f&oe=5FBB2897',

      isVideo: true,

      description: 'This is why nobody lets me cook. #FreshPrinceReunion',

      commentsCount: 6217,

      likesCount: 1334788,

      time: 1605928764,

      location: null

    },

    {

      id: '2446931950146244085',

      shortcode: 'CH1P6TuBU31',

      photo: 'https://scontent-prg1-1.cdninstagram.com/v/t51.2885-15/e35/p1080x1080/126838948_202552767996560_4560560924720673_n.jpg?_nc_ht=scontent-prg1-1.cdninstagram.com&_nc_cat=1&_nc_ohc=doGn1dkB44gAX84lb7d&tp=1&oh=4c68a21d7f75a808b9ca21dac476554d&oe=5FE070D8',

      isVideo: false,

      description: 'Can’t Viv with ‘em, can’t Viv without ‘em! :-) #FreshPrinceReunion',

      commentsCount: 6396,

      likesCount: 1320494,

      time: 1605917041,

      location: null

    }

  ]

}

```

Here is the [demo](https://stackblitz.com/edit/instagram-scraper-api?file=index.ts)!

### More

Work in progress...

## Development

I welcome you to customize this according to your needs ;)

Pull requests for any improvements would be great!

### Developing and debugging this library

```bash

git clone [email protected]:bartholomej/instagram-scraper-api.git

cd instagram-scraper-api

yarn

yarn start

```

#### Run demo locally

You can find and modify it in [`./demo.ts`](./demo.ts) file

```bash

yarn demo

```

## Donation

If this project have helped you save time please consider [making a donation](https://github.com/sponsors/bartholomej) for some 🍺 or 🍵 ;)

## Privacy Policy

I DO NOT STORE ANY DATA. PERIOD.

I physically can't. I have nowhere to store it. I don't even have a server database to store it. So even if Justin Bieber asked nicely to see your data, I wouldn't have anything to show him.

That's why, with this library, what happens on your device stays on your device till disappear.

## License

Copyright © 2021 [Lukas Bartak](http://bartweb.cz)

Proudly powered by nature 🗻, wind 💨, tea 🍵 and beer 🍺 ;)

All contents are licensed under the [MIT license].

[mit license]: LICENSE