{"uid":"cap_IzPBNn2Oe-WmR_VZ9wfdJ","slug":"twitr-sh-tweet-composer-ce38f2bf","name":"twitr.sh Tweet Composer","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.","url":"https://twitr.sh/api/tools/compose","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"goal":{"type":"string"},"step":{"enum":["generate","refine","score"],"type":"string","description":"Composer step."},"tone":{"type":"string"},"draft":{"type":"string"},"topic":{"type":"string"},"hasLink":{"type":"boolean"},"hasMedia":{"type":"boolean"},"mediaType":{"type":"string"},"callToAction":{"type":"string"},"styleUsername":{"type":"string"},"additionalContext":{"type":"string"}}},"responseSchema":{"type":"json","example":{"items":[{"text":"Your agent can now pay for its own API calls. No signup, no keys — just a wallet.","score":87,"suggestions":["Add a concrete number for credibility"]}],"runId":"tw_example","payment":{"amount":"0.001000","currency":"USD","protocol":"x402"},"duration":2}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.0024","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.0024/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0024","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0024","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_7-lrDrpO8F6CRHLzdnaDo","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.0024","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"AI-powered tweet drafting: generate variants from a topic, refine an existing draft, or score a draft for predicted engagement — with tone, CTA, and style-matching controls.","exampleAgentPrompt":"Generate three tweet variants about the launch of our new open-source CLI tool, with the goal of driving GitHub stars, using an enthusiastic tone and a 'check it out' call to action — and score whichever draft you think is strongest.","exampleUseCases":[{"title":"Product launch tweet generation","prompt":"Generate a few tweet options announcing our new AI writing app — the goal is signups, keep the tone conversational and punchy, and include a call to action like 'try it free today'."},{"title":"Refine an existing draft for clarity","prompt":"Here's my tweet draft: 'We just shipped something huge. You're going to want to see this.' — can you refine it to be more specific and engaging, keeping the mysterious tone but adding a stronger hook?"},{"title":"Score a tweet before posting","prompt":"Before I post this tweet, can you score it for likely engagement? 'The single biggest mistake developers make with LLMs is ignoring context window management. Here's how to fix it 🧵' — it has a link and no media."}],"resultDescription":"Depending on the step: 'generate' returns multiple tweet variants crafted from the topic and goal; 'refine' returns an improved version of the provided draft; 'score' returns an engagement likelihood score with reasoning, flagging strengths and weaknesses of the draft.","failureModes":["Missing required 'step' enum value — returns validation error","Missing 'topic' when step is 'generate' — no content to draft from","Missing 'draft' when step is 'refine' or 'score' — nothing to work with","Invalid tone or style username that cannot be resolved — may produce generic output","Payment failure (x402) — request not processed if USDC payment not attached"],"whenToPreferThis":"Choose this endpoint when you need AI-assisted tweet composition with fine-grained controls (tone, CTA, style-matching) or want to evaluate a draft before publishing. Prefer it over generic LLM prompting when you want structured composer steps (generate/refine/score), consistent sub-cent pricing per step, and Twitter-specific optimization built into the model.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-16T06:37:11.824Z","isFirstParty":false}