A TypeScript client that talks to Instagram the way the Android app does. Every call returns a checked model or throws a typed error.
The login flow, headers and GraphQL queries of the current app build, read from the app itself. A script checks them against each new build.
Results are checked at runtime against lenient schemas. Each failure has its own error class. Ids are exact 64-bit strings.
Log in once and reuse the saved session. Re-login on expiry, two-factor codes, retries with backoff and an optional proxy.
Profiles, follows, feeds, posts, comments, stories, highlights, notes, reels, direct messages and insights.
Every public export carries a doc comment, published as this guide and a complete API reference.
The calls were checked on a live account, and a read-only check runs against the service before each release.
import { IgFlare, FileSessionStore } from 'igflare';
const ig = await IgFlare.fromStore(new FileSessionStore('./session.json'));
if (ig.session.auth.userId === undefined) await ig.login({ username, password });
const user = await ig.user.infoByUsername('instagram');
console.log(user.full_name, user.follower_count);| Area | Calls |
|---|---|
| Account | Profile, biography, name, links, profile picture, activity |
| Follow graph | Follow, followers and following, requests, block, mute, close friends |
| Feeds | Timeline, user, hashtag, place, reels and Explore, with iterators |
| Posts | Likes, comments and replies, saving and collections, editing and tags, archive and pin |
| Publishing | Photo, video, carousel, reel, story, highlights and notes |
| Direct | Inbox and requests, text, links, photos, videos, voice, shared posts and stories, groups |
| Insights | Account overview, audience, content ranking, post and reel insights |
Unofficial
igflare is not affiliated with or endorsed by Meta or Instagram. Using the private API can go against Instagram's Terms of Use and lead to account restrictions. Known limits are in limitations.