{"uid":"cap_EHXDAN8u9I95-r8uyxls6","slug":"threads-scraper-profiles-posts-search-8166d80c","name":"Threads Scraper — Profiles, Posts & Search","description":"Pay-per-call structured web data. Failed or empty runs are not charged.","url":"https://api.scrapeforagents.tech/v1/threads?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"mode":{"enum":["profile","posts","search"],"type":"string","default":"posts","description":"Choose profile records, posts from public accounts, or keyword search."},"maxItems":{"type":"integer","default":0,"minimum":0,"description":"Maximum dataset items across all targets; 0 means no total cap."},"maxPosts":{"type":"integer","default":20,"maximum":200,"minimum":1,"description":"Maximum posts per username or search query, up to 200; availability may be lower."},"usernames":{"type":"array","description":"Public Threads usernames for profile or posts mode; @ is optional."},"searchSort":{"enum":["top","recent"],"type":"string","default":"top","description":"Top ranks by relevance; recent shows the newest available matches."},"postedAfter":{"type":"string","description":"Include posts at or after this ISO date or timestamp."},"postedBefore":{"type":"string","description":"Include posts before this ISO date or timestamp."},"searchQueries":{"type":"array","description":"Keywords or phrases to find public posts in search mode."},"includeProfile":{"type":"boolean","default":true,"description":"Include a separate profile item alongside posts from each username."}}},"responseSchema":{"type":"json","example":{"count":1,"items":[{"type":null,"userId":null,"fullName":null,"username":null,"biography":null,"isVerified":null,"followerCount":null,"profilePicUrl":null}],"product":"threads"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.025","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.025/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.025","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.025","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_DxZwn3bPiZX4gb3i1-K-1","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.025","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Scrapes public Threads profiles, posts, and keyword search results into structured JSON records","exampleAgentPrompt":"Pull up to 50 recent posts from the Threads accounts @zuck and @mosseri posted after 2025-01-01, and include their profile info too.","exampleUseCases":[{"title":"Brand mention monitoring on Threads","prompt":"Search Threads for the top 30 posts mentioning 'OpenAI' posted after 2025-06-01 and sort them by relevance so I can see what people are saying about the brand."},{"title":"Influencer profile audit","prompt":"Get the full profile info and last 100 posts from the Threads accounts @garyvee and @naval — I want to see their follower counts, bios, and verified status alongside their content."},{"title":"Trend research by keyword","prompt":"Search Threads for the 50 most recent posts about 'climate tech' so I can analyze what's trending in that space right now."}],"resultDescription":"Returns a JSON object with a count and an items array. Each item can be a profile record (userId, username, fullName, biography, isVerified, followerCount, profilePicUrl) or a post record, depending on the requested mode. The product field is always 'threads'. Failed or empty runs are not billed.","failureModes":["Private or non-existent Threads accounts return no items (not charged)","Search queries with no matching public posts return an empty items array (not charged)","Rate limits or upstream Threads blocks may result in partial data","Invalid mode enum values or missing required arrays (usernames/searchQueries) for selected mode may cause errors","postedAfter/postedBefore in wrong format may be ignored or cause empty results"],"whenToPreferThis":"Choose this endpoint when you need structured, pay-per-result data from public Threads accounts or keyword searches without building your own scraper. It is especially useful for brand monitoring, influencer research, and social listening on Threads specifically. The pay-per-call model (only charged on non-empty results) makes it cost-efficient for variable workloads. Prefer this over general web scraping tools when the target is specifically Threads profiles or posts.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T00:46:42.571Z","isFirstParty":false,"canonicalSlug":"threads-scraper-profiles-posts-search-8166d80c"}