- Web API:
- Add
highlight_reels()andhighlight_reel_media() - Add
tagged_user_feed() - Add
tag_story_feed()andlocation_story_feed() - Update query hashes
- Fix for case sensitivity for tag feed
- Add
delete_media() - Add
proxy_handlerkwarg to support custom proxy handler such as socks
- Add
- App API:
- 🔥 BREAKING CHANGE: Change in user agent format for the app version
- 🔥 BREAKING CHANGE: Change in argument list for
search_users() - Add IGTV endpoints
- Update
media_n_comments(),search_users(),news() feed_location()deprecated- Add
kwargstonews()for paging support - Add
tag_section()andlocation_section()endpoints - Add
proxy_handlerkwarg to support custom proxy handler such as socks
- Web API:
- Improve cookie expiry detection
- App API:
- Make change to cookiejar (in 1.5.6) backward compatible
- Web API:
- Add
media_likers() - Fix
user_info2() - Fix csrf token extraction
- Add
- App API:
- Fix client authentication expiry
- Improve get cookie value
- Web API:
- Fix for changes in the
X-Instagram-GISsigned header requirement
- Fix for changes in the
- Web API:
- Fix for changes in the
X-Instagram-GISsigned header requirement
- Fix for changes in the
- Web API:
client.settingsnow includesuser_agentwhich you should persist sincerhx_gisis dependent on both thecsrftoken(in cookie) and the client'suser_agent
- Web API:
- Fix for new
query_hashparam andX-Instagram-GISsigned header requirement - You should now store the
rhx_gisvalue returned byclient.settingsalong with the cookie string
- Fix for new
- Web API:
- Fix 403 Forbidden error when making unauthenticated requests
- App API:
- BREAKING CHANGE: New arguments are needed for
feed_tag(),tag_search(),user_following(),user_followers(),search_users(),location_fb_search() - New
ClientReqHeadersTooLargeErrorerror
- BREAKING CHANGE: New arguments are needed for
- Web API:
- Fix
user_info2()
- Fix
- App API:
- Refactored error detection. New
ClientCheckpointRequiredError,ClientChallengeRequiredError,ClientSentryBlockError - New highlight endpoints
- New
comment_inline_replies()endpoint - New
story_viewers()endpoint - Updates for user feed and comments endpoints
- Refactored error detection. New
- Common:
- BREAKING CHANGE: New ClientConnectionError for network-related errors
- App API:
- Add comment replies endpoint
- Add presence endpoints
- Add tag following endpoints
- Update user and tag search endpoints
- Update app version to 26
- Web API:
- BREAKING CHANGE: Tag and Location feeds updated to use graphql endpoints.
- Add timeline feed, reels tray, reels (stories) feed
- App API:
- Minor fixes
- App API:
- Fix video upload retry logic
- Fix compatpatch typo
- Improve app compatpatch for media location
- App API:
- New endpoints:
ignore_user(),remove_follower(),replay_broadcast_comments(),replay_broadcast_likes()
- New endpoints:
- Minor fixes
- Web API:
- New endpoints:
user_info2() - Deprecate all remaining endpoints using
query/:user_info(),media_info()
- New endpoints:
- App API:
- New endpoints:
feed_only_me(),media_only_me(),media_undo_only_me(),enable_post_notifications(),disable_post_notifications() - Deprecated:
user_map(),expose() - Removed device info, keys, etc from
settingsproperty.
- New endpoints:
- Web API:
- New endpoints:
post_photo(),tag_feed(),location_feed() - Removed user-agent from
settingsproperty.
- New endpoints:
- App API:
Client.standard_ratios()andClient.reel_ratios()is deprecated and replaced withMediaRatios.standardandMediaRatios.reelrespectively.- Deprecated and experimental endpoints now warned with
ClientDeprecationWarningandClientExperimentalWarning. collection_feed(),feed_liked(),self_feed()have been updated to support pagination through themax_idkwarg.
This update is recommended especially for those using the web api.
- Web API:
- Important: The new graphql endpoint appears to be replacing the old query endpoint. The graphql endpoint is comparatively more limited and some attributes may no longer be available.
- You should exercise caution when using functions relying on the old query endpoints such as
user_info()andmedia_info()since IG no longer uses them. user_feed()is now using the graphql endpoint and has compatibility-breaking changes.
- App API:
- Fix regression with photo posting and profile image update.
- Breaking Change: Removed
is_videoargument fromreel_compatible_aspect_ratio()
- New app client endpoint:
api.bulk_delete_comments() - Prevent uploading of very small chunks when posting video
- Web API updates to use new graphql endpoints
- New endpoints:
api.friendships_unblock(),api.block_friend_reel(),api.unblock_friend_reel(),api.set_reel_block_status(),api.blocked_reels(),api.blocked_user_list(),api.user_reel_settings(),api.set_reel_settings() - Update
api. media_seen() - Fix
ClientCompatPatch.media()for carousel/album posts - Other minor fixes
- Change default user agent constants
- Video:
- implement chunks upload retry
- remove configure delay
- support using a file-like object instead of having the whole file in memory
- Implement collections
- Update app version to 10.16.0
- Other minor fixes
- Update app version to 10.15.0
- New ad_id property for login
- Update
friendships_create(),friendships_destroy(),post_comment(),post_like(),delete_like().
- Fix the case when a cookie doesn't have an expiry date
- Update app version to 10.14.0
- Bug fix
configure_video()
- New helper method
user_broadcast()to get a user's live broadcast - Add new filters to
ClientCompatPatch
- Invalid parameters now consistently raise ValueError. Affected endpoints can be found in 146a84b.
- New ClientThrottledError for 429 (too many requests) errors
- Fix pip setup
- Fix web client search
- Add size validation for post_photo and post_video
- Update story configure endpoint and parameters
- Validate video story duration
- New utility class InstagramID for ID/shortcode conversions
Minor improvements
- New check username endpoint
check_username() - New comment likers endpoint
comment_likers() - Better Python 3 compatibility
- Support album posting with
post_album() - New stickers endpoint
- Internal refactoring
- New endpoints for app client
suggested_broadcasts()media_likers_chrono()
- New method for web client:
media_info2()that retrieves carousel media info - Fixes for app api:
feed_timeline()broadcast_like_count()- pagination fixes for
feed_location(),username_feed(),saved_feed(),location_related(),tag_related(),media_likers(),feed_popular() - compat patch:
media()
- Update app client version to 10.9.0
- New endpoints for app client
top_search()
- Fix param validation for
broadcast_comments()
- New live/broadcast endpoint functions for app client
top_live_status()broadcast_like()broadcast_like_count()broadcast_comments()broadcast_heartbeat_and_viewercount()broadcast_comment()
- New shortcut functions for app client
self_feed()post_photo_story()post_video_story()
- Add more validation to
post_video()
- Support specification of location to
post_photo(),post_video() - Proxy support (alpha)
- Support usertags in
edit_media()(app client) - New endpoint functions for app client
expose()megaphone_log()discover_channels_home()discover_chaining()user_map()feed_popular()friendships_block()usertag_self_remove()edit_profile()logout()
- New disable/enable media comments endpoints
- New FB location search endpoint
- Add new settings property to help extract settings for saving
- Fix Python 3 compatibility
- Detect if authenticated cookie has expired and raise ClientCookieExpiredError
- Detect if re-login is required and raise ClientLoginRequiredError
First release
- access both the private Instagram app or web API
- CompatPatch patches the objects returned in the private API to match those returned in the public API
- can be used to largely replace the public Instagram API that is now severely restricted