{"uid":"cap_bTXX1MVKJ3G1w49Bi5c5j","slug":"socialfetch-x-post-search-05a32922","name":"SocialFetch X Post Search","description":"Search X posts or people by query.","url":"https://api.socialfetch.dev/v1/twitter/search","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["query"],"properties":{"limit":{"type":"integer","maximum":20,"minimum":1,"description":"Optional page size (1–20). Best-effort; the actual page size may differ."},"query":{"type":"string","maxLength":512,"minLength":1,"description":"Search query for public posts on X."},"cursor":{"type":"string","minLength":1,"description":"Opaque pagination cursor returned by a previous response."},"endDate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Optional end date filter in YYYY-MM-DD format."},"section":{"enum":["top","latest","people","photos","videos"],"type":"string","default":"top","description":"Search section: `top` (default), `latest`, `people`, `photos`, or `videos`."},"language":{"enum":["en","es","fr","de","it","pt","ru","zh","ja","ko","ar","bg","hr","cs","da","nl","et","fi","el","hu","id","ga","lv","lt","no","pl","ro","sk","sl","sv","tr","uk","vi","cy","zu"],"type":"string","description":"Optional language filter."},"minLikes":{"type":"integer","maximum":9007199254740991,"minimum":0,"description":"Optional minimum like count filter."},"startDate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Optional start date filter in YYYY-MM-DD format."},"minReplies":{"type":"integer","maximum":9007199254740991,"minimum":0,"description":"Optional minimum reply count filter."},"minRetweets":{"type":"integer","maximum":9007199254740991,"minimum":0,"description":"Optional minimum retweet count filter."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.028","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":1,"rating":{"score":"1.00","successRate":"1.00","reviews":1,"stars":"5.0","state":"rated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.028/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.014","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.014","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_6NqGqdGhEDbkrtxvET1a2","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.014","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search public X (Twitter) posts by keyword with optional filters for date range, language, section, and engagement metrics.","exampleAgentPrompt":"Search X for the latest posts about 'AI regulation' from the past week, show me up to 20 results in English with at least 50 likes, sorted by most recent.","exampleUseCases":null,"resultDescription":"A paginated list of public X posts matching the search query, including post content, author info, engagement counts (likes, retweets, replies), and an opaque cursor for fetching the next page of results.","failureModes":["Empty results if no posts match the query or filters","Rate limiting or quota exceeded errors if too many calls are made","Invalid date format returns a validation error","Cursor expiration causes pagination to fail","Language or section enum mismatch returns a 400 error","Query too long (over 512 chars) returns a validation error"],"whenToPreferThis":"Use this endpoint when you need to search public X posts by keyword, phrase, or hashtag, especially when filtering by date range, language, engagement thresholds, or content section (top, latest, people, photos, videos). Prefer this over profile-based endpoints when the goal is topic or keyword discovery rather than a specific account's content.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":5,"lastUsedAt":"2026-08-04T20:32:38.293Z","lastSuccessfullyRanAt":"2026-08-04T20:32:38.293Z","lastHealthCheckAt":"2026-09-14T18:58:02.835Z","isFirstParty":false}