Social

X/Twitter Giveaway Draws

Run a provably fair giveaway on X/Twitter: pick crypto-random winners from a tweet's replies, with retweet, follow, hashtag, keyword, minimum-follower, and account-age conditions. Fixed price set upfront from your estimated entry count.

post/api/tools/draws

Request

  • Base URL: https://twitr.sh
  • URL: https://twitr.sh/api/tools/draws
  • 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

tweetUrlstring required

Full tweet URL (https://x.com/user/status/ID).

winnerCountinteger
backupCountinteger
uniqueAuthorsOnlyboolean
mustRetweetboolean
mustFollowUsernamestring
filterMinFollowersinteger
filterAccountAgeDaysinteger
filterLanguagestring
requiredHashtagsstring[]
requiredKeywordsstring[]
requiredMentionsstring[]
estimatedEntriesinteger

Expected replies inspected — drives the fixed price (default 1000).

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.