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

https://github.com/instagram-automations/instagram-private-api

instagram private api automation library
https://github.com/instagram-automations/instagram-private-api

anti-detect api automation bot cli instagram-api instagram-private-api mobile-api nodejs playwright proxy python requests reverse-engineering scraper social-media

Last synced: 6 months ago
JSON representation

instagram private api automation library

Awesome Lists containing this project

README

          

# instagram-private-api

Unofficial API toolkit for programmatically interacting with Instagramโ€™s private mobile endpoints โ€” used for automation, research, and bot development.



Telegram


Discord


WhatsApp


Gmail


For discussion, queries, and freelance work โ€” reach out ๐Ÿ‘†

---

## Introduction
> The **Instagram Private API** provides access to internal mobile app endpoints used by the official Instagram app. Unlike the public Graph API, it allows developers to automate actions such as following, liking, messaging, or posting content directly, simulating real app behavior.


instagram-private-api.png

### Key Benefits
1. Full access to features beyond Graph API.
2. Mimics real mobile user behavior.
3. Enables automation and account control.
4. Supports reverse-engineering for research.
5. Flexible for both Python and Node.js stacks.

---

## Features

| Feature | Description |
|----------|-------------|
| Login simulation | Authenticate like a mobile user |
| Media upload | Upload stories, reels, and posts |
| Messaging | Send and receive direct messages |
| Proxy routing | Use IP rotation for safety |
| Device emulation | Mimic Android/iOS behavior |

---

## Use Cases
- Automating Instagram posting workflows
- Managing DM campaigns
- Researching engagement patterns
- Reverse-engineering mobile API calls
- Building stealth marketing bots

---

## FAQs

**Q:** What is the Instagram Private API?
**A:** The Instagram Private API refers to the set of internal endpoints used by the mobile app. It allows developers to perform actions like posting, liking, following, and messaging directly from code by imitating official app requests.

**Q:** How does it differ from the official Instagram Graph API?
**A:** The Graph API is a public, rate-limited interface designed for business accounts, offering safe but restricted access. The Private API, on the other hand, is unofficial and provides full user-level control over the platform but risks account bans if abused.

**Q:** Is it officially supported by Instagram?
**A:** No. The Private API is **not officially supported** or documented by Instagram. Itโ€™s used for research, testing, and automation purposes and may break if Instagram changes its internal endpoints.

---

## Results
-----------------------------------
> 5x wider access than Graph API
> Enables complete automation control
> Simulates authentic user sessions safely

## Performance Metrics
-----------------------------------
Average Benchmarks:
- **Speed:** ~2x faster than Graph API
- **Stability:** 95% with correct headers
- **Ban Rate:** <1% using proper delays
- **Throughput:** 100+ API actions/min

---

## Do you have a customized project for us?
Contact Us



Gmail
support@appilot.app

โ”ƒ

Telegram
pilot

โ”ƒ

Discord
zee#2655

โ”ƒ

WhatsApp
whatsapp



---

## Installation

### Pre-requisites
- Python 3.8+ or Node.js 18+
- Git
- Proxy (optional)

### Steps
```bash
# Clone the repo
git clone https://github.com/yourusername/instagram-private-api.git
cd instagram-private-api

# Install dependencies
npm install
# or
pip install -r requirements.txt

# Setup environment
cp .env.example .env

# Run
npm start
# or
python main.py
```

---

## Example Output
```bash
โœ… Logged in as @automation_test
๐Ÿ“ธ Uploaded Story: automation.png
๐Ÿ’ฌ Sent DM to @target_user
```

---

## License
MIT License