Sign in
Draws

Run giveaway draw

post/draws

Request body

tweetUrlstring uri required
winnerCountinteger
backupCountinteger
uniqueAuthorsOnlyboolean
mustRetweetboolean
mustFollowUsernamestring
filterMinFollowersinteger
filterAccountAgeDaysinteger
filterLanguagestring
requiredHashtagsstring[]
requiredKeywordsstring[]
requiredMentionsstring[]

Example request

{
  "tweetUrl": "https://x.com/elonmusk/status/1234567890",
  "winnerCount": 3,
  "backupCount": 2,
  "uniqueAuthorsOnly": true,
  "mustRetweet": true,
  "mustFollowUsername": "elonmusk",
  "filterMinFollowers": 50,
  "filterAccountAgeDays": 30,
  "filterLanguage": "en",
  "requiredHashtags": [
    "#giveaway"
  ],
  "requiredKeywords": [
    "entered"
  ],
  "requiredMentions": [
    "@elonmusk"
  ]
}

Response

Draw completed

idstring required
tweetIdstring required
totalEntriesinteger required
validEntriesinteger required

Example response

{
  "id": "42",
  "tweetId": "1234567890",
  "totalEntries": 250,
  "validEntries": 200,
  "winners": []
}

Changes