- 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_handler
kwarg 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
kwargs
tonews()
for paging support - Add
tag_section()
andlocation_section()
endpoints - Add
proxy_handler
kwarg 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-GIS
signed header requirement
- Fix for changes in the
- Web API:
- Fix for changes in the
X-Instagram-GIS
signed header requirement
- Fix for changes in the
- Web API:
client.settings
now includesuser_agent
which you should persist sincerhx_gis
is dependent on both thecsrftoken
(in cookie) and the client'suser_agent
- Web API:
- Fix for new
query_hash
param andX-Instagram-GIS
signed header requirement - You should now store the
rhx_gis
value returned byclient.settings
along 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
ClientReqHeadersTooLargeError
error
- 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
settings
property.
- New endpoints:
- Web API:
- New endpoints:
post_photo()
,tag_feed()
,location_feed()
- Removed user-agent from
settings
property.
- New endpoints:
- App API:
Client.standard_ratios()
andClient.reel_ratios()
is deprecated and replaced withMediaRatios.standard
andMediaRatios.reel
respectively.- Deprecated and experimental endpoints now warned with
ClientDeprecationWarning
andClientExperimentalWarning
. collection_feed()
,feed_liked()
,self_feed()
have been updated to support pagination through themax_id
kwarg.
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_video
argument 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