InstagramApiSharp 1.8.1

.NET 6.0 .NET Standard 2.0 .NET Framework 4.6.1

dotnet add package InstagramApiSharp --version 1.8.1

NuGet\Install-Package InstagramApiSharp -Version 1.8.1

This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.

<PackageReference Include="InstagramApiSharp" Version="1.8.1" />

For projects that support PackageReference, copy this XML node into the project file to reference the package.

<PackageVersion Include="InstagramApiSharp" Version="1.8.1" />
                    

                            Directory.Packages.props

<PackageReference Include="InstagramApiSharp" />
                    

                            Project file

For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.

paket add InstagramApiSharp --version 1.8.1

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

#r "nuget: InstagramApiSharp, 1.8.1"

#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.

#addin nuget:?package=InstagramApiSharp&version=1.8.1
                    

                            Install as a Cake Addin

#tool nuget:?package=InstagramApiSharp&version=1.8.1
                    

                            Install as a Cake Tool

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

InstagramApiSharp

A complete Private Instagram API for .NET (C#, VB.NET), covering nearly all functionalities available in the official Instagram app!

IRANIAN DEVELOPERS

InstagramApiSharp's private version - Under developing. Check #243

Target	Branch	Version	Changelog
Github	master	v2.8.40	v2.8.34

InstagramApiSharp's public version - Update date: April 05, 2025 - End Of Support(from April 5, 2019)!!!

Target	Branch	Version	Download link	Total downloads
Nuget	master	v1.8.1
Release	master	v1.8.1

Note

This library is based on InstaSharper with more features and new cool things.

Account Registration Sample

Wingo Tag App

Wingo Tag App is an excelent app to demonstrate how InstagramApiSharp works, a clean project.

License

MIT.

Terms and conditions

Use this Api at your own risk.

Thanks

estgold for contribution

ADeltaX for contribution

vitalragaz for contribution

n0ise9914 for contribution

Special thanks to all other contributors.

Special thanks to all other InstaSharper contributors.

Special thanks to mgp25 and his php wrapper.

Legal

This code is in no way affiliated with, authorized, maintained, sponsored or endorsed by Instagram or any of its affiliates or subsidiaries. This is an independent and unofficial API wrapper.

Developers

Public version - End Of Support

Name	Github	Email	Telegram	Instagram
Ramtin Jokar	@Ramtinak	ramtinak@live.com	RamtinJokar	-
Ali Noshahi	@NGame1	NGame1390@hotmail.com	NGameW	alingame

Product	Compatible and additional computed target framework versions.
.NET	net5.0 was computed. net5.0-windows was computed. net6.0 is compatible. net6.0-android was computed. net6.0-ios was computed. net6.0-maccatalyst was computed. net6.0-macos was computed. net6.0-tvos was computed. net6.0-windows was computed. net7.0 was computed. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 is compatible. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. net9.0 was computed. net9.0-android was computed. net9.0-browser was computed. net9.0-ios was computed. net9.0-maccatalyst was computed. net9.0-macos was computed. net9.0-tvos was computed. net9.0-windows was computed. net10.0 was computed. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed.
.NET Core	netcoreapp2.0 was computed. netcoreapp2.1 was computed. netcoreapp2.2 was computed. netcoreapp3.0 was computed. netcoreapp3.1 was computed.
.NET Standard	netstandard2.0 is compatible. netstandard2.1 was computed.
.NET Framework	net461 is compatible. net462 was computed. net463 was computed. net47 was computed. net471 was computed. net472 was computed. net48 was computed. net481 was computed.
MonoAndroid	monoandroid was computed.
MonoMac	monomac was computed.
MonoTouch	monotouch was computed.
Tizen	tizen40 was computed. tizen60 was computed.
Universal Windows Platform	uap10.0.16299 is compatible.
Xamarin.iOS	xamarinios was computed.
Xamarin.Mac	xamarinmac was computed.
Xamarin.TVOS	xamarintvos was computed.
Xamarin.WatchOS	xamarinwatchos was computed.

Compatible target framework(s)

Included target framework(s) (in package)

Learn more about Target Frameworks and .NET Standard.

.NETFramework 4.6.1
- Microsoft.CSharp (>= 4.7.0)
- Newtonsoft.Json (>= 13.0.3)
- Portable.BouncyCastle (>= 1.9.0)
- System.Net.Http (>= 4.3.4)
.NETStandard 2.0
- Microsoft.CSharp (>= 4.7.0)
- Newtonsoft.Json (>= 13.0.3)
- Portable.BouncyCastle (>= 1.9.0)
net6.0
- Microsoft.CSharp (>= 4.7.0)
- Newtonsoft.Json (>= 13.0.3)
net8.0
- Microsoft.CSharp (>= 4.7.0)
- Newtonsoft.Json (>= 13.0.3)
UAP 10.0.16299
- Microsoft.CSharp (>= 4.7.0)
- Microsoft.NETCore.UniversalWindowsPlatform (>= 6.2.14)
- Newtonsoft.Json (>= 13.0.3)
- Portable.BouncyCastle (>= 1.9.0)

NuGet packages (2)

Showing the top 2 NuGet packages that depend on InstagramApiSharp:

Package	Downloads
InstaService A wrapper library on top of the InstagramApiSharp library. The library provides simple functionality for downloading media files from Instagram.	1.1K
nurzhanme.InstagramUnfollowers Package Description	990

GitHub repositories (2)

Showing the top 2 popular GitHub repositories that depend on InstagramApiSharp:

Repository	Stars
aelassas/wexflow Workflow Engine and Automation Platform	657
dotnettools/SharpGrabber Download from YouTube, Vimeo, HLS (M3U8 files) and more with .NET and JavaScript - Library and desktop app for downloading high quality media	334

Version	Downloads	Last Updated
1.8.1	2,394	4/5/2025
1.8.0	2,512	11/21/2024
1.7.4	27,695	10/7/2022
1.7.2	13,226	2/28/2022
1.7.1	8,971	10/11/2021
1.7.0	2,679	9/19/2021
1.6.0	6,337	5/3/2021
1.5.0.2	10,529	2/1/2021
1.5.0.1	31,236	2/25/2020
1.5.0	2,071	2/24/2020
1.4.0.1	12,090	7/2/2019
1.4.0	19,499	4/4/2019
1.3.5	3,233	4/1/2019
1.3.4.6	3,280	3/31/2019
1.3.4.5	4,631	3/12/2019
1.3.4.4	3,306	3/4/2019
1.3.4.3	3,294	2/26/2019
1.3.4.2	3,107	2/25/2019
1.3.4.1	3,269	2/19/2019
1.3.4	3,211	2/17/2019
1.3.3.5	3,081	2/17/2019
1.3.3.4	3,155	2/13/2019
1.3.3.3	3,204	2/11/2019
1.3.3.2	3,301	2/5/2019
1.3.3.1	3,240	2/5/2019
1.3.3	3,276	1/29/2019
1.3.2.3	3,546	1/25/2019
1.3.2.2	7,674	1/24/2019
1.3.2.1	3,247	1/21/2019
1.3.2	3,317	1/18/2019
1.3.1.9	3,306	1/18/2019
1.3.1.8	3,249	1/16/2019
1.3.1.7	3,599	1/12/2019
1.3.1.6	3,686	1/7/2019
1.3.1.3	3,487	1/3/2019
1.3.1.1	3,600	12/26/2018
1.3.1	3,264	12/24/2018
1.3.0.1	3,187	12/19/2018
1.3.0	3,090	12/19/2018
1.2.0.1	3,231	12/13/2018
1.2.0	3,192	12/13/2018
1.1.6.2	3,442	11/26/2018
1.1.6.1	3,241	11/24/2018
1.1.6	3,318	11/23/2018
1.1.5.5	3,418	11/22/2018
1.1.5.2	4,391	11/20/2018
1.1.5.1	3,837	11/16/2018
1.1.5	3,228	11/15/2018
1.1.4.5	3,344	11/14/2018
1.1.4.4	3,346	11/14/2018
1.1.4.3	3,341	11/12/2018
1.1.4.2	3,363	11/8/2018
1.1.4.1	3,287	11/5/2018
1.1.4	3,296	11/4/2018
1.1.3.8	3,270	10/31/2018
1.1.3.7	3,288	10/29/2018
1.1.3.6	85,991	10/25/2018
1.1.3.5	3,369	10/21/2018
1.1.3.4	3,250	10/18/2018
1.1.3.3	3,322	10/16/2018
1.1.3.2	3,331	10/16/2018
1.1.3.1	3,329	10/14/2018
1.1.3	3,280	10/13/2018
1.1.2.8	3,349	10/8/2018
1.1.2.7	3,367	10/8/2018
1.1.2.6	3,318	10/8/2018
1.1.2.5	3,323	10/8/2018
1.1.2.4	3,321	10/5/2018
1.1.2.3	3,389	10/4/2018
1.1.2.2	3,329	10/2/2018
1.1.2.1	3,331	10/2/2018
1.1.2	3,296	9/28/2018
1.1.1.1	3,321	9/25/2018
1.1.1	3,347	9/23/2018
1.1.0.9	3,420	9/20/2018
1.1.0.8	3,342	9/18/2018
1.1.0.7	3,258	9/14/2018
1.1.0.5	3,438	9/14/2018
1.1.0.2	3,319	9/13/2018
1.1.0.1	3,337	9/12/2018
1.1.0	3,395	9/11/2018
1.0.6	3,293	9/10/2018
1.0.5.6	3,365	9/9/2018
1.0.5.5	3,317	9/9/2018
1.0.5.4	3,319	9/8/2018
1.0.5.3	3,277	9/7/2018
1.0.5.2	3,454	9/7/2018
1.0.5.1	3,327	9/7/2018
1.0.5	3,364	9/7/2018
1.0.4.9	3,319	9/6/2018
1.0.4.8	3,361	9/6/2018
1.0.4.7	3,336	9/5/2018
1.0.4.6	3,363	9/2/2018
1.0.4.5	3,444	9/1/2018
1.0.4.4	3,359	9/1/2018
1.0.4.3	3,347	8/31/2018
1.0.4.2	3,301	8/31/2018
1.0.4.1	3,345	8/30/2018
1.0.4	3,357	8/30/2018
1.0.3.5	3,356	8/28/2018
1.0.3.4	3,492	8/25/2018
1.0.3.3	3,452	8/20/2018
1.0.3.2	3,443	8/17/2018
1.0.3.1	3,365	8/16/2018
1.0.3	3,368	8/14/2018
1.0.2.9	3,369	8/9/2018
1.0.2.8	3,441	8/4/2018
1.0.2.7	3,438	8/3/2018
1.0.2.6	3,453	7/22/2018
1.0.2.5	3,410	7/21/2018
1.0.2.4	3,573	7/19/2018
1.0.2.3	3,616	7/3/2018
1.0.2.2	3,371	6/14/2018
1.0.2.1	3,658	6/11/2018
1.0.2	3,545	6/5/2018
1.0.1	3,618	6/1/2018
1.0.0	3,502	5/15/2018

v1.8.0
- [Add] support for reels media
- [Add] support for uploading reels
- [Add] 261 api version
- [Add] LikeStoryAsync/UnLikeStoryAsync to StoryProcessor
- [Add] support for uploading story link
- [Add] support for story link
- [Add] ValidateUriAsync to StoryProcessor
- [Bugfix] for GenerateUploadId()
- [Fix] issue with auto_expand_chaining null (#597) by @bman46
* Update depends
* Fix null value exception
* Allow null value instead
* Remove excess using

- [Update] all thread client_context functions
- [Update] SendDirectPhotoAsync to latest version
- [Update] LiveProcessor.CreateAsync

v1.7.4
- [Bugfix] for ChangePasswordAsync ( thx to @behi1ty for report )
- [Add] checkpoint required error ( thx to @bman46 )
- [Update] GenerateUploadId
- [Update] GetUserMedia... URI
- [Tiny update] for ChallengeLoginInfo/TwoFactorLoginInfo

v1.7.2
- [Update] TwoFactorLoginAsync ( thx to @bman46 )

v1.7.1
- [Bugfix] for GetUserMediaAsync, GetUserMediaByIdAsync [ thx to @bynifaciy ]
- [Bugfix] for GetUserAsync
- [Bugfix] for GetDirectInboxThreadAsync

v1.7.0
- [Drop support] for .NETFramework 4.5.2 and .NETStandard 1.3
- [Update] api version to v180.0.0.31.119
- [Update] library to recent changes in Instagram
- [Update] LoginAsync
- [Update] TwoFactorLoginAsync
- [Update] LoginWithFacebookAsync
- [Update] VerifyCodeForChallengeRequireAsync
- [Update] ChangePasswordAsync
- [Update] GetCurrentUserAsync [ thx to @u8989332 ]

v1.6.0
- [Add] support for NETFramework4.6.1
- [Add] GetEncryptedPassword to ExtensionHelper for .NETFramework 4.6.1 or newer and NETStandard 2.0 or newer
- [Add] IRegistrationService and RegistrationService
- [Add] CreateNewAccountWithPhoneNumberAsync to IRegistrationService
- [Add] CreateNewAccountWithEmailAsync to IRegistrationService
- [Add] GenerateRandomBirthday to IRegistrationService
- [Add] GetFirstContactPointPrefillAsync to RegistrationService
- [Add] FirstLauncherSyncAsync to IRegistrationService
- [Add] FirstQeSyncAsync to IRegistrationService
- [Add] CheckUsernameAsync to IRegistrationService
- [Add] InstaCheckEmailRegistration to IRegistrationService
- [Add] CheckEmailAsync to IRegistrationService
- [Add] GetSignupConsentConfigAsync to IRegistrationService
- [Add] SendRegistrationVerifyEmailAsync to IRegistrationService
- [Add] CheckRegistrationConfirmationCodeAsync to IRegistrationService
- [Add] GetSiFetchHeadersAsync to IRegistrationService
- [Add] GetUsernameSuggestionsAsync to IRegistrationService
- [Add] CheckAgeEligibilityAsync to IRegistrationService
- [Add] GetOnboardingStepsAsync to IRegistrationService
- [Add] NewUserFlowBeginsConsentAsync to IRegistrationService
- [Add] GetMultipleAccountsFamilyAsync to IRegistrationService
- [Add] GetZrTokenResultAsync to IRegistrationService
- [Add] LauncherSyncAsync to IRegistrationService
- [Add] QeSyncAsync to IRegistrationService
- [Add] NuxNewAccountSeenAsync to IRegistrationService
- [Add] GetContactPointPrefillAsync to IRegistrationService
- [Add] SmsVerificationCode property to IRegistrationService
- [Add] AccountRegistrationPhoneNumber to IRegistrationService
- [Add] CheckPhoneNumberAsync to IRegistrationService
- [Add] SendSignUpSmsCodeAsync to IRegistrationService
- [Add] VerifySignUpSmsCodeAsync to IRegistrationService

v1.5.0.2
- [Bugfix] Fix ChangeProfilePictureAsync in AccountProcessor [ by @juliendu11 ]
- [Bugfix] for parsing created_at_utc in comments [ by @Anushiravani ]
- [Add] additional error handlers [ by @fatihdumanli ]

v1.5.0.1
- [Bugfix] for adding header

v1.5.0.0
[Update] api version and signature key to v126.0.0.25.121
[Update] Headers and constants
[Update] GetUserTimelineFeedAsync, Constants and some others
[Update] a lot of things related to login and other things
[Add] SendRequestsBeforeLoginAsync to InstaApi
[Add] SendRequestsAfterLoginAsync to InstaApi

v1.4.0.0
- [Add] GetTopicalExploreFeedAsync to FeedProcessor (new explore page)
Supports explore categories, ig tv videos

v1.3.5.0
- [Add] UserTag support in InstaVideoUpload (video upload with user tags)
- [Add] video usertags support for uploading album

v1.3.4.6
- [Bugfix] for slider emoji in story upload
- [Add] CropWidth and CropHeight as parameter for CreateHighlightFeedAsync (thx to @szokeptr)
- [Add] LastPermanentItem property to InstaDirectInboxThread by @estgold
- [Add] RelatedHashtags to GetTopHashtagMediaListAsync
- [Update] GetTopHashtagMediaListAsync
- [Update] GetRecentHashtagMediaListAsync
- [Update] api version to 86.0.0.24.87 (it's default now)

v1.3.4.5
- [Add] GetLoggedInChallengeDataInfoAsync to IInstaApi
- [Add] AcceptChallengeAsync to IInstaApi [THIS IS ME feature] (check #204)
- [Bugfix] for highlights media converter
- [Bugfix] for challenge response for logged in user

v1.3.4.4
- [Bugfix] for login with 2FA enabled (thx to @vivan-snapretail for report)
- [Add] Dashmanifest property for postlive
- [Add] Support Uploading Story Countdown in InstaStoryUploadOptions
- [Add] GetCountdownsStoriesAsync to StoryProcessor
- [Add] FollowCountdownStoryAsync to StoryProcessor
- [Add] UnFollowCountdownStoryAsync to StoryProcessor

v1.3.4.3
- [Bugfix] for BusinessProcessor.GetStatisticsAsync [ by @estgold ]
- [Bugfix] for GetStoryMediaViewersAsync (thx to @tommasoceschia for report)
- [Add] HttpRequestProcessor to IInstaApi
- [Add] GetApiVersionInfo to IInstaApi
- [Add] GetUserAgent to IInstaApi

v1.3.4.2
- [Bugfix] for InstaRecentActivityConverter timestamp for different cultures [ by @estgold ]
- [Bugfix] for media products (thx to @tommasoceschia for report)

v1.3.4.1
- [Bugfix] for UploadStoryPhotoWithUrlAsync
- [Bugfix] for ProductTags (thx to @tommasoceschia for report)
- [Add] some new properties to InstaProduct class
- [Add] support for Questions in InstaStoryUploadOptions
- [Update] facebook login function
- [Update] story slider

v1.3.4.0
- [Add] IWebProcessor to IInstaApi (instagram web api for account data)
- [Add] GetAccountInfoAsync to WebProcessor
- [Add] GetFollowRequestsAsync to WebProcessor
- [Add] GetFormerBiographyTextsAsync to WebProcessor
- [Add] GetFormerBiographyLinksAsync to WebProcessor
- [Add] GetFormerUsernamesAsync to WebProcesor
- [Add] GetFormerFullNamesAsync to WebProcessor
- [Add] GetFormerPhoneNumbersAsync to WebProcessor
- [Add] GetFormerEmailsAsync to WebProcessor

v1.3.3.5
- [Bugfix] for GetDirectInboxThreadAsync pagination (thx to @Hoaas for report)
- [Add] VisualMedia support in direct thread item (check #174 issue) (thx to @aspmaker for report)
- [Add] ActionBlockEnd to ResultInfo (Displaying ActionBlock end date. Used For awaiting liking etc.) (thx to @mihey8800 for PR)
- [Add] Videos property to InstaInboxMedia (direct media item)
- [Update] direct item Users and LeftUsers models class
- [Remove] StartFromId function from PaginationParameters class (use StartFromMaxId instead)

v1.3.3.4
- [Update] InstaUserInfo (thx to @RowanFazio for PR)
- [Change] InstaStory.Items to InstaStoryItem
- [Add] StoryQuestionsResponderInfos property to InstaStoryItem
- [Add] Countdowns property to InstaStoryItem
- [Add] ImportedTakenAt property to InstaStoryItem
- [Add] AnswerToStoryQuestionAsync to StoryProcessor
- [Add] support for Mentions in InstaStoryUploadOptions

v1.3.3.3
- [Bugfix] for GetUserFollowersAsync
- [Bugfix] for GetUserFollowingAsync
- [Rename] GetLocationFeedAsync to GetLocationStoriesAsync
- [Rename] InstaHashtagMediaList to InstaSectionMediaList
- [Add] some new properties to PaginationParameters
- [Add] GetTopLocationFeedsAsync to LocationProcessor
- [Add] GetRecentLocationFeedsAsync to LocationProcessor
- [Add] GetAccountDetailsAsync to BusinessProcessor
- [Update] GetRecentHashtagMediaListAsync pagination
- [Update] GetUserTimelineFeedAsync pull refresh

v1.3.3.2
- [Add] InstaStoryFriendshipStatus class
- [Update] GetStoryFeedAsync
- [Update] GetUserStoryAsync
- [Update] GetFullUserInfoAsync
- [Update] GetFriendshipStatusAsync
- [Update] BlockUserAsync/UnBlockUserAsync
- [Update] IgnoreFriendshipRequestAsync
- [Update] HideMyStoryFromUserAsync/UnHideMyStoryFromUserAsync
- [Update] MuteFriendStoryAsync/UnMuteFriendStoryAsync
- [Update] MuteUserMediaAsync/UnMuteUserMediaAsync
- [Update] FollowUserAsync/UnFollowUserAsync
- [Update] InstaStory.FriendshipStatus (support muting)
- [Update] InstaFullUserInfo.UserDetail.FriendshipStatus
- [Update] InstaStoryFeed.Broadcasts
- [Update] InstaStoryFeed.PostLives
- [Update] InstaReelFeed.FriendshipStatus

v1.3.3.1
- [Add] ShareMediaAsStoryAsync to StoryProcessor
- [Add] HasViewerSaved property to InstaMedia
- [Add] converters for all live broadcast classes
- [Add] pagination to GetDiscoverTopLiveAsync
- [Add] LoginWithFacebookAsync to IInstaApi

v1.3.3.0
- [Bugfix] for followers and followings get functions
- [Bugfix] for SendGetRequestAsync
- [Bugfix] for GetTopHashtagMediaListAsync (thx to @huseyinkarael for report)
- [Bugfix] for GetRecentHashtagMediaListAsync (thx to @huseyinkarael for report)
- [Bugfix] for GetArchivedMediaAsync pagination
- [Bugfix] for GetUserTagsAsync (thx to @hamidrh for bugfix)
- [Rename] GetLikeFeedAsync to GetLikedFeedAsync
- [Rename] SendLikeAsync to SendDirectLikeAsync
- [Add] GetUserFollowersByIdAsync to UserProcessor
- [Add] GetUserFollowingByIdAsync to UserProcessor
- [Add] SaveMediaAsync to MediaProcessor
- [Add] UnSaveMediaAsync to MediaProcessor
- [Add] GetSavedFeedAsync to FeedProcessor
- [Add] support story question in InstaStoryItem
- [Add] GetUserShoppableMediaByIdAsync to ShoppingProcessor
- [Add] GetUserMediaByIdAsync to UserProcessor
- [Add] GetBestFriendsAsync to UserProcessor
- [Add] GetBestFriendsSuggestionsAsync to UserProcessor
- [Add] AddBestFriendsAsync to UserProcessor
- [Add] DeleteBestFriendsAsync to UserProcessor
- [Update] GetUserTagsAsync pagination
- [Update] GetTagFeedAsync pagination
- [Update] GetUserTimelineFeedAsync pagination
- [Update] GetSavedFeedAsync
- [Update] GetLikedFeedAsync pagination
- [Update] GetRecentHashtagMediaListAsync pagination
- [Update] GetTopHashtagMediaListAsync pagination
- [Update] ApproveDirectPendingRequestAsync
- [Update] GetUserShoppableMediaAsync pagination
- [Update] GetUserShoppableMediaAsync pagination