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
- Host: GitHub
- URL: https://github.com/instagram-automations/instagram-private-api
- Owner: Instagram-Automations
- Created: 2025-10-13T18:00:29.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2025-10-13T18:13:08.000Z (6 months ago)
- Last Synced: 2025-10-14T19:04:41.747Z (6 months ago)
- Topics: anti-detect, api, automation, bot, cli, instagram-api, instagram-private-api, mobile-api, nodejs, playwright, proxy, python, requests, reverse-engineering, scraper, social-media
- Homepage:
- Size: 1.28 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
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.
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.
### 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
---
## 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