{"uid":"cap_eL6680oA2eo8N6WFF9fMl","slug":"x-preflight-post-grader-18b0577f","name":"X Preflight Post Grader","description":"X Preflight: read a draft post against X's open-sourced ranking code. Returns what is already settled before you post, whether it enters the pool strangers are drawn from, how long it stays retrievable, which filters delete it, and which gates nobody can know in advance. Every claim cites a file and line in X's published source. Never writes the post. Nothing stored.","url":"https://kevinhoff.com/api/paid/grade","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"text":{"type":"string","description":"The draft post. Never rewritten, never stored."},"brief":{"type":"boolean","description":"OPTIONAL, defaults to false. True returns the classification only and drops the prose, which is 78% of the generation. Answers in seconds instead of tens of seconds, same model and same price. Use it if your client has a short timeout."},"post_kind":{"enum":["original","reply","quote","repost"],"type":"string","description":"OPTIONAL, defaults to original. A reply's parent is not in the text, so no tool can read this off the draft. Declare it only if it is not an original."},"all_video_over_10s":{"type":"boolean","description":"OPTIONAL, defaults to false. Whether EVERY attachment is video running longer than ten seconds. One photo or one short clip makes this false."},"reader_follows_back":{"type":"boolean","description":"OPTIONAL, defaults to false. Whether the reader follows the author back. Decides in-network versus out-of-network, which changes the reply chain."},"followers_under_1000":{"type":"boolean","description":"OPTIONAL, defaults to false. Whether the author is under the small-account cap that the one per-batch lift applies to."}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_zEsqVBk7ZDX3HszjOciBN","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Analyzes a draft X (Twitter) post against X's open-sourced ranking code to predict visibility, filter behavior, and retrievability before publishing","exampleAgentPrompt":"Before I post this on X, can you run it through the X Preflight grader and tell me whether it'll enter the recommendation pool, which filters might kill it, and how long it stays retrievable — it's an original post: 'Just launched our open-source repo for AI agent orchestration — would love feedback from builders in the space!'","exampleUseCases":[{"title":"Pre-publish visibility check for original tweet","prompt":"Grade this draft X post for me before I publish it — tell me if it enters the recommendation pool, what filters might suppress it, and how long it stays retrievable: 'Thread on why most AI products fail at the UX layer, not the model layer 🧵'"},{"title":"Reply thread algorithmic audit","prompt":"I'm about to post a reply on X, not an original tweet. Can you run this through X Preflight and give me the brief classification only — does it get filtered or suppressed? Text: 'Totally agree — the failure mode is almost always data quality, not model choice.'"},{"title":"Content strategy filter check for small account","prompt":"I have under 1000 followers on X and I want to know if this post will get filtered before I waste it — use the brief mode and tell me the classification: 'Why the best engineers I know avoid meetings at all costs (and what they do instead)'"}],"resultDescription":"Returns a structured analysis citing specific files and line numbers from X's published source code, indicating: whether the post enters the recommendation pool that strangers are drawn from, how long the post remains retrievable, which content filters would delete or suppress it, and which ranking gates cannot be predicted in advance. In brief mode, returns only the classification without explanatory prose.","failureModes":["Empty or missing text field returns an error","Post text exceeding platform length limits may produce unexpected results","Optional enum value for post_kind outside allowed values (original/reply/quote/repost) returns validation error","Network timeout more likely in full mode (non-brief) due to longer generation time — use brief:true for short-timeout clients","Payment of 0.01 USDC required per call; unpaid requests are rejected with 402"],"whenToPreferThis":"Use this endpoint when you need a pre-publish audit of a draft X post grounded in X's actual open-sourced ranking code, with citations. Prefer this over generic social media advice tools when the user wants verifiable, source-cited predictions about algorithmic visibility, filter behavior, or pool eligibility — not general best-practice tips. Choose brief mode when latency is a concern or only the classification outcome is needed.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:34:07.347Z","isFirstParty":false}