Tweets.Actions

Overview

Available Operations

like - Like a Tweet
unlike - Unlike a Tweet
retweet - Retweet a Tweet
unretweet - Delete Retweet
createThread - Create a Tweet Thread
create - Create a Tweet or Reply
quote - Create a Quote Tweet
createWithoutCookie - Post Tweet (Auto Cookie)
bookmark - Bookmark a Tweet
unbookmark - Delete Bookmark
deleteBatch - Delete One or More Tweets

like

Likes a specific tweet on behalf of the user associated with the provided cookie,$0.001 per call.

Example Usage

package hello.world;

import io.twexapi.sdk.XapiScraper;
import io.twexapi.sdk.models.components.LikeActionBody;
import io.twexapi.sdk.models.errors.HTTPValidationError;
import io.twexapi.sdk.models.operations.TweetsActionsLikeRequest;
import io.twexapi.sdk.models.operations.TweetsActionsLikeResponse;
import java.lang.Exception;

public class Application {

    public static void main(String[] args) throws HTTPValidationError, Exception {

        XapiScraper sdk = XapiScraper.builder()
                .bearerAuth(System.getenv().getOrDefault("BEARER_AUTH", ""))
            .build();

        TweetsActionsLikeRequest req = TweetsActionsLikeRequest.builder()
                .tweetId("<id>")
                .body(LikeActionBody.builder()
                    .cookie("ct0=abc123... or 2c4a4e1832096aa694c739b83c83b6d96d43eba7")
                    .proxy("http://username:password@ip:port")
                    .build())
                .build();

        TweetsActionsLikeResponse res = sdk.tweets().actions().like()
                .request(req)
                .call();

        if (res.tweetActionResponse().isPresent()) {
            System.out.println(res.tweetActionResponse().get());
        }
    }
}

Parameters

Parameter	Type	Required	Description
`request`	TweetsActionsLikeRequest	✔️	The request object to use for the request.

Response

TweetsActionsLikeResponse

Errors

Error Type	Status Code	Content Type
models/errors/HTTPValidationError	422	application/json
models/errors/APIException	4XX, 5XX	/

unlike

Unlike a tweet, $0.001 per call.

Example Usage

package hello.world;

import io.twexapi.sdk.XapiScraper;
import io.twexapi.sdk.models.components.UnfavoriteTweetQuery;
import io.twexapi.sdk.models.errors.HTTPValidationError;
import io.twexapi.sdk.models.operations.TweetsActionsUnlikeRequest;
import io.twexapi.sdk.models.operations.TweetsActionsUnlikeResponse;
import java.lang.Exception;

public class Application {

    public static void main(String[] args) throws HTTPValidationError, Exception {

        XapiScraper sdk = XapiScraper.builder()
                .bearerAuth(System.getenv().getOrDefault("BEARER_AUTH", ""))
            .build();

        TweetsActionsUnlikeRequest req = TweetsActionsUnlikeRequest.builder()
                .tweetId("<id>")
                .body(UnfavoriteTweetQuery.builder()
                    .cookie("ct0=abc123... or 2c4a4e1832096aa694c739b83c83b6d96d43eba7")
                    .build())
                .build();

        TweetsActionsUnlikeResponse res = sdk.tweets().actions().unlike()
                .request(req)
                .call();

        if (res.tweetActionResponse().isPresent()) {
            System.out.println(res.tweetActionResponse().get());
        }
    }
}

Parameters

Parameter	Type	Required	Description
`request`	TweetsActionsUnlikeRequest	✔️	The request object to use for the request.

Response

TweetsActionsUnlikeResponse

Errors

Error Type	Status Code	Content Type
models/errors/HTTPValidationError	422	application/json
models/errors/APIException	4XX, 5XX	/

retweet

Retweets a specific tweet on behalf of the user associated with the provided cookie,$0.001 per call.

Example Usage

package hello.world;

