|
1 | 1 |
|
2 | 2 | # EasyInsta
|
3 |
| -This is an android library through which you can use instagram programatically. |
4 |
| -You can say that this is a well optimize, will featured java wrapper of "Instagram graph API". |
5 |
| -You can direct messages, add stories, post photos, scrapping profiles and can do many more things with this library. |
| 3 | +This is an android library through which you can use instagram programatically. You can say that this is a well optimize, will featured java wrapper of "Instagram graph API". You can direct messages, add stories, post photos, scrapping profiles and can do many more things with this library. |
6 | 4 |
|
7 | 5 | 
|
| 6 | + |
8 | 7 | ## Features
|
9 | 8 |
|
10 | 9 | - Lightweight and Easy 2 use
|
@@ -41,12 +40,98 @@ dependencies {
|
41 | 40 | - [API Policies](https://developers.facebook.com/devpolicy/)
|
42 | 41 |
|
43 | 42 |
|
44 |
| -## Documentation |
| 43 | +## API Reference |
45 | 44 |
|
46 |
| -[Java docs]() |
| 45 | +#### Create instagram & callback object |
| 46 | +``` |
| 47 | +Instagram insa = new Instagram("username","password"); |
| 48 | +OnCompleteCallback callback = new OnCompleteCallback() { |
| 49 | + @Override |
| 50 | + public void onSuccess() { |
| 51 | + System.out.println("Operation successful"); |
| 52 | + } |
47 | 53 |
|
| 54 | + @Override |
| 55 | + public void onFailed(Throwable e) { |
| 56 | + e.printStackTrace(); |
| 57 | + System.out.println("Operation failed"); |
| 58 | + } |
| 59 | + }; |
| 60 | +``` |
48 | 61 |
|
49 |
| -## API Reference |
| 62 | +#### Now let's post something... |
| 63 | +``` |
| 64 | +insta.addStory(new File("story.png"),callback); |
| 65 | +insta.post(new File("post.png"),"This is caption",callback); |
| 66 | +``` |
| 67 | + |
| 68 | +#### Send direct message |
| 69 | +``` |
| 70 | +insta.directMessage("x__coder__x","This is message...",null); |
| 71 | +insta.directMessage("x__coder__x",new File("photo.jpg"),callback); |
| 72 | +``` |
| 73 | + |
| 74 | +#### Follow / Unfollow / remove someone |
| 75 | +``` |
| 76 | +insta.follow("username2follow",callback); |
| 77 | +insta.unfollow("username2unfollow",callback); |
| 78 | +insta.removeFollower("username2remove",callback); |
| 79 | +
|
| 80 | +``` |
| 81 | + |
| 82 | +#### Accept or ignore follow request |
| 83 | +``` |
| 84 | +insta.accept("username2accept",null); |
| 85 | +insta.ignore("username2ignore",null); |
| 86 | +``` |
| 87 | + |
| 88 | +#### Get followings / followers / counts |
| 89 | +``` |
| 90 | +List<String> followers = insta.getFollowers("username",callback); |
| 91 | +List<String> followings = insta.getFollowings("username",callback); |
| 92 | +int followersCount = insta.getFollowersCount("username",null); |
| 93 | +int followingCount = insta.getFollowingsCount("username",null); |
| 94 | +int postCount = insta.getPostCount("username",callback); |
| 95 | +``` |
50 | 96 |
|
51 |
| -#### Logs in to instagram account |
| 97 | +#### Get profile metadata |
52 | 98 | ```
|
| 99 | +String bio = insta.getBio("username",callback); |
| 100 | +String url = insta.getProfilePicUrl("username",callback); |
| 101 | +``` |
| 102 | +## Documentation |
| 103 | + |
| 104 | +[Java docs](https://errorxcode.github.io/docs/easyinsta/index.html) |
| 105 | + |
| 106 | + |
| 107 | +## FAQ |
| 108 | + |
| 109 | +#### [Q.1] Can we use this library to make bots ? |
| 110 | + |
| 111 | +Answer. No. Instagram don't allow to make bots with the use of this APIs. |
| 112 | + |
| 113 | +#### [Q.2] Can we use this to download stories or posts ? |
| 114 | + |
| 115 | +Answer. Yes. But its not currently supported. |
| 116 | + |
| 117 | +#### [Q.3] Does use of this library requires any tokens or other things ? |
| 118 | + |
| 119 | +Answer. No. You only need to have username and password of the account. |
| 120 | + |
| 121 | +#### [Q.4] Can we log in two-factor-authenticated accounts ? |
| 122 | + |
| 123 | +Answer. Yes. Just pass a callback as thired argument while initializing the class. |
| 124 | + |
| 125 | + |
| 126 | + |
| 127 | +## Contributing |
| 128 | + |
| 129 | +Contributions are always welcome! Please make a pull request regarding any modification or feature request. |
| 130 | + |
| 131 | + |
| 132 | +## Support |
| 133 | + |
| 134 | +For support, follow us on [instagram](https://www.instagram.com/andro.developer). |
| 135 | + Also subscribe our [youtube](https://www.youtube.com/channel/UCcQS2F6LXAyuE_RXoIQxkMA) channel. |
| 136 | + It would be nice if you give this repo a star. |
| 137 | + |
0 commit comments