{"uid":"cap_uv-YludXBgaPEAebqKtcl","slug":"tiktok-posts-scraper-fa96e64a","name":"TikTok Posts Scraper","description":"Pay-per-call structured web data. Failed or empty runs are not charged.","url":"https://api.scrapeforagents.tech/v1/tiktok-posts?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"region":{"type":"string","description":"Optional two-letter country code for proxy routing; results may still follow site availability."},"sortBy":{"enum":["latest","popular"],"type":"string","default":"latest","description":"Sort posts within each visible source list by posting time or play count."},"hashtag":{"type":"string","description":"Hashtag without #. Availability varies by tag."},"maxItems":{"type":"integer","default":0,"minimum":0,"description":"Stop after this many unique posts across all sources. Zero means no additional total cap."},"profiles":{"type":"array","items":{"type":"string"},"description":"Usernames without @. Each public creator embed supplies a small recent post list."},"startUrls":{"type":"array","items":{"type":"string"},"description":"Public TikTok profile, hashtag, music, or video URLs. These take priority over scrape mode."},"maxResults":{"type":"integer","default":50,"maximum":10000,"minimum":1,"description":"Maximum posts to emit from a hashtag or music embed, subject to its public list size."},"scrapeMode":{"enum":["profiles","hashtag"],"type":"string","default":"profiles","description":"Collect recent posts from profiles or one hashtag."},"maxResultsPerProfile":{"type":"integer","default":30,"maximum":5000,"minimum":1,"description":"Maximum posts to emit per profile, subject to the public embed list size (usually about 10)."}}},"responseSchema":{"type":"json","example":{"count":1,"items":[{"id":null,"url":null,"text":null,"authorId":null,"authorName":null,"createTime":null,"createTimeISO":null,"authorNickName":null}],"product":"tiktok-posts"}},"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_12oj2blYUOIodBo_rHyuC","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 TikTok posts from profiles, hashtags, or direct URLs and returns structured post metadata","exampleAgentPrompt":"Pull the 50 most recent TikTok posts from the profiles 'charlidamelio' and 'addisonre', sorted by latest, and give me each post's caption, URL, and timestamp.","exampleUseCases":[{"title":"Influencer content audit","prompt":"Get me the last 30 TikTok posts from the creators 'khaby.lame' and 'bellapoarch' — I need the captions, post URLs, and when they were posted, sorted by latest."},{"title":"Hashtag trend monitoring","prompt":"Scrape up to 100 TikTok posts from the hashtag 'BookTok', sorted by most popular, and give me the author names, captions, and post URLs."},{"title":"Competitor social media research","prompt":"Fetch the most recent 20 TikTok videos posted by the account 'nike' and return the post text, video URLs, and creation times so I can analyze their content strategy."}],"resultDescription":"Returns a JSON object with a count of collected posts and an array of post items, each containing the post ID, URL, caption text, author ID, author username, author nickname, and creation timestamps (Unix and ISO format). The product field confirms 'tiktok-posts'.","failureModes":["Private or restricted TikTok accounts return no results","Hashtag may have limited or no public embed availability, returning fewer results than maxResults","Region-restricted content may not be accessible even with proxy routing","TikTok rate limits or platform changes may reduce result counts","Specifying maxResults above the public embed list size will return fewer items than requested","Invalid or deleted TikTok URLs will return empty result sets"],"whenToPreferThis":"Choose this endpoint when you need structured post metadata (captions, timestamps, author info, URLs) from TikTok profiles or hashtags at scale without managing your own browser automation. It is pay-per-successful-call so failed or empty runs are not billed, making it cost-efficient for exploratory or batch social media research. Prefer this over general web scrapers when you specifically need TikTok post data in a clean, normalized JSON format.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T00:47:43.124Z","isFirstParty":false,"canonicalSlug":"tiktok-posts-scraper-fa96e64a"}