{"uid":"cap_aJRXjv8wTsYI-37yVWATw","slug":"socialfetch-threads-keyword-search-a89a3443","name":"SocialFetch Threads Keyword Search","description":"Search Threads posts by keyword.","url":"https://api.socialfetch.dev/v1/threads/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":{"trim":{"anyOf":[{"type":"boolean"},{"enum":["0","1","true","false"],"type":"string"}],"description":"Whether to request a smaller response shape when available."},"query":{"type":"string","maxLength":512,"minLength":1,"description":"Search query text for public Threads posts."},"endDate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Optional end date filter in YYYY-MM-DD format."},"startDate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Optional start date filter in YYYY-MM-DD format."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.014","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":1,"rating":{"score":"0.50","successRate":"1.00","reviews":1,"stars":"3.0","state":"rated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.014/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_ku_DTNnoZtnnsL_QHUDgI","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 Threads posts by keyword with optional date range filters","exampleAgentPrompt":"Search Threads for public posts mentioning 'climate change' from January 1, 2024 to March 31, 2024 and show me what people are saying.","exampleUseCases":[{"title":"Monitor brand mentions on Threads","prompt":"Search Threads for any public posts mentioning 'Nike' from the past two weeks and tell me what people are saying about the brand."},{"title":"Track trending topic discussions","prompt":"Look up what people are posting on Threads about 'AI regulation' right now and summarize the main opinions and talking points."},{"title":"Research competitor buzz after launch","prompt":"Find recent Threads posts mentioning 'Notion AI' from the last 30 days so I can see how people are reacting to their new features."}],"resultDescription":"A list of public Threads posts matching the search query, potentially including post text, author info, timestamps, and engagement metadata. If trim is enabled, returns a reduced response shape with fewer fields.","failureModes":["Empty query string or query exceeding 512 characters returns validation error","Invalid date format (not YYYY-MM-DD) triggers schema validation failure","No results found for niche or very recent query returns empty result set","Rate limiting or payment failure (x402) if USDC balance is insufficient","Threads API availability issues may cause upstream errors or timeouts"],"whenToPreferThis":"Use this endpoint when you need to search Threads posts by keyword across the public feed, especially with date-range filtering. Prefer this over profile-based endpoints when you don't have a specific account in mind but want topical or trending content from Threads. Choose this over scraping or manual lookup when you need structured, programmatic access to Threads search results.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":16,"lastUsedAt":"2026-08-04T00:56:29.429Z","lastSuccessfullyRanAt":"2026-08-04T00:56:29.429Z","lastHealthCheckAt":"2026-09-14T06:43:47.068Z","isFirstParty":false}