Skip to content

Latest commit

 

History

History
520 lines (361 loc) · 27.7 KB

File metadata and controls

520 lines (361 loc) · 27.7 KB

Tweets.Actions

Overview

Available Operations

Like

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

Example Usage

using XapiScraper;
using XapiScraper.Models.Components;
using XapiScraper.Models.Requests;

var sdk = new XapiScraperSDK(bearerAuth: "<YOUR_BEARER_TOKEN_HERE>");

TweetsActionsLikeRequest req = new TweetsActionsLikeRequest() {
    TweetId = "<id>",
    Body = new LikeActionBody() {
        Cookie = "ct0=abc123... or 2c4a4e1832096aa694c739b83c83b6d96d43eba7",
        Proxy = "http://username:password@ip:port",
    },
};

var res = await sdk.Tweets.Actions.LikeAsync(req);

// handle response

Parameters

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

Response

TweetsActionsLikeResponse

Errors

Error Type Status Code Content Type
XapiScraper.Models.Errors.HTTPValidationError 422 application/json
XapiScraper.Models.Errors.APIException 4XX, 5XX */*

Unlike

Unlike a tweet, $0.001 per call.

Example Usage

using XapiScraper;
using XapiScraper.Models.Components;
using XapiScraper.Models.Requests;

var sdk = new XapiScraperSDK(bearerAuth: "<YOUR_BEARER_TOKEN_HERE>");

TweetsActionsUnlikeRequest req = new TweetsActionsUnlikeRequest() {
    TweetId = "<id>",
    Body = new UnfavoriteTweetQuery() {
        Cookie = "ct0=abc123... or 2c4a4e1832096aa694c739b83c83b6d96d43eba7",
    },
};

var res = await sdk.Tweets.Actions.UnlikeAsync(req);

// handle response

Parameters

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

Response

TweetsActionsUnlikeResponse

Errors

Error Type Status Code Content Type
XapiScraper.Models.Errors.HTTPValidationError 422 application/json
XapiScraper.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

using XapiScraper;
using XapiScraper.Models.Components;
using XapiScraper.Models.Requests;

var sdk = new XapiScraperSDK(bearerAuth: "<YOUR_BEARER_TOKEN_HERE>");

TweetsActionsRetweetRequest req = new TweetsActionsRetweetRequest() {
    TweetId = "<id>",
    Body = new RetweetActionBody() {
        Cookie = "ct0=abc123... or 2c4a4e1832096aa694c739b83c83b6d96d43eba7",
        Proxy = "http://username:password@ip:port",
    },
};

var res = await sdk.Tweets.Actions.RetweetAsync(req);

// handle response

Parameters

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

Response

TweetsActionsRetweetResponse

Errors

Error Type Status Code Content Type
XapiScraper.Models.Errors.HTTPValidationError 422 application/json
XapiScraper.Models.Errors.APIException 4XX, 5XX */*

Unretweet

Delete a retweet, $0.001 per call.

Example Usage

using XapiScraper;
using XapiScraper.Models.Components;
using XapiScraper.Models.Requests;

var sdk = new XapiScraperSDK(bearerAuth: "<YOUR_BEARER_TOKEN_HERE>");

TweetsActionsUnretweetRequest req = new TweetsActionsUnretweetRequest() {
    TweetId = "<id>",
    Body = new DeleteRetweetQuery() {
        Cookie = "ct0=abc123... or 2c4a4e1832096aa694c739b83c83b6d96d43eba7",
    },
};

var res = await sdk.Tweets.Actions.UnretweetAsync(req);

// handle response

Parameters

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

Response

TweetsActionsUnretweetResponse

Errors

Error Type Status Code Content Type
XapiScraper.Models.Errors.HTTPValidationError 422 application/json
XapiScraper.Models.Errors.APIException 4XX, 5XX */*

CreateThread

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

Example Usage

using System.Collections.Generic;
using XapiScraper;
using XapiScraper.Models.Components;

var sdk = new XapiScraperSDK(bearerAuth: "<YOUR_BEARER_TOKEN_HERE>");

CreateThreadQuery req = new CreateThreadQuery() {
    Items = new List<string>() {
        "1/ hello",
        "2/ world",
    },
    Cookie = "ct0=abc123... or 2c4a4e1832096aa694c739b83c83b6d96d43eba7",
    Proxy = "http://username:password@ip:port",
};

var res = await sdk.Tweets.Actions.CreateThreadAsync(req);

// handle response

Parameters

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

Response

TweetsActionsCreateThreadResponse

Errors

Error Type Status Code Content Type
XapiScraper.Models.Errors.HTTPValidationError 422 application/json
XapiScraper.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

using System.Collections.Generic;
using XapiScraper;
using XapiScraper.Models.Components;

var sdk = new XapiScraperSDK(bearerAuth: "<YOUR_BEARER_TOKEN_HERE>");

PostTweetQuery req = new PostTweetQuery() {
    MediaUrl = "https://example.com/image.jpg",
    MediaUrls = new List<string>() {
        "https://example.com/image1.jpg",
        "https://example.com/image2.jpg",
    },
    TweetContent = "Hello, Twitter! 🐦",
    DelegatedAccountUsername = "elonmusk",
    Schedule = "2024-01-01T12:00:00Z",
    ReplyTweetId = "1234567890123456789",
    Cookie = "ct0=abc123... or 2c4a4e1832096aa694c739b83c83b6d96d43eba7",
    CommunityName = "Python Developers or 1234567890123456789",
    Proxy = "http://username:password@ip:port",
};

var res = await sdk.Tweets.Actions.CreateAsync(req);

// handle response

Parameters

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

Response

TweetsActionsCreateResponse

Errors

Error Type Status Code Content Type
XapiScraper.Models.Errors.HTTPValidationError 422 application/json
XapiScraper.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

using System.Collections.Generic;
using XapiScraper;
using XapiScraper.Models.Components;

var sdk = new XapiScraperSDK(bearerAuth: "<YOUR_BEARER_TOKEN_HERE>");

QuoteTweetQuery req = new QuoteTweetQuery() {
    MediaUrl = "https://example.com/image.jpg",
    MediaUrls = new List<string>() {
        "https://example.com/image1.jpg",
        "https://example.com/image2.jpg",
    },
    TweetContent = "Hello, Twitter! 🐦",
    DelegatedAccountUsername = "elonmusk",
    Cookie = "ct0=abc123... or 2c4a4e1832096aa694c739b83c83b6d96d43eba7",
    CommunityName = "Python Developers or 1234567890123456789",
    QuoteTweetUrl = "https://twitter.com/user/status/1234567890123456789",
    Proxy = "http://username:password@ip:port",
};

var res = await sdk.Tweets.Actions.QuoteAsync(req);

// handle response

Parameters

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

Response

TweetsActionsQuoteResponse

Errors

Error Type Status Code Content Type
XapiScraper.Models.Errors.HTTPValidationError 422 application/json
XapiScraper.Models.Errors.APIException 4XX, 5XX */*

