Creator

AI Tweet Composer

Draft tweets with AI: generate variants from a topic and goal, refine an existing draft, or score a draft for likely engagement — with tone, call-to-action, and style-matching options. Flat sub-cent price per step.

post/api/tools/compose

Request

  • Base URL: https://twitr.sh
  • URL: https://twitr.sh/api/tools/compose
  • Auth: none declared

Request body

step'generate' | 'refine' | 'score' required

Composer step.

topicstring
goalstring
draftstring
tonestring
styleUsernamestring
additionalContextstring
callToActionstring
mediaTypestring
hasLinkboolean
hasMediaboolean

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.