instagrapi.com

What It Is

instagrapi is an MIT-licensed Python library that wraps Instagram’s private mobile API. It is not Meta’s official Graph API; instead, it simulates the mobile app endpoints for developers who need to read content from personal accounts, Stories, DMs, comments, followers, hashtags, or automate publishing. The documentation clearly warns that private APIs are unpublished and subject to change, and that automated access carries account and compliance risks.

Core Features and Tech Stack

It covers endpoints for users, media, Stories, Reels, IGTV, Direct Messages, comments, hashtags, locations, and more. It also supports uploading images, videos, albums, Stories, and Reels. On the login side, it provides TOTP, SMS 2FA, challenge handling, session dump/load, and emphasizes reusing device fingerprints and cookies to reduce risk-control triggers. Responses use Pydantic models, which helps with IDE autocompletion and serialization. Native support starts from Python 3.10+; the synchronous version is instagrapi, while async use cases can use aiograpi from the same author. Non-Python projects can access it over HTTP via the instagrapi-rest Docker sidecar.

Pricing and Deployment

instagrapi itself is free and open source, installable via pip or Poetry. The main costs come from operational resources such as your own servers, residential proxies, SMS services, Redis/S3/databases, and related maintenance. It is a typical self-hosted tool: users must handle accounts, proxies, rate limits, session files, and exceptions themselves. The documentation also repeatedly recommends HikerAPI, a hosted alternative from the same team: 100 free requests, then pay-as-you-go, making it suitable for production teams that do not want to maintain infrastructure.

Pros and Cons

Its strengths are broad API coverage, being free and open source, extensive examples and guides, and detailed treatment of real-world pain points such as 2FA, challenges, proxies, and session persistence. The drawbacks are also clear: it depends on Instagram’s private API, so stability cannot be fully guaranteed; multi-account setups, residential proxies, and 24/7 availability can quickly become operational challenges; improper use may trigger challenges, rate limits, or even account risk.

Who It’s For and Access from China

It is a good fit for Python developers, research projects, small-scale social media analytics, content automation, and self-hosted data pipelines. For large-scale production, multi-account orchestration, or teams without proxy operations capability, a hosted API is usually more appropriate. The documentation does not specify access conditions from mainland China. Given that the target service is Instagram, real-world networking, account login, proxy setup, and payment flows may be affected by the external environment, so it is recommended to start with test accounts and low-volume validation. Alternatives include aiograpi, instagrapi-rest, HikerAPI, and the official Meta Graph API.