Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/EdouardCourty/user-instagram
This module allows you to get the data of any user or post on Instagram.
https://github.com/EdouardCourty/user-instagram
instagram instagram-feed instagram-scraper node-instagram user-instagram
Last synced: about 2 months ago
JSON representation
This module allows you to get the data of any user or post on Instagram.
- Host: GitHub
- URL: https://github.com/EdouardCourty/user-instagram
- Owner: EdouardCourty
- Created: 2019-05-01T16:06:36.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2024-01-09T20:24:00.000Z (12 months ago)
- Last Synced: 2024-08-01T16:30:21.461Z (5 months ago)
- Topics: instagram, instagram-feed, instagram-scraper, node-instagram, user-instagram
- Language: JavaScript
- Homepage:
- Size: 680 KB
- Stars: 83
- Watchers: 1
- Forks: 18
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# User Instagram - DEPRECATED
[](https://img.shields.io/david/EdouardCourty/user-instagram)
[](https://github.com/EdouardCourty/user-instagram/actions/workflows/node.js.yml)
## The end
Thursday 07 2022.
Instagram's API & Authentication changed a lot and I don't have the time to update and reverse-engineer everything again.
I have no choice but to deprecate this module.
If you want to become the official maintainer, feel free to open an issue and we'll get in touch!
Thanks to the thousands of people that used this module through the years!
Big love from Paris!
## Usage
Use this module in your projet by installing it with `npm install user-instagram`.
Here is a quick example or usage:
```javascript
const instagram = require('user-instagram');
await instagram.authenticate('my_instagram_username', 'my_instagram_password');
// Fetching a user
instagram.getUserData('edouard_courty').then(userData => {
// Do whatever you need to to with this data
console.log(`My username is ${userData.getUsername()}.`);
})
// Fetching a post
instagram.getPostData('CUc7tBPFXvP').then(postData => {
// Do whatever you need to to with this data
console.log(`The caption of this post is ${postData.getCaption()}.`);
})
```
## Documentation
In the previous versions of `user-instagram`, only a small amount of requests could be sent every day without getting rate-mimited.
Couple of issues were submitted about this problem and it's the main reason why I decided to refactor this module, and add an authentication method to it.
### Authentication
The `authenticate` method takes two mandatory parameters: `username` and `password`.
A good way to keep these strings safe is storing them in an uncommited file in your repo like some `instagram_config.json` file structured like the following:
```json
{
"username": "your username here",
"password": "your password here"
}
```
Then use it like this:
```javascript
const instagram = require('user-instagram');
const {username, password} = require('instagram_config.json')
await instagram.authenticate(username, password);
```
### Getting a user's data
When logged in, you can request the data of any public user you want, plus the private users that your account follows.
The `getUserData` method takes only one parameter: the username of the user to be fetched.
This method will return a promise holding a `User` class, containing getters for all the interesting properties of this class.
#### Available user properties
All the boolean values are accessed with the following methods: (the function names should be self explanatory of their return value)
- `isVerified()`
- `isPrivate()`
- `isBusinessAccount()`
- `isProfessionalAccount()`
- `hasClips()`
- `hasArEffect()`
- `hasChannel()`
- `hasGuides()`
- `isHidingLikesAndViewsCount()`
- `hasJoinedRecently()`
All the non-boolean values are accessed with the following methods:
- `getUsername()`
- `getBiography()`
- `getPublicationsCount()`
- `getFollowersCount()`
- `getExternalUrl()`
- `getFollowingCount()`
- `getFullName()`
- `getHighlightsReelsCount()`
- `getId()`
- `getBusinessAddressJson()`
- `getBusinessContactMethod()`
- `getBusinessEmail()`
- `getBusinessPhoneNumber()`
- `getBusinessCategoryName()`
- `getOverallCategoryName()`
- `getCategoryEnum()`
- `getProfilePicture()`
- `getHdProfilePicture()`
- `getPronouns()`
- `getMedias()`
### Getting a post's data
When logged in, you can request the data of any public post you want, plus the posts of the private accounts that your account follows.
The `getPostData` method takes only one parameter: the shortcode of the post to be fetched.
This method will return a promise holding a `Post` class, containing getters for all the interesting properties of this class.
#### Available post properties
All the boolean values are accessed with the following methods: (the function names should be self explanatory of their return value)
- `isVideo()`
- `areCommentsDisabled()`
- `areLikesAndViewsCountDisabled()`
- `isPaidPartnership()`
- `isAd()`
- `hasAudio()`
All the non-boolean values are accessed with the following methods:
- `getId()`
- `getType()`
- `getShortcode()`
- `getDimensions()`
- `getDisplayUrl()`
- `getVariants()`
- `getAccessibilityCaption()`
- `getTaggedUsers()`
- `getCaption()`
- `getCommentsCount()`
- `getComments()`
- `getDate()`
- `getLikesCount()`
- `getLocation()`
- `getOwner()`
- `getChildren()`
- `getVideoViewsCount()`
- `getVideoPlaysCount()`
#### Generic properties shared across the module
Each Media from the `getMedias()` in the `User` class method is a `Media` class that has these getters:
- `getType()`
- `getId()`
- `getShortcode()`
- `getCaption()`
- `getDimensions()`
- `getDisplayUrl()`
- `getTaggedUsers()`
- `isVideo()`
- `getAccessibilityCaption()`
- `areCommentsDisabled()`
- `getCommentsCount()`
- `getLikesCount()`
- `getTimestamp()`
- `getLocation()`
- `getChildren()`
- `hasAudio()`
- `getViewsCount()`
- `getVideoUrl()`
Every `TaggerUser` from `getTaggedUsers()` in a `Post` or a `User.getMedias()` hold the following getters:
- `getTagXPosition()`
- `getTagYPosition()`
- `getFullName()`
- `getId()`
- `isVerified()`
- `getProfilePictureUrl()`
- `getUsername()`
Every dimension value from `getDimensions()` from a `Media` or a `Post` is a `Dimension` class with a bult-in aspect-ratio calculator:
- `getHeight()`
- `getWidth()`
- `getAspectRatio()`
© Edouard Courty - 2021