{"uid":"cap_-JaQMUJ58b2JyPUszVRE-","slug":"hirescrape-tiktok-scraper-api-d883a085","name":"Hirescrape TikTok Scraper API","description":"Pay-per-call web scrapers for AI agents. 28 tools across Reddit, 8-board job search (LinkedIn · Indeed · Glassdoor · Google Jobs · +5), TikTok · Douyin · Bilibili, cross-platform trend research, social media, and ad libraries. No API keys. Agent wallets settle USDC on Tempo or Base via x402 + MPP.","url":"https://www.hirescrape.com/api/tools/tiktok","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"url":{"type":"string","description":"Full URL of the target object."},"mode":{"enum":["profile","audience","profile_videos","video","transcript","live","video_comments","comment_replies","following","followers","search_users","search_hashtag","search_keyword","search_top","popular_songs","popular_creators","popular_videos","popular_hashtags","song","song_videos","trending_feed"],"type":"string","default":"profile","description":"Which endpoint to call. Options: profile, audience, profile_videos, video, transcript, live, video_comments, comment_replies, following, followers, search_users, search_hashtag, search_keyword, search_top, popular_songs, popular_creators, popular_videos, popular_hashtags, song, song_videos, trending_feed."},"page":{"type":"integer","description":"Page number (default 1)."},"trim":{"type":"boolean","description":"Return a condensed response."},"limit":{"type":"integer","default":20,"maximum":500,"minimum":1,"description":"Max items to collect (applies to paginated modes)."},"query":{"type":"string","description":"Search keyword."},"clipId":{"type":"string","description":"TikTok song clip ID."},"cursor":{"type":"string","description":"Pagination cursor."},"handle":{"type":"string","description":"Username / handle (without @)."},"period":{"type":"integer","description":"Lookback days (7 or 30)."},"region":{"type":"string","description":"Proxy / market region (e.g. US)."},"sortBy":{"type":"string","description":"Sort key (depends on endpoint)."},"hashtag":{"type":"string","description":"Hashtag (without #)."},"orderBy":{"type":"string","description":"Order key (depends on endpoint)."},"sort_by":{"type":"string","description":"Sort key (depends on endpoint)."},"user_id":{"type":"string","description":"Platform user ID (often faster than handle)."},"industry":{"type":"string","description":"Industry filter."},"language":{"type":"string","description":"2-letter language code."},"min_time":{"type":"integer","description":"Pagination cursor (unix seconds)."},"rankType":{"type":"string","description":"popular or surging."},"comment_id":{"type":"string","description":"Parent comment ID."},"max_cursor":{"type":"string","description":"Pagination cursor."},"newOnBoard":{"type":"boolean","description":"Only items new to the chart."},"timePeriod":{"type":"integer","description":"Lookback days (7/30/130)."},"countryCode":{"type":"string","description":"Country code."},"date_posted":{"type":"string","description":"Posting timeframe."},"publish_time":{"type":"string","description":"Publication time filter."},"followerCount":{"type":"string","description":"Follower count bucket filter."},"creatorCountry":{"type":"string","description":"Creator country."},"download_media":{"type":"boolean","description":"Return permanent media URLs."},"get_transcript":{"type":"boolean","description":"Include transcript in the response."},"audienceCountry":{"type":"string","description":"Audience country."},"commercialMusic":{"type":"boolean","description":"Only commercial-use tracks."},"use_ai_as_fallback":{"type":"boolean","description":"Fall back to AI if no transcript."}}},"responseSchema":{"type":"json","schema":{"type":"object","required":["items"],"properties":{"items":{"type":"array","items":{"type":"object"},"description":"Scraped items. Shape varies per tool — see each tool's outputSample for a concrete example."},"runId":{"type":"string","description":"Run ID for debugging/audit."},"payment":{"type":"object","description":"Settlement summary (protocol, amount, currency)."},"duration":{"type":"integer","description":"Run duration in seconds."}}},"example":{"items":[{"id":"7234567890123456789","desc":"Day 30 of giving away money","stats":{"diggCount":3200000,"playCount":48000000,"shareCount":180000,"commentCount":42000},"author":{"nickname":"MrBeast","uniqueId":"mrbeast"},"createTime":1776300000}],"runId":"sc_mo4tiktokexample","payment":{"amount":"0.220000","currency":"USD","protocol":"x402"},"duration":5}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.00225","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.00225/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.00225","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.00225","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_0RMJhSqrehn09ShoK1_d7","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.00225","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Scrapes TikTok profiles, videos, comments, transcripts, search results, trending feeds, and audience data via a pay-per-call API","exampleAgentPrompt":"Pull the TikTok profile for handle 'mrbeast' and also grab his last 50 videos with their stats — use profile mode first, then profile_videos mode with a limit of 50, targeting the US region.","exampleUseCases":null,"resultDescription":"A JSON object with an 'items' array containing scraped TikTok data (shape varies by mode — e.g. profile info, video objects with play/like/share/comment counts, comment text, transcript segments, or search result lists), plus a runId for debugging, payment settlement summary, and run duration in seconds.","failureModes":["Invalid or deleted TikTok URL returns empty items array","Private/restricted account returns no data or partial profile","Unsupported mode value returns validation error","Rate limiting or geo-block causes empty results for certain regions","Pagination cursor mismatch returns incorrect page","Handle not found returns empty items","TikTok anti-scrape measures may cause intermittent failures"],"whenToPreferThis":"Use this endpoint when you need structured TikTok data (profiles, videos, comments, trends, transcripts) without managing your own scraping infrastructure or API keys. Prefer it for AI agent workflows that need pay-per-call pricing in USDC via x402, multi-mode TikTok coverage in a single endpoint, or access to trending/popular content feeds across regions.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T18:34:20.148Z","isFirstParty":false}