Intelligence

X/Twitter Bulk Export

Bulk-export X/Twitter data as downloadable datasets: followers, following, repliers, quoters, reposters, likers, mentions, full threads, list and community members, spaces, or people/tweet search results — 23 extractors. Runs async: you get a claim check immediately and poll a free status URL for the download link. Billed per result.

post/api/tools/x_extract

Request

  • Base URL: https://twitr.sh
  • URL: https://twitr.sh/api/tools/x_extract
  • Auth: none declared. Required headers: Idempotency-Key

Headers

Idempotency-Keystring required

Unique key per logical action. A retry with the same key replays the original result (10-minute window) instead of acting or charging twice.

Request body

tool'follower_explorer' | 'following_explorer' | 'verified_follower_explorer' | 'post_extractor' | 'reply_extractor' | 'repost_extractor' | 'quote_extractor' | 'thread_extractor' | 'article_extractor' | 'favoriters' | 'mention_extractor' | 'user_likes' | 'user_media' | 'community_extractor' | 'community_moderator_explorer' | 'community_post_extractor' | 'community_search' | 'list_member_extractor' | 'list_post_extractor' | 'list_follower_explorer' | 'space_explorer' | 'people_search' | 'tweet_search_extractor' required

Which extractor to run.

resultsLimitinteger required

MANDATORY: max results extracted, billed per result.

targetTweetIdstring
targetUsernamestring
targetCommunityIdstring
targetListIdstring
targetSpaceIdstring
searchQuerystring
languagestring
sinceDatestring
untilDatestring
mediaType'images' | 'videos' | 'gifs' | 'media'
minFavesinteger
verifiedOnlyboolean

Response

Result dataset.

itemsobject[] required

Array of returned items. Shape varies per tool — see each tool's documentation.

runIdstring

Run ID for debugging/audit.

durationinteger

Run duration in seconds.

Changes

No recorded changes to this operation across all 1 revision of this API.