{"uid":"cap_TUGw0x7F6D3jrxHsspVRX","slug":"tiktok-posts-scraper-x402-105aab8d","name":"TikTok Posts Scraper (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/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_OuknOwb1ALMWkky96uKF8","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 structured TikTok post data from public profiles, hashtags, or direct URLs and returns post metadata including author, text, and timestamps.","exampleAgentPrompt":"Pull the 50 most recent TikTok posts from the profiles @charlidamelio and @addisonre sorted by latest, using a US proxy, and give me each post's caption, URL, and creation time.","exampleUseCases":[{"title":"Influencer content audit","prompt":"Grab the last 30 posts from TikTok accounts @gymshark and @nikesportswear sorted by latest so I can review what content they've been putting out recently."},{"title":"Hashtag trend research","prompt":"Scrape the top 100 most popular TikTok posts under the hashtag 'cottagecore' and return each post's caption, author, and URL so I can analyze the trend."},{"title":"Competitor social monitoring","prompt":"Fetch the latest 50 TikTok posts from profiles @sephora and @ultabeauty using a UK proxy and sort them by newest first so I can track their recent campaigns."}],"resultDescription":"Returns a JSON object with a count of collected posts and an items array where each item contains the post ID, URL, caption text, author ID, author name, author nickname, and creation time in both Unix timestamp and ISO 8601 format.","failureModes":["Private or restricted TikTok profiles return no results and are not charged","Hashtags with very low visibility may yield zero posts","Invalid or misspelled usernames return empty items array","Region routing may not guarantee geo-specific content due to TikTok's serving logic","maxResults exceeding the public embed list size silently caps at available posts","Malformed URLs in startUrls may be skipped without explicit error"],"whenToPreferThis":"Choose this endpoint when you need structured TikTok post metadata (captions, author info, timestamps, URLs) from public profiles or hashtags without managing browser automation or TikTok API credentials. It is pay-per-call with no charge for failed or empty runs, making it cost-efficient for exploratory or intermittent scraping tasks. Prefer it over general-purpose scraping tools when you need TikTok-specific field normalization out of the box.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T00:47:27.767Z","isFirstParty":false,"canonicalSlug":"tiktok-posts-scraper-x402-105aab8d"}