Skip to content

Latest commit

 

History

History
224 lines (170 loc) · 10.2 KB

README.md

File metadata and controls

224 lines (170 loc) · 10.2 KB

InstagramApiSharp 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.1.2 v2.1.2

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 NuGet NuGet downloads
Release master v1.4.0.1 Release

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!!!!

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

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.