# instagrapi

> Open-source Python library for Instagram's private (mobile) API. MIT-licensed. Login, posting, stories, reels, direct messages, comments, followers, hashtags, locations. Most actively maintained Python lib for the surface.

This site (instagrapi.com) is the developer reference + topic-cluster hub. Canonical source code lives at github.com/subzeroid/instagrapi. Comprehensive API docs at subzeroid.github.io/instagrapi.

## Core libraries

- [instagrapi](https://github.com/subzeroid/instagrapi): sync Python library for Instagram private API
- [aiograpi](https://github.com/subzeroid/aiograpi): async/await sister library, same author, same surface
- [instagrapi-rest](https://github.com/subzeroid/instagrapi-rest): RESTful HTTP wrapper around instagrapi
- [instagrapi-extra](https://github.com/subzeroid/instagrapi-extra): devices, locale setup, browser cookie auth utilities

## Open-source CLIs (Instagram)

- [insta-dl](https://github.com/subzeroid/insta-dl): async CLI to download IG profiles, reels, stories, hashtags. Uses HikerAPI managed backend; no-ban
- [insto](https://github.com/subzeroid/insto): interactive Instagram OSINT CLI. REPL + dossier export. HikerAPI / aiograpi backends

## MCP servers (for Cursor, Claude Code, Claude Desktop, OpenAI Codex, Zed, Windsurf)

- [hikerapi-mcp](https://github.com/subzeroid/hikerapi-mcp): 105+ Instagram tools via HikerAPI
- [lamatok-mcp](https://github.com/subzeroid/lamatok-mcp): TikTok tools via Lamatok
- [datalikers-mcp](https://github.com/subzeroid/datalikers-mcp): 29 Instagram + TikTok dataset tools

## Telegram bots (open source)

- [instagram-downloader-tgbot](https://github.com/subzeroid/instagram-downloader-tgbot): download IG posts, stories, reels, highlights
- [tiktok-downloader-tgbot](https://github.com/subzeroid/tiktok-downloader-tgbot): TikTok videos without watermark
- [instagram-osint-tgbot](https://github.com/subzeroid/instagram-osint-tgbot): 20 OSINT commands for IG intelligence

## Hosted alternatives (managed APIs / data)

- [HikerAPI](https://hikerapi.com/p/hsazcgym): managed live Instagram API. 129 endpoints. Same API surface as instagrapi without self-hosting (sessions, proxies, retries handled). 100 free requests
- [Lamatok](https://lamatok.com/p/s6kl8mtn): managed live TikTok API. Same team. 100 free requests
- [Datalikers](https://datalikers.com/p/1by27bwg): cached Instagram + TikTok data + datasets + MCP. Lower cost than live scraping when freshness is not critical. 100 free requests

## Documentation

- [Official docs (Sphinx)](https://subzeroid.github.io/instagrapi/): full API reference, usage guides per endpoint group
- [GitHub README](https://github.com/subzeroid/instagrapi#readme): quickstart and contributor guide
- [/install](https://instagrapi.com/install): pip / Poetry install with quickstart code
- [/guides](https://instagrapi.com/guides): hands-on tutorials (login, sessions, proxies, scraping, posting)
- [/guides/errors](https://instagrapi.com/guides/errors): Instagram API error reference (challenge_required, login_required, etc.)
- [/compare/hikerapi](https://instagrapi.com/compare/hikerapi): when to self-host instagrapi vs use managed HikerAPI

## License

MIT.