errorxcode / jxinsta Goto Github PK

An object-oriented reverse engineered instagram web API made in Java. Now build bots, scrap data, create instagram apps, and a lot more in your favourite language

License: Apache License 2.0

Java 100.00%

easyinsta instagram-api instagram-bot instagram-private-api instagram4j insatgram-java-client jxinsta

jxinsta's Introduction

JxInsta

A java library of Instagram private web API (may include mobile api in future). This library is built as a replacement for instagram4j since it was too old fashioned and was facing a challenge problem due to a similar header population problem among it's users. This project is lead by EasyInsta and is part of it.

Features

Lightweight and Easy 2 use, Object-oriented
No need API token
Supports Sending messages
Supports Getting/fetching messages
Supports Deleting message
Supports Realtime direct messages listener (Pending)
Supports Login using cache/saving sessions
Supports Posting (Picture)
Supports Adding stories (Photo)
Supports Following/Unfollowing
Supports Acception/Ignoring follow request (Pending)
Supports Scrapping followings and followers
Supports Getting profile data
Supports Liking/commenting on post
Supports Fetching feeds/timeline post
Supports Downloading posts and pfp

Implimentation

Due to the outage of jitpack, the library cannot published. Therfore, you have to locally implement it by puting the .jar file in the lib directory.

Step 1 : Download the `.jar` from the release section and put it in `lib` folder of your project.

Step 2 : declare the dependency

For gradle

dependencies {
    implementation files('libs/JxInsta-v1.0-beta.jar')
    implementation group: 'com.squareup.okhttp3', name: 'okhttp', version: '5.0.0-alpha.11' //skip if already implemented
}

For maven

<dependency>
    <groupId>com.sample</groupId>
    <artifactId>jxinsta</artifactId>
    <version>v1.0-beta-2</version>
    <scope>system</scope>
    <systemPath>${project.basedir}/lib/JxInsta-v1.0-beta-2.jar</systemPath>
</dependency>

<dependency>
    <groupId>com.squareup.okhttp3</groupId>
    <artifactId>okhttp</artifactId>
    <version>5.0.0-alpha.11</version>
</dependency>

You can search on Google for more info on including local dependencies.

Acknowledgements

Its easy :)

JxInsta insta = new JxInsta("username", "password", JxInsta.LoginType.WEB_AUTHENTICATION);  
insta.uploadStory(new File("photos/story-24.png"));  
var profile = insta.getProfile("username").;
...

Documentation

~~Javadoc~~ (Not needed)

User guide

FAQ

[Q.1] Can we use this library to make bots?

Answer. Yes. But Instagram doesn't allow them to make bots with their official graph APIs. Although this is not the official API, you should follow the usage limits to prevent detection.

[Q.2] Can we download stories or posts using this library?

Answer. Yes, and that too without login

[Q.3] Does the use of this library require any tokens or other keys?

Answer. No. You only need to have the username and password of the account. You can also log in using cookies and bearer tokens.

[Q.4] In Android, can we use Webview to log in?

Answer. Yes, check this example on how to use that

Contributing

Contributions are always welcome! There is a lot of scope for contribution in this library.

Please refer to Contribution guide. Also, see the code of conduct. Please see Todo. md to see what features are pending and what things you can add on your end.

Support

The fastest channel to contact me is Instagram, just DM me and I'll reply to you within 24 hours. My Instagram : x0.rahil

You can show your support by giving a ⭐.

jxinsta's People

Contributors

Stargazers

Watchers

Forkers

syedhilalhusain ncovercash atpanos adriaesteve litavox

jxinsta's Issues

PublicAPIs.getPosts got an Rate limited error

Hello,
Is there a way to get all posts of a user without logging in?
Rate limited error is always returned when I call PublicAPIs.getPosts(pk, next_cursor) method.

How to create a Thread

We can send messages to someone through threadid, but if I have never sent a message to that person before, how should I create a conversation with them to get the threadid?

Please make it work with Java8

Hello.
I tried this library and found it very nice!

By the way, I wanna use this library in my Java8 project. so please make this work with Java8.
Thank you.

I checked your code and found that the login api did not encrypt the password, but I found that the ins login password of the current webpage was encrypted

    var encPassword = "#PWD_INSTAGRAM_BROWSER:0:" + new Date().getTime() + ":" + password;

I checked your code and found that the login api did not encrypt the password, but I found that the ins login password of the current webpage was encrypted

error: cannot access PublicAPIs

I tried to add libs like this:

<dependency>
            <groupId>com.errorxcode.jxinsta</groupId>
            <artifactId>jxinsta</artifactId>
            <version>v1.0-beta-2</version>
            <scope>system</scope>
            <systemPath>${project.basedir}/JxInsta-v1.0-beta-2.jar</systemPath>
</dependency>

im using netbeans and java 1.8, but it always return error cannot access PublicAPIs when run the project.
Look like it not work with local dependency , please help

updated: when i try with Ant and add the Jar file
Exception in thread "main" java.lang.UnsupportedClassVersionError: com/errorxcode/jxinsta/endpoints/PublicAPIs has been compiled by a more recent version of the Java Runtime (class file version 61.0), this version of the Java Runtime only recognizes class file versions up to 52.0

how to create a group

Hello, may I ask how to create a group and send messages within it

Handle is missing error when posting picture.

Error while trying to post a picture. Error message and example code are below.

Library Version: JxInsta-v1.0-beta-2.jar
Java Version: 17

{"debug_info":{"retriable":false,"type":"ProcessingFailedError","message":"{\"message\":\"Handle is missing.\",\"status\":\"fail\"}"}}

 val insta = JxInsta("myhandle", "mypassword", JxInsta.LoginType.BOTH_WEB_AND_APP_AUTHENTICATION)
    val url = URL("PATH_TO_IMAGE")
    val imageData: ByteArray = url.readBytes()
    insta.postPicture(
        ByteArrayInputStream(imageData),
        "This is a caption",
        false
    )

Library not on jitpack

After I got an official response from Instagram4J's creator, I decided to migrate my project to use this library.
However, I have a few questions before I even write the first line of code:

Why do I also need to add the OkHttp dependency - why isn't it included in the artifact?
I read the README and I'm not sure which outages you're talking about, Jitpack works great and I use it in all of my projects -
I highly recommend posting Jitpack dependencies.

Acces token

Does this coding want acces token for instagram.

Upload video/reels

Is it possible to upload videos and or reels through this api?

And if not, will it be possible?