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

declare(strict_types=1);

require 'vendor/autoload.php';

use XapiScraper;
use XapiScraper\Models\Components;
use XapiScraper\Models\Operations;

$sdk = XapiScraper\XapiScraper::builder()
    ->setSecurity(
        '<YOUR_BEARER_TOKEN_HERE>'
    )
    ->build();

$request = new Operations\TweetsActionsLikeRequest(
    tweetId: '<id>',
    body: new Components\LikeActionBody(
        cookie: 'ct0=abc123... or 2c4a4e1832096aa694c739b83c83b6d96d43eba7',
        proxy: 'http://username:password@ip:port',
    ),
);

$response = $sdk->tweets->actions->like(
    request: $request
);

if ($response->tweetActionResponse !== null) {
    // handle response
}

Parameters

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

Response

?Operations\TweetsActionsLikeResponse

Errors

Error Type	Status Code	Content Type
Errors\HTTPValidationError	422	application/json
Errors\APIException	4XX, 5XX	/

unlike

Unlike a tweet, $0.001 per call.

Example Usage

declare(strict_types=1);

require 'vendor/autoload.php';

use XapiScraper;
use XapiScraper\Models\Components;
use XapiScraper\Models\Operations;

$sdk = XapiScraper\XapiScraper::builder()
    ->setSecurity(
        '<YOUR_BEARER_TOKEN_HERE>'
    )
    ->build();

$request = new Operations\TweetsActionsUnlikeRequest(
    tweetId: '<id>',
    body: new Components\UnfavoriteTweetQuery(
        cookie: 'ct0=abc123... or 2c4a4e1832096aa694c739b83c83b6d96d43eba7',
    ),
);

$response = $sdk->tweets->actions->unlike(
    request: $request
);

if ($response->tweetActionResponse !== null) {
    // handle response
}

Parameters

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

Response

?Operations\TweetsActionsUnlikeResponse

Errors

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

declare(strict_types=1);

require 'vendor/autoload.php';

use XapiScraper;
use XapiScraper\Models\Components;
use XapiScraper\Models\Operations;

$sdk = XapiScraper\XapiScraper::builder()
    ->setSecurity(
        '<YOUR_BEARER_TOKEN_HERE>'
    )
    ->build();

$request = new Operations\TweetsActionsRetweetRequest(
    tweetId: '<id>',
    body: new Components\RetweetActionBody(
        cookie: 'ct0=abc123... or 2c4a4e1832096aa694c739b83c83b6d96d43eba7',
        proxy: 'http://username:password@ip:port',
    ),
);

$response = $sdk->tweets->actions->retweet(
    request: $request
);

if ($response->tweetActionResponse !== null) {
    // handle response
}

Parameters

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

Response

?Operations\TweetsActionsRetweetResponse

Errors

Error Type	Status Code	Content Type
Errors\HTTPValidationError	422	application/json
Errors\APIException	4XX, 5XX	/

unretweet

Delete a retweet, $0.001 per call.

Example Usage

declare(strict_types=1);

require 'vendor/autoload.php';

use XapiScraper;
use XapiScraper\Models\Components;
use XapiScraper\Models\Operations;

$sdk = XapiScraper\XapiScraper::builder()
    ->setSecurity(
        '<YOUR_BEARER_TOKEN_HERE>'
    )
    ->build();

$request = new Operations\TweetsActionsUnretweetRequest(
    tweetId: '<id>',
    body: new Components\DeleteRetweetQuery(
        cookie: 'ct0=abc123... or 2c4a4e1832096aa694c739b83c83b6d96d43eba7',
    ),
);

$response = $sdk->tweets->actions->unretweet(
    request: $request
);

if ($response->tweetActionResponse !== null) {
    // handle response
}

Parameters

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

Response

?Operations\TweetsActionsUnretweetResponse

Errors

Error Type	Status Code	Content Type
Errors\HTTPValidationError	422	application/json
Errors\APIException	4XX, 5XX	/

createThread

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

Example Usage

declare(strict_types=1);

require 'vendor/autoload.php';

use XapiScraper;
use XapiScraper\Models\Components;

$sdk = XapiScraper\XapiScraper::builder()
    ->setSecurity(
        '<YOUR_BEARER_TOKEN_HERE>'
    )
    ->build();

$request = new Components\CreateThreadQuery(
    items: [
        '1/ hello',
        '2/ world',
    ],
    cookie: 'ct0=abc123... or 2c4a4e1832096aa694c739b83c83b6d96d43eba7',
    proxy: 'http://username:password@ip:port',
);

$response = $sdk->tweets->actions->createThread(
    request: $request
);

if ($response->createThreadResponse !== null) {
    // handle response
}

Parameters

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

Response

?Operations\TweetsActionsCreateThreadResponse

Errors

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

declare(strict_types=1);

require 'vendor/autoload.php';

