InstagramApiSharp

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

Supports almost every features that Instagram app has!

---

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

Target	Branch	Version	Changelog
Github	master	v2.0.9	v2.0.9

---

InstagramApiSharp's public version - Update date: April 5, 2019 - End Of Support!!!

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

WARNING!!!

Use InstagramApiSharp's free versions at your own risk! I'm not responsible for free versions anymore!!!!

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.4.0.1

• Change license to MIT

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

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

MIT.

Terms and conditions

• Use this Api at your own risk.

Contribute

Feel free to contribute and submit pull requests.

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

Private version

Name	Github	Email	Telegram
Ramtin Jokar	@Ramtinak	[email protected]	https://t.me/ramtinak

Public version - End Of Support

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 | Bahar 1398.