import io.twexapi.sdk.XapiScraper;
import io.twexapi.sdk.models.components.RetweetActionBody;
import io.twexapi.sdk.models.errors.HTTPValidationError;
import io.twexapi.sdk.models.operations.TweetsActionsRetweetRequest;
import io.twexapi.sdk.models.operations.TweetsActionsRetweetResponse;
import java.lang.Exception;

public class Application {

    public static void main(String[] args) throws HTTPValidationError, Exception {

        XapiScraper sdk = XapiScraper.builder()
                .bearerAuth(System.getenv().getOrDefault("BEARER_AUTH", ""))
            .build();

        TweetsActionsRetweetRequest req = TweetsActionsRetweetRequest.builder()
                .tweetId("<id>")
                .body(RetweetActionBody.builder()
                    .cookie("ct0=abc123... or 2c4a4e1832096aa694c739b83c83b6d96d43eba7")
                    .proxy("http://username:password@ip:port")
                    .build())
                .build();

        TweetsActionsRetweetResponse res = sdk.tweets().actions().retweet()
                .request(req)
                .call();

        if (res.tweetActionResponse().isPresent()) {
            System.out.println(res.tweetActionResponse().get());
        }
    }
}

Parameters

Parameter	Type	Required	Description
`request`	TweetsActionsRetweetRequest	✔️	The request object to use for the request.

Response

TweetsActionsRetweetResponse

Errors

Error Type	Status Code	Content Type
models/errors/HTTPValidationError	422	application/json
models/errors/APIException	4XX, 5XX	/

unretweet

Delete a retweet, $0.001 per call.

Example Usage

package hello.world;

import io.twexapi.sdk.XapiScraper;
import io.twexapi.sdk.models.components.DeleteRetweetQuery;
import io.twexapi.sdk.models.errors.HTTPValidationError;
import io.twexapi.sdk.models.operations.TweetsActionsUnretweetRequest;
import io.twexapi.sdk.models.operations.TweetsActionsUnretweetResponse;
import java.lang.Exception;

public class Application {

    public static void main(String[] args) throws HTTPValidationError, Exception {

        XapiScraper sdk = XapiScraper.builder()
                .bearerAuth(System.getenv().getOrDefault("BEARER_AUTH", ""))
            .build();

        TweetsActionsUnretweetRequest req = TweetsActionsUnretweetRequest.builder()
                .tweetId("<id>")
                .body(DeleteRetweetQuery.builder()
                    .cookie("ct0=abc123... or 2c4a4e1832096aa694c739b83c83b6d96d43eba7")
                    .build())
                .build();

        TweetsActionsUnretweetResponse res = sdk.tweets().actions().unretweet()
                .request(req)
                .call();

        if (res.tweetActionResponse().isPresent()) {
            System.out.println(res.tweetActionResponse().get());
        }
    }
}

Parameters

Parameter	Type	Required	Description
`request`	TweetsActionsUnretweetRequest	✔️	The request object to use for the request.

Response

TweetsActionsUnretweetResponse

Errors

Error Type	Status Code	Content Type
models/errors/HTTPValidationError	422	application/json
models/errors/APIException	4XX, 5XX	/

createThread

Create a tweet thread from an ordered list of texts, $0.001 per call.

Example Usage

package hello.world;

import io.twexapi.sdk.XapiScraper;
import io.twexapi.sdk.models.components.CreateThreadQuery;
import io.twexapi.sdk.models.errors.HTTPValidationError;
import io.twexapi.sdk.models.operations.TweetsActionsCreateThreadResponse;
import java.lang.Exception;
import java.util.List;

public class Application {

    public static void main(String[] args) throws HTTPValidationError, Exception {

        XapiScraper sdk = XapiScraper.builder()
                .bearerAuth(System.getenv().getOrDefault("BEARER_AUTH", ""))
            .build();

        CreateThreadQuery req = CreateThreadQuery.builder()
                .items(List.of(
                    "1/ hello",
                    "2/ world"))
                .cookie("ct0=abc123... or 2c4a4e1832096aa694c739b83c83b6d96d43eba7")
                .proxy("http://username:password@ip:port")
                .build();

        TweetsActionsCreateThreadResponse res = sdk.tweets().actions().createThread()
                .request(req)
                .call();

        if (res.createThreadResponse().isPresent()) {
            System.out.println(res.createThreadResponse().get());
        }
    }
}

