{"uid":"cap_Sc7GMDikssJwVcmn78Ep4","slug":"threads-scraper-api-x402-bae69417","name":"Threads Scraper API (x402)","description":"Pay-per-call structured web data. Failed or empty runs are not charged.","url":"https://x402.186-241-26-229.sslip.io/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_T84NUDzF07EtJeJd0C-0Q","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":"Fetches structured public data from Threads — profiles, posts, and keyword search results — billed per call via x402 micropayment.","exampleAgentPrompt":"Pull the last 50 posts and profile info for the Threads accounts @zuck and @instagram — search mode isn't needed, just posts mode — and filter to anything posted after 2024-01-01.","exampleUseCases":[{"title":"Influencer research for brand campaign","prompt":"Get me the profile details and top 30 posts for these Threads accounts: @natgeo, @nasa, and @wired — I want their follower counts, bios, and verified status alongside the posts."},{"title":"Brand mention monitoring on Threads","prompt":"Search Threads for the most recent 40 posts mentioning 'climate tech' — sort by recent, not top — and only include posts from after March 1 2025."},{"title":"Competitor audience analysis","prompt":"Scrape the Threads profiles for @shopify and @stripe — just profile mode, no posts needed — so I can compare their follower counts and bios."}],"resultDescription":"Returns a JSON object with a count and an items array. Each item can represent a user profile (username, full name, biography, follower count, verified status, profile picture URL) or a post, depending on the selected mode. The product field confirms the data source as 'threads'.","failureModes":["Account is private — no posts returned, not charged","Username does not exist on Threads — empty result, not charged","Search query returns no matching posts — empty result, not charged","Rate limit or scraper block from Threads — upstream failure, not charged","Invalid mode value — request rejected with validation error","postedAfter/postedBefore date format invalid — request rejected"],"whenToPreferThis":"Choose this endpoint when you need structured Threads data (profiles, posts, or keyword search) without managing your own scraper infrastructure. It is pay-per-call via x402 micropayment ($0.025 USDC), and failed or empty runs are not billed — making it low-risk for exploratory or conditional workflows. Prefer it over general web scraping when you specifically need Threads-native data fields like follower counts, verification status, or post engagement.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T00:47:39.605Z","isFirstParty":false,"canonicalSlug":"threads-scraper-api-x402-bae69417"}