{"name":"tiktok-search","id":"sfoln/tiktok-search","title":"TikTok Search Scraper – Videos by Keyword","description":"Search TikTok videos by keyword, sorted by relevance, likes or date: caption, author, plays, likes, comments, shares, saves, duration, music and hashtags, one JSON record per video. $0.40 per 1,000 videos + $0.003 per results page. Repeated videos are never charged.","version":"0.1","status":"ready","family":{"id":"social-media-data","name":"Social media data","description":"Profiles, posts, comments, followers and account audits from X, Instagram, TikTok, YouTube, Reddit, Threads, LinkedIn, Facebook, Bluesky, Telegram, Hacker News and Substack.","actors":31},"categories":["SOCIAL_MEDIA","VIDEOS","AUTOMATION"],"availability":"on_request","seoTitle":"TikTok Search Scraper API – $0.40 per 1,000 videos","seoDescription":"TikTok search scraper API: find videos by keyword and export plays, likes, comments, shares, music and hashtags to JSON. $0.40 per 1,000 videos. No login.","summary":"TikTok Search Scraper – Videos by Keyword searches TikTok videos by keyword and returns one normalized record per video: video ID, URL, caption, posting date, duration, plays, likes, comments, shares, saves, cover image, music, hashtags, mentions and the author's handle, ID and nickname. Sort by relevance, most liked or newest, and filter by period. It's built for trend research, influencer discovery, brand and campaign monitoring, dataset building and AI agents.","pricing":{"model":"pay-per-event","currency":"USD","billedBy":"Apify","freePlanMaxItemsPerRun":10,"events":[{"name":"tiktok-search-result","title":"TikTok search result","description":"Charged once per TikTok video delivered as a dataset record. Query summary records are never charged.","priceUsd":0.0004},{"name":"tiktok-search-query","title":"TikTok search page","description":"Charged once per page of search results that delivered at least one new video. Covers the per-request upstream fee. Also charged for an empty page the upstream billed (when the budget covers it).","priceUsd":0.003}]},"input":{"description":"Enter keywords. Each keyword produces one dataset record per video plus one summary record per keyword.","required":["keywords"],"fields":[{"name":"keywords","title":"Keywords","type":"array","required":true,"description":"Search terms, one per line. Duplicates are removed. Accounts on the Apify free plan can process up to 10 keywords per run.","prefill":["cooking hacks"],"editor":"stringList"},{"name":"maxVideosPerQuery","title":"Max videos per keyword","type":"integer","required":false,"description":"How many videos to return per keyword (1–300). Each delivered video is one charged event, plus one page event per results page.","default":30,"prefill":10,"minimum":1,"maximum":300},{"name":"sortBy","title":"Sort","type":"string","required":false,"description":"Result order.","default":"relevance","enum":["relevance","most-liked","date-posted"],"editor":"select"},{"name":"datePosted","title":"Period","type":"string","required":false,"description":"Only videos posted within this period.","default":"all-time","enum":["all-time","yesterday","this-week","this-month","last-3-months","last-6-months"],"editor":"select"},{"name":"region","title":"Proxy country","type":"string","required":false,"description":"Optional 2-letter country code (US, GB, FR…). Routes the search through that country so country-restricted videos can appear; it does not filter results by country.","editor":"textfield"},{"name":"maxQueries","title":"Max keywords","type":"integer","required":false,"description":"Safety cap on the number of keywords processed in this run.","default":100,"minimum":1,"maximum":1000},{"name":"concurrency","title":"Concurrency","type":"integer","required":false,"description":"How many keywords are fetched in parallel (1–8).","default":4,"minimum":1,"maximum":8},{"name":"itemTimeoutSecs","title":"Time limit per input (seconds)","type":"integer","required":false,"description":"Pagination for one keyword stops cleanly shortly before this limit (60–3600). Raise it for very large per-input limits.","default":600,"minimum":60,"maximum":3600},{"name":"includeRaw","title":"Include raw upstream response","type":"boolean","required":false,"description":"Attach the unmodified provider object to each result record.","default":false}]},"exampleInput":{"keywords":["cooking hacks"],"maxVideosPerQuery":10},"outputFields":[{"name":"input","type":"string | object","title":"Input","description":"The keyword as provided."},{"name":"recordType","type":"string","title":"Record type","description":"video (one per delivered video, charged) | query (one summary per keyword, never charged)","example":"video"},{"name":"position","type":"integer","title":"Position","description":"1-based position of the video within its input"},{"name":"query","type":"string | null","title":"Keyword"},{"name":"sortBy","type":"string","title":"Sort","description":"Summary records only."},{"name":"datePosted","type":"string","title":"Period","description":"Summary records only."},{"name":"region","type":"string | null","title":"Region","description":"Video region (rows) or proxy region filter (summary)."},{"name":"videoId","type":"string | null","title":"Video ID"},{"name":"url","type":"string | null","title":"Video URL"},{"name":"description","type":"string | null","title":"Caption"},{"name":"createdAt","type":"string | null","title":"Created at","description":"ISO 8601 UTC"},{"name":"durationSecs","type":"number | null","title":"Duration (s)"},{"name":"plays","type":"number | null","title":"Plays"},{"name":"likes","type":"number | null","title":"Likes"},{"name":"comments","type":"number | null","title":"Comments"},{"name":"shares","type":"number | null","title":"Shares"},{"name":"saves","type":"number | null","title":"Saves"},{"name":"coverUrl","type":"string | null","title":"Cover URL"},{"name":"musicTitle","type":"string | null","title":"Music title"},{"name":"musicAuthor","type":"string | null","title":"Music author"},{"name":"hashtags","type":"array","title":"Hashtags"},{"name":"mentions","type":"array","title":"Mentions"},{"name":"isAd","type":"boolean | null","title":"Ad"},{"name":"authorHandle","type":"string | null","title":"Author handle"},{"name":"authorId","type":"string | null","title":"Author ID"},{"name":"authorNickname","type":"string | null","title":"Author nickname"},{"name":"rowsDelivered","type":"integer","title":"Videos delivered","description":"Summary records only."},{"name":"pagesFetched","type":"integer","title":"Pages fetched","description":"Summary records only."},{"name":"pagesCharged","type":"integer","title":"Pages charged","description":"Summary records only."},{"name":"reachedEnd","type":"boolean","title":"Reached end","description":"Summary records only: the upstream reported no further pages."},{"name":"stopReason","type":"string","title":"Stop reason","description":"Summary records only: limit | end | budget | max_pages | deadline | empty_pages | error"},{"name":"status","type":"string","title":"Status","description":"ok | not_found | error | skipped_invalid | skipped_budget | skipped_free_plan","example":"ok"},{"name":"charged","type":"boolean","title":"Charged"},{"name":"chargedEvent","type":"string","title":"Charged event"},{"name":"error","type":"object","title":"Error"},{"name":"warnings","type":"array","title":"Warnings"},{"name":"source","type":"string","title":"Source"},{"name":"fetchedAt","type":"string","title":"Fetched at"}],"outputExample":{"input":"nursing","recordType":"video","position":1,"query":"nursing","videoId":"7268287584244124971","url":"https://www.tiktok.com/@thatgreygentlemanitdxz/video/7268287584244124971","description":"Tìm 'musclesandnursing'","createdAt":"2023-08-17T13:48:40.000Z","durationSecs":23,"plays":1282645,"likes":481608,"comments":187,"shares":2721,"saves":6978,"coverUrl":"https://p16-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/….jpeg","musicTitle":null,"musicAuthor":null,"hashtags":[],"mentions":[],"isAd":false,"region":"US","authorHandle":"thatgreygentlemanitdxz","authorId":"7267964228375413803","authorNickname":"thatgreygentlemanitdxz","status":"ok","charged":true,"chargedEvent":"tiktok-search-result","source":"scrapecreators","fetchedAt":"2026-10-14T10:00:00.000Z"},"faq":[],"mcpExamplePrompt":"Search TikTok for \"cooking hacks\" videos from this month and list the 20 most liked, with author, plays and hashtags.","related":["tiktok-user-videos","tiktok-video-comments","tiktok-account-audit","youtube-search"],"urls":{"site":"https://www.sfoln.com/actors/tiktok-search/","siteJson":"https://www.sfoln.com/actors/tiktok-search.json","siteMarkdown":"https://www.sfoln.com/actors/tiktok-search.md","runSync":"https://api.apify.com/v2/actors/sfoln~tiktok-search/run-sync-get-dataset-items","runAsync":"https://api.apify.com/v2/actors/sfoln~tiktok-search/runs","mcp":"https://mcp.apify.com?tools=sfoln/tiktok-search","requestAccess":"mailto:contact@sfoln.com?subject=Access%20request%3A%20TikTok%20Search%20Scraper%20%E2%80%93%20Videos%20by%20Keyword%20(sfoln%2Ftiktok-search)&body=Please%20publish%20tiktok-search.%20What%20we%20plan%20to%20use%20it%20for%3A"},"publisher":{"name":"SFOLN LLC","apifyUsername":"sfoln","url":"https://www.sfoln.com","apifyProfile":"https://apify.com/sfoln","email":"contact@sfoln.com"},"generatedAt":"2026-10-22T04:28:58.477Z"}