@grinchd/instagram-private-api
v1.37.0
Published
Instagram private API wrapper for full access to instagram
Downloads
3
Readme
NodeJS Instagram private API client
Table of Contents
Install
From npm
npm install instagram-private-api
From github
npm install github:dilame/instagram-private-api
Support us
If you find this library useful for you, you can support it by donating any amount
BTC: 1Dqnz9QuswAvD3t7Jsw7LhwprR6HAWprW6
Examples
You can find usage examples here
import { IgApiClient } from './src';
import { sample } from 'lodash';
const ig = new IgApiClient();
// You must generate device id's before login.
// Id's generated based on seed
// So if you pass the same value as first argument - the same id's are generated every time
ig.state.generateDevice(process.env.IG_USERNAME);
// Optionally you can setup proxy url
ig.state.proxyUrl = process.env.IG_PROXY;
(async () => {
// Execute all requests prior to authorization in the real Android application
// Not required but recommended
await ig.simulate.preLoginFlow();
const loggedInUser = await ig.account.login(process.env.IG_USERNAME, process.env.IG_PASSWORD);
// The same as preLoginFlow()
// Optionally wrap it to process.nextTick so we dont need to wait ending of this bunch of requests
process.nextTick(async () => await ig.simulate.postLoginFlow());
// Create UserFeed instance to get loggedInUser's posts
const userFeed = ig.feed.user(loggedInUser.pk);
const myPostsFirstPage = await userFeed.items();
// All the feeds are auto-paginated, so you just need to call .items() sequentially to get next page
const myPostsSecondPage = await userFeed.items();
await ig.media.like({
// Like our first post from first page or first post from second page randomly
mediaId: sample([myPostsFirstPage[0].id, myPostsSecondPage[0].id]),
moduleInfo: {
module_name: 'profile',
user_id: loggedInUser.pk,
username: loggedInUser.username,
},
d: sample([0, 1]),
});
})();
Basic concepts
Feeds
Feed allows you to get data. Every feed is accessible via ig.feed.feedName
. See nice example and learn how to work with library feeds.
Available feeds key list:
accountFollowers
, accountFollowing
, news
, discover
, pendingFriendships
, blockedUsers
, directInbox
, directPending
, directThread
, user
, tag
, location
, mediaComments
, reelsMedia
, reelsTray
, timeline
, musicTrending
, musicSearch
, musicGenre
, musicMood
, usertags
, saved
Most of the feeds requires initialization parameter, like user pk. Check autogenerated docs, every feed doc link starts with feeds/
and contains constructor with argument if needed.
Repositories
Repositories implements low-level atomic operations. Any repository method must make at most one api-request. There is repository listing below, so you can get information about methods of each repository from our autogenerated docs.
Keys is a little hints, with it you will be able to get access to repository via ig.key
.
| Key | Repository class documentation |
| --- | --- |
| account
| AccountRepository |
| attribution
| AttributionRepository |
| challenge
| ChallengeRepository |
| consent
| ConsentRepository |
| creatives
| CreativesRepository |
| direct
| DirectRepository |
| directThread
| DirectThreadRepository |
| discover
| DiscoverRepository |
| fbsearch
| FbsearchRepository |
| friendship
| FriendshipRepository |
| launcher
| LauncherRepository |
| linkedAccount
| LinkedAccountRepository |
| live
| LiveRepository |
| location
| LocationRepository |
| locationSearch
| LocationSearch |
| loom
| LoomRepository |
| media
| MediaRepository |
| music
| MusicRepository |
| news
| NewsRepository |
| qe
| QeRepository |
| qp
| QpRepository |
| tag
| TagRepository |
| upload
| UploadRepository |
| user
| UserRepository |
| zr
| ZrRepository |
Services
Services will help you to maintain some actions without calling a couple repositority methods or perform complex things like pre and postlogin flow simulations or photo/video publishing.
| Key | Service class documentation |
| --- | --- |
| publish
| PublishService |
| search
| SearchService |
| simulate
| SimulateService |
| story
| StoryService |
Contribution
If you need features that is not implemented - feel free to implement and create PRs!
Plus we need some documentation, so if you are good in it - you are welcome.
Setting up your environment is described here.
Useful links
instagram-id-to-url-segment - convert the image url fragment to the media ID
Special thanks
- Richard Hutta, original author of this library. Thanks to him for starting it.
Thanks to contributors
- Nerixyz, for writing a huge amount of code for this library.