# dilame/instagram-private-api

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/dilame-instagram-private-api).**

6,445 stars · 1,182 forks · TypeScript · MIT

## Links

- GitHub: https://github.com/dilame/instagram-private-api
- awesome-repositories: https://awesome-repositories.com/repository/dilame-instagram-private-api.md

## Topics

`instagram` `instagram-api` `instagram-client` `instagram-feed` `instagram-private-api` `instagram-scraper` `instagram-sdk`

## Description

This project is a TypeScript-based private API SDK and automation framework for Instagram. It serves as a server-side toolkit for NodeJS that interfaces with undocumented API endpoints to programmatically manage profiles and automate account operations.

The library focuses on mimicking authentic user behavior by simulating mobile application network traffic patterns and headers. It uses stateful session management to maintain authentication tokens and employs a sequence-based coordination model to execute complex workflows, such as multi-step media uploads.

The framework covers several high-level automation domains, including social data extraction for followers and activity feeds, direct messaging, and user or location search. It also provides capabilities for publishing photos and videos to profiles.

The system is built with a strong type system to ensure the structure of remote API responses and includes interceptor-based logging for debugging network traffic.

## Tags

### Business & Productivity Software

- [Instagram](https://awesome-repositories.com/f/business-productivity-software/automation-bots/instagram.md) — Automates interactions and workflows on Instagram using a private API to mimic human behavior.
- [Content Publishing](https://awesome-repositories.com/f/business-productivity-software/automation-bots/instagram/content-publishing.md) — Uploads and posts photos or videos to Instagram profiles programmatically through scripted sequences.
- [Direct Messaging Automation](https://awesome-repositories.com/f/business-productivity-software/automation-bots/instagram/direct-messaging-automation.md) — Provides an automated interface for sending and receiving private messages on Instagram.
- [Private API SDKs](https://awesome-repositories.com/f/business-productivity-software/automation-bots/instagram/private-api-sdks.md) — A TypeScript library for interacting with undocumented Instagram API endpoints to automate account actions.
- [Social Media Management](https://awesome-repositories.com/f/business-productivity-software/social-media-management.md) — A server-side toolkit for programmatically managing Instagram profiles, direct messages, and media uploads.

### Data & Databases

- [Automated Content Publishing](https://awesome-repositories.com/f/data-databases/api-upload-interfaces/content-publishing-apis/automated-content-publishing.md) — Uploads and publishes photos or videos to profiles by coordinating the required network request sequences. ([source](https://cdn.jsdelivr.net/gh/dilame/instagram-private-api@master/README.md))
- [Social Feed Scrapers](https://awesome-repositories.com/f/data-databases/data-feeds/subscription-feed-retrievers/social-feed-scrapers.md) — Programmatically retrieves followers, news, and media comments to populate activity streams from Instagram. ([source](https://cdn.jsdelivr.net/gh/dilame/instagram-private-api@master/README.md))
- [Instagram Content Retrievers](https://awesome-repositories.com/f/data-databases/search-result-aggregators/social-media-search-aggregators/public-content-retrievers/instagram-content-retrievers.md) — Retrieves followers, media comments, and activity feeds from Instagram to populate external data streams.
- [Repository Patterns](https://awesome-repositories.com/f/data-databases/backend-data-access-layers/repository-patterns.md) — Organizes low-level network requests into dedicated repositories to isolate raw API calls from business logic.
- [User and Location Search](https://awesome-repositories.com/f/data-databases/search-result-aggregators/social-media-search-aggregators/public-content-retrievers/user-and-location-search.md) — Finds specific profiles and location-based data on Instagram via automated queries.

### Networking & Communication

- [Traffic Pattern Simulation](https://awesome-repositories.com/f/networking-communication/network-traffic-processors/api-response-simulators/traffic-pattern-simulation.md) — Mimics mobile application network traffic patterns and headers to bypass server-side security checks.
- [Private API Wrappers](https://awesome-repositories.com/f/networking-communication/private-api-wrappers.md) — Provides low-level request execution for friendships, direct messages, and media uploads via undocumented API endpoints. ([source](https://cdn.jsdelivr.net/gh/dilame/instagram-private-api@master/README.md))

### Security & Cryptography

- [Session State Management](https://awesome-repositories.com/f/security-cryptography/authentication-clients/client-to-server-authentication/session-state-management.md) — Maintains authentication tokens and cookie sets across requests to simulate continuous logged-in sessions.

### Software Engineering & Architecture

- [Complex Workflow Coordination](https://awesome-repositories.com/f/software-engineering-architecture/system-internals/centralization-patterns/workflow-execution-managers/complex-workflow-coordination.md) — Executes predefined series of network requests to complete complex multi-step operations like media uploads.
- [Network Traffic Logging](https://awesome-repositories.com/f/software-engineering-architecture/request-interceptors/network-traffic-logging.md) — Hooks into the request pipeline to capture and output raw network traffic for debugging.

### Testing & Quality Assurance

- [User Workflow Simulation](https://awesome-repositories.com/f/testing-quality-assurance/user-workflow-simulation.md) — Mimics specific user behaviors and login sequences to maintain account authenticity and avoid detection. ([source](https://cdn.jsdelivr.net/gh/dilame/instagram-private-api@master/README.md))

### Programming Languages & Runtimes

- [Type Safety](https://awesome-repositories.com/f/programming-languages-runtimes/language-features-paradigms/type-system-tools/type-safety/end-to-end/type-safety.md) — Uses a strong type system to define the precise structure of remote API responses and internal data models.

### Web Development

- [Type-Safe API Clients](https://awesome-repositories.com/f/web-development/type-safe-api-clients.md) — Provides a type-safe interface for simulating user workflows and fetching social feeds via network requests.