Parameters

Parameter	Type	Required	Description
`request`	CreateThreadQuery	✔️	The request object to use for the request.

Response

TweetsActionsCreateThreadResponse

Errors

Error Type	Status Code	Content Type
models/errors/HTTPValidationError	422	application/json
models/errors/APIException	4XX, 5XX	/

create

Posts a new tweet. To create a reply, provide the reply_tweet_id. This endpoint does not handle quote tweets,$0.001 per call.

Example Usage

package hello.world;

import io.twexapi.sdk.XapiScraper;
import io.twexapi.sdk.models.components.PostTweetQuery;
import io.twexapi.sdk.models.errors.HTTPValidationError;
import io.twexapi.sdk.models.operations.TweetsActionsCreateResponse;
import java.lang.Exception;
import java.util.List;

public class Application {

    public static void main(String[] args) throws HTTPValidationError, Exception {

        XapiScraper sdk = XapiScraper.builder()
                .bearerAuth(System.getenv().getOrDefault("BEARER_AUTH", ""))
            .build();

        PostTweetQuery req = PostTweetQuery.builder()
                .tweetContent("Hello, Twitter! 🐦")
                .cookie("ct0=abc123... or 2c4a4e1832096aa694c739b83c83b6d96d43eba7")
                .mediaUrl("https://example.com/image.jpg")
                .mediaUrls(List.of(
                    "https://example.com/image1.jpg",
                    "https://example.com/image2.jpg"))
                .delegatedAccountUsername("elonmusk")
                .schedule("2024-01-01T12:00:00Z")
                .replyTweetId("1234567890123456789")
                .communityName("Python Developers or 1234567890123456789")
                .proxy("http://username:password@ip:port")
                .build();

        TweetsActionsCreateResponse res = sdk.tweets().actions().create()
                .request(req)
                .call();

        if (res.postTweetResponse().isPresent()) {
            System.out.println(res.postTweetResponse().get());
        }
    }
}

Parameters

Parameter	Type	Required	Description
`request`	PostTweetQuery	✔️	The request object to use for the request.

Response

TweetsActionsCreateResponse

Errors

Error Type	Status Code	Content Type
models/errors/HTTPValidationError	422	application/json
models/errors/APIException	4XX, 5XX	/

quote

Posts a new tweet that quotes an existing tweet. Requires the URL of the tweet to be quoted and the new content,$0.001 per call.

Example Usage

package hello.world;

import io.twexapi.sdk.XapiScraper;
import io.twexapi.sdk.models.components.QuoteTweetQuery;
import io.twexapi.sdk.models.errors.HTTPValidationError;
import io.twexapi.sdk.models.operations.TweetsActionsQuoteResponse;
import java.lang.Exception;
import java.util.List;

public class Application {

    public static void main(String[] args) throws HTTPValidationError, Exception {

        XapiScraper sdk = XapiScraper.builder()
                .bearerAuth(System.getenv().getOrDefault("BEARER_AUTH", ""))
            .build();

        QuoteTweetQuery req = QuoteTweetQuery.builder()
                .tweetContent("Hello, Twitter! 🐦")
                .cookie("ct0=abc123... or 2c4a4e1832096aa694c739b83c83b6d96d43eba7")
                .mediaUrl("https://example.com/image.jpg")
                .mediaUrls(List.of(
                    "https://example.com/image1.jpg",
                    "https://example.com/image2.jpg"))
                .delegatedAccountUsername("elonmusk")
                .communityName("Python Developers or 1234567890123456789")
                .quoteTweetUrl("https://twitter.com/user/status/1234567890123456789")
                .proxy("http://username:password@ip:port")
                .build();

        TweetsActionsQuoteResponse res = sdk.tweets().actions().quote()
                .request(req)
                .call();

        if (res.postTweetResponse().isPresent()) {
            System.out.println(res.postTweetResponse().get());
        }
    }
}

Parameters

