TikTok Ads Scraper ## 🔎 What is the TikTok Ads Scraper? This powerful tool allows you to extract data from the TikTok Ads Library, providing you with structured and ready-to-use information from public ad campaigns. To get started, simply insert a URL from the TikTok Ads Library and click the "Save & Start" button. ## 📊 What TikTok ads data can I extract? The scraper supports all TikTok ad formats and extracts detailed information about each ad, including: - Advertiser name - Video URL - Thumbnail URL - Countries where the ad was shown - Total impressions ## 📖 How to use ### ⬇️ Input The input should be a TikTok Ads Library URL. For example: json { "startUrls": [ { "url": "https://library.tiktok.com/ads?region=all&start_time=1735689600000&end_time=1745967600000&adv_name=NVIDIA%20GmbH&adv_biz_ids=6891503886842987266&query_type=2&sort_type=last_shown_date,desc" } ] } You can refine your search in the TikTok Ads Library using filters (e.g., region, dates, keywords) and use the resulting page’s URL as the input. ### ⬆️ Output The extracted data will be available in the Storage tab and can be downloaded in JSON, JSONL, Excel, HTML, CSV, or XML formats. This allows for seamless integration with tools like Clay, ChatGPT, or your automation workflows. Here’s an example output: json { "adId": "1827012309655633", "adName": "NVIDIA GmbH", "advertiserId": "6891503886842987266", "advertiserName": "NVIDIA GmbH", "impressions": { "lowerBound": 10000, "upperBound": 100000 }, "paidBy": "WEB MEDIA PUBLISHING AG", "regionStats": [ { "regionCode": "CH", "impressions": 1000 }, { "regionCode": "DE", "impressions": 12000 }, { "regionCode": "AT", "impressions": 7000 } ], "startUrl": "https://library.tiktok.com/ads?region=all&start_time=1735689600000&end_time=1745967600000&adv_name=NVIDIA%20GmbH&adv_biz_ids=6891503886842987266&query_type=2&sort_type=last_shown_date,desc", "targeting": { "audienceSize": { "lowerBound": 25300000, "upperBound": 30900000 }, "regions": [ { "ageRanges": ["18-24", "25-34", "35-44", "45-54", "55+"], "genders": ["female", "male", "unknown"], "regionCode": "CH" }, { "ageRanges": ["18-24", "25-34", "35-44", "45-54", "55+"], "genders": ["female", "male", "unknown"], "regionCode": "DE" }, { "ageRanges": ["18-24", "25-34", "35-44", "45-54", "55+"], "genders": ["female", "male", "unknown"], "regionCode": "AT" } ] }, "tiktokUser": { "username": "gameswelt", "displayName": "Gameswelt.de", "avatarUrl": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/7329929364551860230~tplv-tiktokx-cropcenter:168:168.jpeg?dr=10397&refresh_token=ffcf06a0&x-expires=1751043600&x-signature=3RL9qUu9oBIXNeg4sEUW5TCfeoI%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=8aecc5ac&idc=no1a", "followersCount": 151400, "profileUrl": "https://www.tiktok.com/share/user/6593284861262495750?source=ad_review" }, "videos": [ { "url": "https://library.tiktok.com/api/v1/cdn/1750873797/video/aHR0cHM6Ly92MTZtLnRpa3Rva2Nkbi5jb20vYzdkNDI3NmQ5NGYzOTQ1MGJhODc0M2I0MmI0MThmYTUvNjg1YzhiNWIvdmlkZW8vdG9zL25vMWEvdG9zLW5vMWEtdmUtMDA2OC1uby9vNFF6aGptZlZuRWF6a0ZNQk1EYWZzRm5icjYyZ0EySWRDZ0hFQy8=/3ee2ccdb-0bff-4b77-8137-b08e252b482d?a=475769&bti=PDU2NmYwMy86&ch=0&cr=0&dr=1&cd=0%7C0%7C0%7C0&cv=1&br=2250&bt=1125&cs=0&ds=6&ft=.NpOcInz7ThQ1JDKXq8Zmo&mime_type=video_mp4&qs=0&rc=aDU8NmhpN2U1aTxmOTlpOkBpM21zZnU5cjs6eTMzbzgzNUAuNGBjNS9gNjAxLjVeNTEuYSNnczE0MmRzamFgLS1kLzFzcw%3D%3D&vvpl=1&l=2025062517495627AB5FE6F94D077EEE6D&btag=e00088000&cc=3", "coverImageUrl": "https://p16-vod-sign-useast2a.tiktokcdn-eu.com/tos-no1a-p-0037-no/osALbZPQaCnGPDZgAHIqPeI2LEArrEtsjMf7eQ~tplv-noop.image?t=9276707c&x-expires=1750895451&x-signature=dLg4O4R34L9UuNI4Y%2BpG0hdGwdI%3D" } ] } ## ❓ Frequently Asked Questions (FAQs) ### ♾️ How many ads can you scrape with TikTok Ads Scraper? As many as you like! The scraper will scroll through the list of ads until it reaches the end, automatically loading all available results. ### ➡️ Can I use this scraper with Clay? Absolutely! You can integrate this scraper into your Clay workflows to enrich your data tables with TikTok ad insights. To do this, simply connect it using Apify’s API and follow Clay’s Apify integration guide for setup. ### ⚖️ Is it legal to scrape TikTok Ads data? Scraping TikTok Ads is legal as long as you adhere to regulations concerning scraping, copyright and personal data. If you're unsure whether your reason is legitimate, consult your lawyers. You should not scrape data unless you have a legitimate reason to do so. You can also read Apify's blog post on the legality of web scraping and ethical scraping. ## 👥 Scrape More Ad Libraries Interested in other ad platforms? Check out: Google Ads Scraper LinkedIn Ads Scraper ## 💬 Your feedback If you have any feedback, questions, or feature requests, please reach out via the Issues tab. Your input helps make this scraper better for everyone.