{"uid":"cap_plh8gmZEm-v8CjV-8kpSC","slug":"agentbodega-x-post-search-b4002a3a","name":"AgentBodega X Post Search","description":"Small x402-payable utility APIs for agents: endpoint inspection, launch checks, and hosted artifacts.","url":"https://agentbodega.store/api/social-media/x/tweet-search","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"input":{"type":"object","properties":{"body":{"fields":[{"name":"query","type":"string","required":false},{"name":"words","type":"string","required":false},{"name":"phrase","type":"string","required":false},{"name":"anyWords","type":"array","required":false},{"name":"noneWords","type":"array","required":false},{"name":"hashtags","type":"array","required":false},{"name":"from","type":"string","required":false},{"name":"to","type":"string","required":false},{"name":"mentioning","type":"string","required":false},{"name":"minReplies","type":"integer","required":false},{"name":"minLikes","type":"integer","required":false},{"name":"minReposts","type":"integer","required":false}],"required":[],"fieldCount":15,"contentType":"application/json","optionalPreview":["query","words","phrase","anyWords","noneWords","hashtags","from","to","mentioning","minReplies","minLikes","minReposts"],"omittedFieldCount":3},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json"],"type":"string"}}},"output":{"type":"object","properties":{"type":{"type":"string","const":"json"},"example":{"type":"object","additionalProperties":true}}}}},"responseSchema":{"type":"json","example":{"tool":{"id":"x-tweet-search","name":"X Post Search","department":"Social Media"},"results":[{"id":"1110302988","text":"Normalized public post text","author":{"username":"OpenAI"},"metrics":{"likes":10,"replies":1,"reposts":2}}],"success":true,"requested":{"query":"agent from:OpenAI min_faves:10","maxResults":5},"result_count":5}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.06","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.06/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.06","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.06","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_KlrSqQ-Z0XN9_gopOk4oq","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.06","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Searches X (Twitter) posts using advanced filters like keywords, hashtags, author, engagement thresholds, and boolean operators.","exampleAgentPrompt":"Search X for posts from OpenAI mentioning 'agents' that have at least 10 likes and show me the top 5 results.","exampleUseCases":[{"title":"Brand mention monitoring for a product","prompt":"Search X for any posts mentioning 'AgentKit' with the hashtag #AI that have at least 5 reposts — I want to see what people are saying about it."},{"title":"Competitor sentiment research","prompt":"Find recent X posts from the account @Anthropic that mention 'Claude' and have at least 20 likes so I can see what's resonating with their audience."},{"title":"Viral topic discovery by hashtag","prompt":"Search X for posts using the hashtag #Web3 that have at least 50 likes and 10 reposts — I want to find the most engaging content on that topic right now."}],"resultDescription":"Returns a JSON object containing a list of matching X posts, each with the post ID, normalized text, author username, and engagement metrics (likes, replies, reposts), along with the total result count and the original query parameters used.","failureModes":["No results found if query filters are too restrictive (e.g. very high minLikes threshold)","Invalid or unsupported query syntax may return an error or empty results","Rate limits or payment failures may block the request","Posts from private or suspended accounts are not returned","Very recent posts may not yet be indexed"],"whenToPreferThis":"Choose this endpoint when an agent needs to search X (Twitter) posts with granular filters — combining keyword, phrase, boolean, hashtag, author, recipient, and engagement threshold logic in a single call. It is ideal for social listening, brand monitoring, and content research tasks where structured filtering beyond basic keyword search is needed, and when the agent operates in an x402-payable micropayment context.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:48:23.822Z","isFirstParty":false}