Parameter	Type	Required	Description
`request`	QuoteTweetQuery	✔️	The request object to use for the request.

Response

TweetsActionsQuoteResponse

Errors

Error Type	Status Code	Content Type
models/errors/HTTPValidationError	422	application/json
models/errors/APIException	4XX, 5XX	/

createWithoutCookie

Post a tweet using a random cookie from the pool, cookie management $0.001 per call.

Example Usage

package hello.world;

import io.twexapi.sdk.XapiScraper;
import io.twexapi.sdk.models.components.PostTweetWithoutCookieQuery;
import io.twexapi.sdk.models.errors.HTTPValidationError;
import io.twexapi.sdk.models.operations.TweetsActionsCreateWithoutCookieResponse;
import java.lang.Exception;
import java.util.List;

public class Application {

    public static void main(String[] args) throws HTTPValidationError, Exception {

        XapiScraper sdk = XapiScraper.builder()
                .bearerAuth(System.getenv().getOrDefault("BEARER_AUTH", ""))
            .build();

        PostTweetWithoutCookieQuery req = PostTweetWithoutCookieQuery.builder()
                .tweetContent("Hello, Twitter! 🐦")
                .mediaUrl("https://example.com/image.jpg")
                .mediaUrls(List.of(
                    "https://example.com/image1.jpg",
                    "https://example.com/image2.jpg"))
                .schedule("2024-01-01T12:00:00Z")
                .replyTweetId("1234567890123456789")
                .communityName("Python Developers or 1234567890123456789")
                .quoteTweetUrl("https://twitter.com/user/status/1234567890123456789")
                .build();

        TweetsActionsCreateWithoutCookieResponse res = sdk.tweets().actions().createWithoutCookie()
                .request(req)
                .call();

        if (res.postTweetResponse().isPresent()) {
            System.out.println(res.postTweetResponse().get());
        }
    }
}

Parameters

Parameter	Type	Required	Description
`request`	PostTweetWithoutCookieQuery	✔️	The request object to use for the request.

Response

TweetsActionsCreateWithoutCookieResponse

Errors

Error Type	Status Code	Content Type
models/errors/HTTPValidationError	422	application/json
models/errors/APIException	4XX, 5XX	/

bookmark

Adds a specific tweet to the bookmarks of the user associated with the provided cookie,$0.001 per call.

Example Usage

package hello.world;

import io.twexapi.sdk.XapiScraper;
import io.twexapi.sdk.models.components.BookmarkBody;
import io.twexapi.sdk.models.errors.HTTPValidationError;
import io.twexapi.sdk.models.operations.TweetsActionsBookmarkRequest;
import io.twexapi.sdk.models.operations.TweetsActionsBookmarkResponse;
import java.lang.Exception;

public class Application {

    public static void main(String[] args) throws HTTPValidationError, Exception {

        XapiScraper sdk = XapiScraper.builder()
                .bearerAuth(System.getenv().getOrDefault("BEARER_AUTH", ""))
            .build();

        TweetsActionsBookmarkRequest req = TweetsActionsBookmarkRequest.builder()
                .tweetId("<id>")
                .body(BookmarkBody.builder()
                    .cookie("ct0=abc123... or 2c4a4e1832096aa694c739b83c83b6d96d43eba7")
                    .proxy("http://username:password@ip:port")
                    .build())
                .build();

        TweetsActionsBookmarkResponse res = sdk.tweets().actions().bookmark()
                .request(req)
                .call();

        if (res.tweetActionResponse().isPresent()) {
            System.out.println(res.tweetActionResponse().get());
        }
    }
}

Parameters

Parameter	Type	Required	Description
`request`	TweetsActionsBookmarkRequest	✔️	The request object to use for the request.

Response

TweetsActionsBookmarkResponse

Errors

Error Type	Status Code	Content Type
models/errors/HTTPValidationError	422	application/json
models/errors/APIException	4XX, 5XX	/

unbookmark

Delete a bookmark, $0.001 per call.

Example Usage

package hello.world;

