{"uid":"cap_3_we_htiD_mDgqMeXPZVW","slug":"kg-ninja-hyperxosist-twitter-x-query-builder-bd9514f2","name":"KG-NINJA Hyperxosist Twitter/X Query Builder","description":"Machine-payable agent API with free discovery and preview tools, plus x402-paid execution endpoints for structured agent results.","url":"https://api.kgninja.dev/hyperxosist-query?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"lang":{"type":"string"},"mode":{"enum":["live","top"],"type":"string"},"noise":{"type":"object","properties":{"preset":{"enum":["low","medium","high"],"type":"string"},"enabled":{"type":"boolean"},"removed":{"type":"array","items":{"type":"string"}}},"additionalProperties":false},"fromUser":{"type":"string"},"keywords":{"type":"string"},"minFaves":{"type":["string","number"]},"hasImages":{"type":"boolean"},"hasVideos":{"type":"boolean"},"sinceDate":{"type":"string"},"untilDate":{"type":"string"},"exactPhrase":{"type":"string"},"minRetweets":{"type":["string","number"]},"excludeLinks":{"type":"boolean"},"excludeWords":{"anyOf":[{"type":"string"},{"type":"array","items":{"type":"string"}}]}}},"responseSchema":{"type":"json","example":{"query":"Cloudflare Workers lang:en","searchUrl":"https://x.com/search?q=Cloudflare%20Workers%20lang%3Aen&src=typed_query&f=live"}},"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_Ft7IJ_KzlC_exEBPctagj","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":"Builds a structured Twitter/X search query and URL from natural language search parameters like keywords, filters, date ranges, and engagement thresholds.","exampleAgentPrompt":"Search X for live tweets about 'Cloudflare Workers' in English since 2024-01-01 that have at least 50 likes, exclude any tweets with links, and apply low noise filtering — give me the search URL.","exampleUseCases":[{"title":"Track viral AI news on X","prompt":"Build me a Twitter search for the top tweets mentioning 'GPT-5' or 'OpenAI' in English since May 1st 2025 with at least 100 retweets, filtering out low-quality noise with the medium noise preset."},{"title":"Monitor competitor mentions with engagement filter","prompt":"I want to find live tweets that mention 'Anthropic Claude' exactly as a phrase, have at least 20 favorites, are in English, and don't include any links — can you build that X search URL for me?"},{"title":"Curate image-rich posts from a specific user","prompt":"Find top tweets from user 'sama' that contain images, posted between January 1st and March 31st 2025, with the low noise preset enabled — give me the search query and URL."}],"resultDescription":"Returns a JSON object containing the constructed X/Twitter search query string (e.g. 'Cloudflare Workers lang:en') and a fully-formed X search URL ready to open or pass to a scraper, with all specified filters encoded.","failureModes":["Invalid date format in sinceDate or untilDate returns an error","Empty or missing keywords may produce an overly broad or invalid query","Conflicting filters (e.g. hasImages and excludeLinks simultaneously) may yield no results on X","minFaves or minRetweets as non-numeric strings may cause parsing errors","Unsupported language codes in the lang field may silently produce incorrect queries"],"whenToPreferThis":"Choose this endpoint when you need to construct a precise, multi-filter Twitter/X search query programmatically — especially when combining date ranges, engagement thresholds, language filters, media filters, and noise reduction in a single call. Prefer it over manual query construction or generic search APIs when the target platform is specifically X/Twitter and you need a ready-to-use search URL.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T12:32:09.901Z","isFirstParty":false,"canonicalSlug":"kg-ninja-hyperxosist-twitter-x-query-builder-bd9514f2"}