InstagramApiSharp

A complete Private Instagram API for .NET (C#, VB.NET).

Supports almost every features that Instagram app has!

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

IMPORTANT NOTE:

PaginationParameters updated, you must use NextMaxId instead of using old NextId!!!!!

Note

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

Install

Use this library as dll (download from release page) or reference it from NuGet.

Nuget package manager command:

PM> Install-Package InstagramApiSharp

Note: this library uses Json.NET v10.0.3 and above for serialize and deserialize json.

Cross Platform

Platform	Supported Version
.NET Framework	4.5.2
.NET Standard	1.3
.NET Standard	2.0
.NET Core(UWP)	10.0.10240

Donation

Paypal: Donate

Overview

There are a lot of features and bug fix me and NGame1 and other contributors added to this library. Check sample projects and wiki pages to see how it's works.

Features

Some of features:

Login	Login with cookies	Logout	Create new account email/phone number
Edit profile	Change/remove profile picture	Story settings	Get user explore feed
Get user timeline feed	Get all user media by username	Get media by its id	Get user info by its username
Get current user info	Get tag feed by tag value	Get current user media	Get followers list
Get followers list for logged in user	Get following list	Get recent following activity	Get user tags by username
Get direct mailbox	Get recent recipients	Get ranked recipients	Get inbox thread
Get recent activity	Like media	Unlike media	Follow user
Unfollow user	Set account private	Set account public	Send comment
Delete comment	Upload photo	Upload video	Get followings list
Delete media (photo/video/album)	Upload story (photo/video/album)	Change password	Send direct message
Search location	Get location feed	Collection create/get by id/get all/add items	Support challenge required
Upload album (videos/photo)	Highlight support	Share story	Send direct photo/video/ stories/profile/ link/location like/live
IG TV support	Share media to direct thread	Business account support	Share media as story

Usage

Use builder to get Insta API instance:

var api = InstaApiBuilder.CreateBuilder()
                // required
                .SetUser(new UserSessionData(...Your user...))
                // optional
                .UseLogger(new SomeLogger())
                // optional
                .UseHttpClient(new SomeHttpClient())
                // optional
                .UseHttpClientHandler(httpHandlerWithSomeProxy)
                // optional
                .SetRequestDelay(new SomeRequestDelay())
                // optional
                .SetApiVersion(SomeApiVersion)
                .Build();

Note: every API method has synchronous implementation as well.

Important note about me (@ramtinak)

I don't use Instagram at all and I don't like it either, so when you across to an issue or wanna new feature, describe it as much as you can!

Contract, warning, note

Every method returns object IS NOT COMPLETED YET! For example:

Task<IResult<object>>

Wiki

Check Wiki pages for documentation.

Version changes

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

Version changes page

Known Issues

Nothing!!!!

InstaPost app.

You can download source code or app from InstaPost github page.

Note: InstaPost app is just an old example that uses InstagramApiSharp v1.1.5.2 which is very old version!!! Some of codes may not working well or even deprecated in new InstagramApiSharp versions. I suggest you to update library to the latest nuget version or use latest release package and update InstaPost codes that is not working or deprecated

Language

You can ask questions or report issues in Persian or English language. I can't answer to other languages, because I don't understand them.

License

Do whatever you want to do! Except changing library name!!!!

Terms and conditions

• Use this Api at your own risk.

Contribute

Feel free to contribute and submit pull requests.

Thanks

Special thanks to all 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

Name	Github	Email	Telegram	Instagram
Ramtin Jokar	@Ramtinak	[email protected]	-	-
Ali Noshahi	@NGame1	[email protected]	https://t.me/NGameW	https://instagram.com/alingame

Iranian developers - (c) 2019 | Tabestan - Zemestan 1397.