CreateWithoutCookie

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

Example Usage

using System.Collections.Generic;
using XapiScraper;
using XapiScraper.Models.Components;

var sdk = new XapiScraperSDK(bearerAuth: "<YOUR_BEARER_TOKEN_HERE>");

PostTweetWithoutCookieQuery req = new PostTweetWithoutCookieQuery() {
    MediaUrl = "https://example.com/image.jpg",
    MediaUrls = new List<string>() {
        "https://example.com/image1.jpg",
        "https://example.com/image2.jpg",
    },
    TweetContent = "Hello, Twitter! 🐦",
    Schedule = "2024-01-01T12:00:00Z",
    ReplyTweetId = "1234567890123456789",
    CommunityName = "Python Developers or 1234567890123456789",
    QuoteTweetUrl = "https://twitter.com/user/status/1234567890123456789",
};

var res = await sdk.Tweets.Actions.CreateWithoutCookieAsync(req);

// handle response

Parameters

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

Response

TweetsActionsCreateWithoutCookieResponse

Errors

Error Type Status Code Content Type
XapiScraper.Models.Errors.HTTPValidationError 422 application/json
XapiScraper.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

using XapiScraper;
using XapiScraper.Models.Components;
using XapiScraper.Models.Requests;

var sdk = new XapiScraperSDK(bearerAuth: "<YOUR_BEARER_TOKEN_HERE>");

TweetsActionsBookmarkRequest req = new TweetsActionsBookmarkRequest() {
    TweetId = "<id>",
    Body = new BookmarkBody() {
        Proxy = "http://username:password@ip:port",
        Cookie = "ct0=abc123... or 2c4a4e1832096aa694c739b83c83b6d96d43eba7",
    },
};

var res = await sdk.Tweets.Actions.BookmarkAsync(req);

// handle response

Parameters

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

Response

TweetsActionsBookmarkResponse

Errors

Error Type Status Code Content Type
XapiScraper.Models.Errors.HTTPValidationError 422 application/json
XapiScraper.Models.Errors.APIException 4XX, 5XX */*

Unbookmark

Delete a bookmark, $0.001 per call.

Example Usage

using XapiScraper;
using XapiScraper.Models.Components;
using XapiScraper.Models.Requests;

var sdk = new XapiScraperSDK(bearerAuth: "<YOUR_BEARER_TOKEN_HERE>");

TweetsActionsUnbookmarkRequest req = new TweetsActionsUnbookmarkRequest() {
    TweetId = "<id>",
    Body = new DeleteBookmarkQuery() {
        Cookie = "ct0=abc123... or 2c4a4e1832096aa694c739b83c83b6d96d43eba7",
    },
};

var res = await sdk.Tweets.Actions.UnbookmarkAsync(req);

// handle response

Parameters

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

Response

TweetsActionsUnbookmarkResponse

Errors

Error Type Status Code Content Type
XapiScraper.Models.Errors.HTTPValidationError 422 application/json
XapiScraper.Models.Errors.APIException 4XX, 5XX */*

DeleteBatch

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

  1. Single Tweet Deletion: Provide a target_id to delete a specific tweet.
  2. 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

using XapiScraper;
using XapiScraper.Models.Components;

var sdk = new XapiScraperSDK(bearerAuth: "<YOUR_BEARER_TOKEN_HERE>");

DeleteTweetQuery req = new DeleteTweetQuery() {
    Cookie = "ct0=abc123... or 2c4a4e1832096aa694c739b83c83b6d96d43eba7",
    Username = "myusername",
    TargetId = "1234567890123456789",
};

var res = await sdk.Tweets.Actions.DeleteBatchAsync(req);

// handle response

Parameters

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

Response

TweetsActionsDeleteBatchResponse

Errors

Error Type Status Code Content Type
XapiScraper.Models.Errors.HTTPValidationError 422 application/json
XapiScraper.Models.Errors.APIException 4XX, 5XX */*