new-dev0/instagrapi

🔥 The fastest and powerful Python library for Instagram Private API 2021

If you are tired of being blocked when receiving data from Instagram, I recommend using our service - Lamadava SaaS

Features:

• Anonymous getting of user, posts, stories, highlights, followers and following users
• Anonymous getting an email and phone number, if the user specified them in his business profile
• Anonymous getting of post, story, album, Reels, IGTV data and the ability to download content
• Anonymous getting of hashtag and location data, as well as a list of posts for them
• Anonymous getting of all comments on a post and a list of users who liked it
• Management of proxy servers, mobile devices, solving captcha and challenge resolver
• Login by username and password, sessionid and support 2FA
• Managing messages and threads for Direct and attach files
• Download and upload a Photo, Video, IGTV, Reels, Albums and Stories
• Work with Users, Posts, Comments, Insights, Collections, Location and Hashtag
• Insights by account, posts and stories
• Like, following, commenting, editing account (Bio) and much more else

instagrapi - Unofficial Instagram API for Python

Fast and effective Instagram Private API wrapper (public+private requests and challenge resolver) without selenium. Use the most recent version of the API from Instagram, which was obtained using reverse-engineering with Charles Proxy and Proxyman.

Instagram API valid for 17 October 2021 (last reverse-engineering check)

Support Python >= 3.6, recommend 3.8+

For any other languages (e.g. C++, C#, F#, D, Golang, Erlang, Elixir, Nim, Haskell, Lisp, Closure, Julia, R, Java, Kotlin, Scala, OCaml, JavaScript, Crystal, Ruby, Rust, Swift, Objective-C, Visual Basic, .NET, Pascal, Perl, Lua, PHP and others), I suggest using instagrapi-rest or Lamadava SaaS

Support Chat in Telegram and GitHub Discussions

Features

1. Performs Public API (web, anonymous) or Private API (mobile app, authorized) requests depending on the situation (to avoid Instagram limits)
2. Login by username and password, including 2FA and by sessionid (and uses Authorization header instead Cookies)
3. Challenge Resolver have Email and SMS handlers
4. Support upload a Photo, Video, IGTV, Reels, Albums and Stories
5. Support work with User, Media, Comment, Insights, Collections, Location (Place), Hashtag and Direct Message objects
6. Like, Follow, Edit account (Bio) and much more else
7. Insights by account, posts and stories
8. Build stories with custom background, font animation, swipe up link and mention users
9. In the next release, account registration and captcha passing will appear

Examples of apps that use instagrapi

• Lamadava SaaS - trouble-free SaaS for providing data from IG (anonymously) and automate publications, stories, direct and much more else
• Web-service for Download Posts, Stories and Highlights
• Instagram Bot for Download Posts, Stories and Highlights
• Telegram Bot for Download Posts, Stories and Highlights

Basic Usage

from instagrapi import Client

cl = Client()
cl.login(ACCOUNT_USERNAME, ACCOUNT_PASSWORD)

user_id = cl.user_id_from_username("adw0rd")
medias = cl.user_medias(user_id, 20)

Additional example

from instagrapi import Client
from instagrapi.types import StoryMention, StoryMedia, StoryLink, StoryHashtag

cl = Client()
cl.login(USERNAME, PASSWORD, verification_code="<2FA CODE HERE>")

media_pk = cl.media_pk_from_url('https://www.instagram.com/p/CGgDsi7JQdS/')
media_path = cl.video_download(media_pk)
adw0rd = cl.user_info_by_username('adw0rd')
hashtag = cl.hashtag_info('dhbastards')

cl.video_upload_to_story(
    media_path,
    "Credits @adw0rd",
    mentions=[StoryMention(user=adw0rd, x=0.49892962, y=0.703125, width=0.8333333333333334, height=0.125)],
    links=[StoryLink(webUri='https://github.com/adw0rd/instagrapi')],
    hashtags=[StoryHashtag(hashtag=hashtag, x=0.23, y=0.32, width=0.5, height=0.22)],
    medias=[StoryMedia(media_pk=media_pk, x=0.5, y=0.5, width=0.6, height=0.8)]
)

Documentation

• Index
• Getting Started
• Usage Guide
• Interactions
  • Media - Publication (also called post): Photo, Video, Album, IGTV and Reels
  • Resource - Part of Media (for albums)
  • MediaOembed - Short version of Media
  • Account - Full private info for your account (e.g. email, phone_number)
  • TOTP - 2FA TOTP helpers (generate seed, enable/disable TOTP, generate code as Google Authenticator)
  • User - Full public user data
  • UserShort - Short public user data (used in Usertag, Comment, Media, Direct Message)
  • Usertag - Tag user in Media (coordinates + UserShort)
  • Location - GEO location (GEO coordinates, name, address)
  • Hashtag - Hashtag object (id, name, picture)
  • Collection - Collection of medias (name, picture and list of medias)
  • Comment - Comments to Media
  • Highlight - Highlights
  • Story - Story
  • StoryLink - Link (Swipe up)
  • StoryLocation - Tag Location in Story (as sticker)
  • StoryMention - Mention users in Story (user, coordinates and dimensions)
  • StoryHashtag - Hashtag for story (as sticker)
  • StorySticker - Tag sticker to story (for example from giphy)
  • StoryBuild - StoryBuilder return path to photo/video and mention co-ordinates
  • DirectThread - Thread (topic) with messages in Direct Message
  • DirectMessage - Message in Direct Message
  • Insight - Insights for a post
• Development Guide
• Handle Exceptions
• Challenge Resolver
• Exceptions