use XapiScraper;
use XapiScraper\Models\Components;

$sdk = XapiScraper\XapiScraper::builder()
    ->setSecurity(
        '<YOUR_BEARER_TOKEN_HERE>'
    )
    ->build();

$request = new Components\PostTweetQuery(
    mediaUrl: 'https://example.com/image.jpg',
    mediaUrls: [
        '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',
);

$response = $sdk->tweets->actions->create(
    request: $request
);

if ($response->postTweetResponse !== null) {
    // handle response
}

Parameters

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

Response

?Operations\TweetsActionsCreateResponse

Errors

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

declare(strict_types=1);

require 'vendor/autoload.php';

use XapiScraper;
use XapiScraper\Models\Components;

$sdk = XapiScraper\XapiScraper::builder()
    ->setSecurity(
        '<YOUR_BEARER_TOKEN_HERE>'
    )
    ->build();

$request = new Components\QuoteTweetQuery(
    mediaUrl: 'https://example.com/image.jpg',
    mediaUrls: [
        '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',
);

$response = $sdk->tweets->actions->quote(
    request: $request
);

if ($response->postTweetResponse !== null) {
    // handle response
}

Parameters

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

Response

?Operations\TweetsActionsQuoteResponse

Errors

Error Type	Status Code	Content Type
Errors\HTTPValidationError	422	application/json
Errors\APIException	4XX, 5XX	/

createWithoutCookie

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

Example Usage

declare(strict_types=1);

require 'vendor/autoload.php';

use XapiScraper;
use XapiScraper\Models\Components;

$sdk = XapiScraper\XapiScraper::builder()
    ->setSecurity(
        '<YOUR_BEARER_TOKEN_HERE>'
    )
    ->build();

$request = new Components\PostTweetWithoutCookieQuery(
    mediaUrl: 'https://example.com/image.jpg',
    mediaUrls: [
        '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',
);

$response = $sdk->tweets->actions->createWithoutCookie(
    request: $request
);

if ($response->postTweetResponse !== null) {
    // handle response
}

Parameters

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

Response

?Operations\TweetsActionsCreateWithoutCookieResponse

Errors

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

declare(strict_types=1);

require 'vendor/autoload.php';

use XapiScraper;
use XapiScraper\Models\Components;
use XapiScraper\Models\Operations;

$sdk = XapiScraper\XapiScraper::builder()
    ->setSecurity(
        '<YOUR_BEARER_TOKEN_HERE>'
    )
    ->build();

$request = new Operations\TweetsActionsBookmarkRequest(
    tweetId: '<id>',
    body: new Components\BookmarkBody(
        proxy: 'http://username:password@ip:port',
        cookie: 'ct0=abc123... or 2c4a4e1832096aa694c739b83c83b6d96d43eba7',
    ),
);

$response = $sdk->tweets->actions->bookmark(
    request: $request
);

if ($response->tweetActionResponse !== null) {
    // handle response
}

Parameters

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

Response

?Operations\TweetsActionsBookmarkResponse

Errors

Error Type	Status Code	Content Type
Errors\HTTPValidationError	422	application/json
Errors\APIException	4XX, 5XX	/

unbookmark

Delete a bookmark, $0.001 per call.

Example Usage

declare(strict_types=1);

require 'vendor/autoload.php';

use XapiScraper;
use XapiScraper\Models\Components;
use XapiScraper\Models\Operations;

$sdk = XapiScraper\XapiScraper::builder()
    ->setSecurity(
        '<YOUR_BEARER_TOKEN_HERE>'
    )
    ->build();

$request = new Operations\TweetsActionsUnbookmarkRequest(
    tweetId: '<id>',
    body: new Components\DeleteBookmarkQuery(
        cookie: 'ct0=abc123... or 2c4a4e1832096aa694c739b83c83b6d96d43eba7',
    ),
);

$response = $sdk->tweets->actions->unbookmark(
    request: $request
);

if ($response->tweetActionResponse !== null) {
    // handle response
}

Parameters

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

Response

?Operations\TweetsActionsUnbookmarkResponse

Errors

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

declare(strict_types=1);

require 'vendor/autoload.php';

use XapiScraper;
use XapiScraper\Models\Components;

$sdk = XapiScraper\XapiScraper::builder()
    ->setSecurity(
        '<YOUR_BEARER_TOKEN_HERE>'
    )
    ->build();

$request = new Components\DeleteTweetQuery(
    cookie: 'ct0=abc123... or 2c4a4e1832096aa694c739b83c83b6d96d43eba7',
    username: 'myusername',
    targetId: '1234567890123456789',
);

$response = $sdk->tweets->actions->deleteBatch(
    request: $request
);

if ($response->deleteTweetResponse !== null) {
    // handle response
}

Parameters

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

Response

?Operations\TweetsActionsDeleteBatchResponse

Errors

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