https://github.com/felipeinf/instagranode
TypeScript SDK that calls Instagram’s unofficial web API.
https://github.com/felipeinf/instagranode
instagram instagram-api instagram-scraping js public-api unofficial
Last synced: about 2 months ago
JSON representation
TypeScript SDK that calls Instagram’s unofficial web API.
- Host: GitHub
- URL: https://github.com/felipeinf/instagranode
- Owner: felipeinf
- License: mit
- Created: 2026-04-11T06:29:23.000Z (2 months ago)
- Default Branch: main
- Last Pushed: 2026-04-11T23:24:54.000Z (2 months ago)
- Last Synced: 2026-04-24T02:38:13.776Z (about 2 months ago)
- Topics: instagram, instagram-api, instagram-scraping, js, public-api, unofficial
- Language: TypeScript
- Homepage: https://www.npmjs.com/package/instagranode
- Size: 39.1 KB
- Stars: 10
- Watchers: 0
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# instagranode
[](https://www.npmjs.com/package/instagranode)
TypeScript SDK for Node.js (18+) that calls Instagram’s **unofficial** web API endpoint `web_profile_info` using browser-like headers.
**Public profiles.** The flow this library uses targets **publicly visible** profile data exposed by Instagram’s web client. **It does not require Instagram user authentication** (no login, no OAuth access token, no session cookies). That also means behavior for **private** accounts is limited to what the endpoint returns without a logged-in viewer (for example, follower counts may appear while post media may not).
**Not an official product.** instagranode is **not** an official product, has **no** relationship with Meta, and is **not** affiliated with Instagram. **You are solely responsible** for your use of this library. It was **not** created with commercial use in mind and is **not** a commercial product, is **not** offered for sale, and is **not** intended as a substitute for any official Instagram tooling.
## Install
```bash
npm install instagranode
```
## Quick start
```typescript
import { InstagraNode } from "instagranode";
const ig = new InstagraNode({ browser: "chrome-mac" });
const profile = await ig.searchProfile("google");
console.log(profile.id, profile.followerCount, profile.isPrivate);
console.log(profile.mentions(), profile.links());
console.log(profile.address(), profile.business());
console.log(profile.hasVisibleMedia());
await profile.downloadProfilePic("./avatar.jpg");
```
## Sandbox (no network)
```bash
export INSTAGRANODE_SANDBOX=true
```
Or:
```typescript
const ig = new InstagraNode({ sandbox: true });
```
Fixture usernames: `sandbox_influencer`, `sandbox_business`, `sandbox_private`, `sandbox_private_media`. Any other username resolves to `sandbox_influencer` data with the requested username string.
## Errors
All SDK errors extend `InstagraNodeError` with `code` and `recoverable`. Handle `ProfileNotFoundError`, `IncompleteProfileError`, `RateLimitedError`, `BlockedError`, `NetworkError`, and `CircuitOpenError` as needed.
## Docs
See the `docs/` folder on GitHub: `getting-started.md`, `profiles.md`, `download.md`, `examples.md`.
## License
**MIT:** you may use, modify, and redistribute the code freely; the license includes a standard “as is” warranty disclaimer. The full text is in [LICENSE](./LICENSE). The separate **Legal disclaimer** at the end of this file also applies.
## Legal disclaimer
**What this is.** The following is a general informational disclaimer about the software and the project. It is not tailored to your situation or jurisdiction and does not create an attorney–client relationship.
This notice is written with U.S. law in mind; your rights and duties may differ elsewhere.
**instagranode** is not affiliated with, endorsed by, maintained by, or sponsored by Meta Platforms, Inc., Instagram, or their affiliates. **Instagram** is a trademark of Meta Platforms, Inc.
The software is provided **“AS IS”** and **“AS AVAILABLE”**, without warranties of any kind, whether express or implied, including implied warranties of merchantability, fitness for a particular purpose, and non-infringement. **Your use is at your sole risk.** To the fullest extent permitted by law, the authors and contributors disclaim liability for any direct, indirect, incidental, special, consequential, or exemplary damages, and for any loss of data, account access, goodwill, or other intangible losses, arising out of or related to your use or inability to use this software—including claims arising from violation of Instagram’s terms, policies, or applicable law, or from misuse by you or third parties.
The project exists for **personal learning and experimentation** only. You are solely responsible for compliance with Instagram’s terms and all laws that apply to you. The maintainers do not encourage or support unlawful, abusive, or harmful use.
The above is for **general information only**. It is **not legal advice**.