TikTok Products Crawler ## Overview The TikTok Products Crawler is an Actor designed to scrape product-related data from TikTok videos. Given a list of video URLs, this crawler extracts relevant information while supporting authenticated requests through TikTok cookies. ## Input Schema The crawler requires the following input parameters: ### Required Parameters - startUrls (array) - List of TikTok video URLs to start crawling from. - Example: json [ { "url": "https://www.tiktok.com/@homie_slander/video/7483601939955993886" } ] - cookies (string) - TikTok authentication cookies in JSON format. This is required to access logged-in functionality. - You can obtain these cookies using the EditThisCookie Chrome extension. ### Optional Parameters - maxRequestsPerCrawl (integer) - Maximum number of requests the crawler will make before stopping. - Default: 3 ## How to Use 1. Go to the Apify Console. 2. Create a new task for the TikTok Products Crawler Actor. 3. Provide the required startUrls and cookies in the input configuration. 4. Optionally, adjust the maxRequestsPerCrawl parameter to limit the number of requests. 5. Run the Actor and retrieve the scraped data from the dataset output. ## Output The output dataset contains the extracted product-related information from the specified TikTok videos in JSON format. ### Example Output json { "url": "https://www.tiktok.com/@homie_slander/video/7483601939955993886", "id": "7483601939955993886", "description": "Is this illegal? #tiktokshop #phonemount #cartok #caraccessories #carphoneholder ", "createTime": "2025-03-19T19:17:48.000Z", "authorInfo": { "id": "7337437215033148459", "uniqueId": "homie_slander", "nickname": "The Smarter Shopper", "avatarUrl": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast5-avt-0068-tx/b6eb7095bf4b8e6f010943f88e51ec46~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=9640&refresh_token=151cebeb&x-expires=1743256800&x-signature=VVkd208Tu2IhJCVx%2Bc2VbaiDN%2Fo%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=useast8", "signature": "Shop smarter with TikTok shop!", "followingCount": 21, "followerCount": 72000, "heartCount": 6300000, "videoCount": 1025 }, "videoStats": { "playCount": 652200, "diggCount": 3843, "shareCount": 139, "commentCount": 55, "collectCount": "769" }, "videoUrl": "https://v16-webapp-prime.us.tiktok.com/video/tos/useast8/tos-useast8-ve-0068c002-tx2/o8GspabVIR4G7i6B0AQErAOiGJZ91CEWjGvQB/?a=1988&bti=ODszNWYuMDE6&ch=0&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C&cv=1&br=3778&bt=1889&cs=0&ds=6&ft=4KJMyMzm8Zmo0FQKvb4jVKxuQpWrKsd.&mime_type=video_mp4&qs=0&rc=ZTtnZTQzNWVkNTM5OTg2aUBpamg3ZHQ5cnJreTMzaTczNEAzLy42MjIvXjIxYTQyLTFjYSNuYHEuMmRrYWFgLS1kMTJzcw%3D%3D&btag=e00088000&expire=1743258439&l=20250327142650921D9D8D121A06058AB5&ply_type=2&policy=2&signature=4d55b3ec83b9e11f5fc9e2ac56801bb2&tk=tt_chain_token", "musicInfo": { "id": "7483601849271634718", "title": "original sound", "authorName": "The Smarter Shopper", "playUrl": "https://v16m.tiktokcdn-us.com/715b4cdfdd3b2a04dbbbc711a2e8e49e/67e5b4a7/video/tos/useast8/tos-useast8-v-27dcd7-tx2/oY18iMfBqEwbE7zKWGEBD7xYbAFBqiwAiAAuEA/?a=1233&bti=ODszNWYuMDE6&ch=0&cr=0&dr=0&er=0&lr=default&cd=0%7C0%7C0%7C0&br=250&bt=125&ds=5&ft=GSDrKInz7ThpZYyOXq8Zmo&mime_type=audio_mpeg&qs=13&rc=amttaWo5cnFreTMzaTU8NEBpamttaWo5cnFreTMzaTU8NEAtay5fMmRjZGFgLS1kMTJzYSMtay5fMmRjZGFgLS1kMTJzcw%3D%3D&vvpl=1&l=20250327142650921D9D8D121A06058AB5&btag=e00048000" }, "hashtags": [ { "name": "tiktokshop", "id": "1613123321562117" }, { "name": "phonemount", "id": "1624569764613126" }, { "name": "cartok", "id": "10133652" }, { "name": "caraccessories", "id": "1599525860172801" }, { "name": "carphoneholder", "id": "1631780663273473" } ] } ## Authentication Since TikTok restricts certain data to logged-in users, you must provide authentication cookies to access all relevant content. Ensure your cookies are valid and up-to-date before running the crawler. ## Notes - Excessive crawling may trigger TikTok’s rate-limiting mechanisms. - Excessive crawling may trigger TikTok’s ban on your account. ## Support If you encounter any issues or have feature requests, feel free to reach out through the Issues tab.