import io.twexapi.sdk.XapiScraper;
import io.twexapi.sdk.models.components.DeleteBookmarkQuery;
import io.twexapi.sdk.models.errors.HTTPValidationError;
import io.twexapi.sdk.models.operations.TweetsActionsUnbookmarkRequest;
import io.twexapi.sdk.models.operations.TweetsActionsUnbookmarkResponse;
import java.lang.Exception;

public class Application {

    public static void main(String[] args) throws HTTPValidationError, Exception {

        XapiScraper sdk = XapiScraper.builder()
                .bearerAuth(System.getenv().getOrDefault("BEARER_AUTH", ""))
            .build();

        TweetsActionsUnbookmarkRequest req = TweetsActionsUnbookmarkRequest.builder()
                .tweetId("<id>")
                .body(DeleteBookmarkQuery.builder()
                    .cookie("ct0=abc123... or 2c4a4e1832096aa694c739b83c83b6d96d43eba7")
                    .build())
                .build();

        TweetsActionsUnbookmarkResponse res = sdk.tweets().actions().unbookmark()
                .request(req)
                .call();

        if (res.tweetActionResponse().isPresent()) {
            System.out.println(res.tweetActionResponse().get());
        }
    }
}

Parameters

Parameter	Type	Required	Description
`request`	TweetsActionsUnbookmarkRequest	✔️	The request object to use for the request.

Response

TweetsActionsUnbookmarkResponse

Errors

Error Type	Status Code	Content Type
models/errors/HTTPValidationError	422	application/json
models/errors/APIException	4XX, 5XX	/

deleteBatch

Deletes one or more tweets from a specified user account. This endpoint supports two modes:

Single Tweet Deletion: Provide a target_id to delete a specific tweet.
Bulk Deletion: Omit the target_id to delete all tweets from the user's account.

Warning: The bulk deletion mode is irreversible and will permanently remove all tweets from the account. Use with extreme caution.

Example Usage

package hello.world;

import io.twexapi.sdk.XapiScraper;
import io.twexapi.sdk.models.components.DeleteTweetQuery;
import io.twexapi.sdk.models.errors.HTTPValidationError;
import io.twexapi.sdk.models.operations.TweetsActionsDeleteBatchResponse;
import java.lang.Exception;

public class Application {

    public static void main(String[] args) throws HTTPValidationError, Exception {

        XapiScraper sdk = XapiScraper.builder()
                .bearerAuth(System.getenv().getOrDefault("BEARER_AUTH", ""))
            .build();

        DeleteTweetQuery req = DeleteTweetQuery.builder()
                .cookie("ct0=abc123... or 2c4a4e1832096aa694c739b83c83b6d96d43eba7")
                .username("myusername")
                .targetId("1234567890123456789")
                .build();

        TweetsActionsDeleteBatchResponse res = sdk.tweets().actions().deleteBatch()
                .request(req)
                .call();

        if (res.deleteTweetResponse().isPresent()) {
            System.out.println(res.deleteTweetResponse().get());
        }
    }
}

Parameters

Parameter	Type	Required	Description
`request`	DeleteTweetQuery	✔️	The request object to use for the request.

Response

TweetsActionsDeleteBatchResponse

Errors

Error Type	Status Code	Content Type
models/errors/HTTPValidationError	422	application/json
models/errors/APIException	4XX, 5XX	/

Uh oh!

FilesExpand file tree

README.md

Latest commit

History

README.md

File metadata and controls

Tweets.Actions

Overview

Available Operations

like

Example Usage

Parameters

Response

Errors

unlike

Example Usage

Parameters

Response

Errors

retweet

Example Usage

Parameters

Response

Errors

unretweet

Example Usage

Parameters

Response

Errors

createThread

Example Usage

Parameters

Response

Errors

create

Example Usage

Parameters

Response

Errors

quote

Example Usage

Parameters

Response

Errors

createWithoutCookie

Example Usage

Parameters

Response

Errors

bookmark

Example Usage

Parameters

Response

Errors

unbookmark

Example Usage

Parameters

Response

Errors

deleteBatch

Example Usage

Parameters

Response

Errors