{"slug":"twitr-sh-api-tools-compose-bd01ff","title":"Draft tweets with AI","host":"twitr.sh","method":"POST","resource":"https://twitr.sh/api/tools/compose","category":"market","description":"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.","price_listed":0.001,"price_asked":0.0024,"state":"overcharges","state_label":"Asked 2.4x its listed price for its own example","checks_7d":1,"answered_7d":1,"latency_ms_median":253,"reported_calls_30d":5,"reported_payers_30d":1,"networks":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"],"badge":"unverified","paid_checks_7d":0,"paid_ok_7d":0,"example_input":{"body":{"goal":"announce launch","step":"generate","tone":"punchy","topic":"pay-per-call APIs for AI agents"},"bodyType":"json","method":"POST","type":"http"},"output_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"additionalProperties":false,"properties":{"body":{"properties":{"additionalContext":{"type":"string"},"callToAction":{"type":"string"},"draft":{"type":"string"},"goal":{"type":"string"},"hasLink":{"type":"boolean"},"hasMedia":{"type":"boolean"},"mediaType":{"type":"string"},"step":{"description":"Composer step.","enum":["generate","refine","score"],"type":"string"},"styleUsername":{"type":"string"},"tone":{"type":"string"},"topic":{"type":"string"}},"required":["step"],"type":"object"},"bodyType":{"enum":["json","form-data","text"],"type":"string"},"method":{"enum":["POST","PUT","PATCH"],"type":"string"},"type":{"const":"http","type":"string"}},"required":["type","method","bodyType","body"],"type":"object"},"output":{"properties":{"example":{"properties":{"duration":{"description":"Run duration in seconds.","type":"integer"},"items":{"description":"Returned items. Shape varies per tool — see each tool's outputSample for a concrete example.","items":{"type":"object"},"type":"array"},"payment":{"description":"Settlement summary (protocol, amount, currency).","type":"object"},"runId":{"description":"Run ID for debugging/audit.","type":"string"}},"required":["items"],"type":"object"},"type":{"type":"string"}},"required":["type"],"type":"object"}},"required":["input"],"type":"object"},"history":[{"day":"2026-09-24","reachable":true,"status":402,"valid_402":true,"asked_usdc":0.0024,"price_match":false,"latency_ms":253,"error":null}],"description_full":"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.","last_updated":"2026-09-11T19:12:03.661Z","schemes":["exact"]}