{"uid":"cap_Jgl8vh4_NL0CQWyxVlwlm","slug":"api-direct-search-threads-posts-by-keyword-b27ad461","name":"API Direct – Search Threads Posts by Keyword","description":"Search for Threads posts by keyword.","url":"https://x402.apidirect.io/v1/threads/posts?utm_source=zero.xyz","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","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":["query"],"properties":{"pages":{"type":"integer","default":1,"maximum":200,"minimum":1,"description":"Number of pages to fetch, 1-200 (default: 1). The first page returns about 20 posts and later pages about 10; you are billed per page returned."},"query":{"type":"string","maxLength":500,"description":"Search keyword (max 500 characters)"},"get_sentiment":{"type":"boolean","default":false,"description":"Set to true to add AI emotion analysis to each result (+$0.001/request)"}}}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.007","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.007/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.007","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.007","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_CDyXTxZOgVGRctxw2sJaF","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.007","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Searches Meta's Threads platform for posts matching a given keyword, returning paginated results with optional AI sentiment analysis.","exampleAgentPrompt":"Search Threads for posts mentioning 'electric vehicles' — fetch 3 pages of results and include AI sentiment analysis for each post.","exampleUseCases":[{"title":"Brand mention monitoring on Threads","prompt":"Search Threads for posts mentioning 'Nike' and get me 5 pages of results so I can see what people are saying about the brand lately."},{"title":"Sentiment tracking for a product launch","prompt":"Find Threads posts about the new iPhone launch and turn on sentiment analysis so I can see whether the overall reaction is positive or negative."},{"title":"Competitor research on Threads","prompt":"Pull the first 2 pages of Threads posts mentioning 'Notion' — I want to see what users are complaining about or praising."}],"resultDescription":"Returns a paginated list of Threads posts matching the search keyword. Each page contains approximately 20 posts (first page) or 10 posts (subsequent pages), including post text and metadata. If sentiment analysis is enabled, each post also includes AI-generated emotion/sentiment scores. The agent is billed per page returned.","failureModes":["Missing required 'query' parameter returns a validation error","Query exceeding 500 characters is rejected","Pages value outside 1–200 range returns a validation error","Keyword returns zero results if no matching Threads posts exist","Rate limiting or upstream Threads API unavailability may cause failures","Payment failure (insufficient USDC balance) blocks the request"],"whenToPreferThis":"Use this endpoint when you need to search Meta's Threads platform specifically for posts matching a keyword. It is the right choice for brand monitoring, social listening, competitor research, or trend detection on Threads. Prefer it over Reddit or Twitter/X search endpoints when your target audience is on Threads. The optional sentiment analysis add-on makes it suitable for opinion mining without a separate NLP step.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T19:08:32.145Z","isFirstParty":false,"canonicalSlug":"api-direct-search-threads-posts-by-keyword-b27ad461"}