TikTok Ad Library Scraper Scrape Ad Library data from TikTok easily with TikTok Ad Library Scraper. ## About TikTok, known in mainland China and Hong Kong as Douyin (Chinese: 抖音; pinyin: Dǒuyīn; lit. 'Shaking Sound'), is a social media and short-form online video platform owned by Chinese Internet company ByteDance. It hosts user-submitted videos, which may range in duration from three seconds to 60 minutes. It can be accessed through a mobile app or through its website. Since its launch, TikTok has become one of the world's most popular social media platforms, using recommendation algorithms to connect content creators and influencers with new audiences. ## Why should you use it? It provides a structured way to access TikTok Ad Library data, enabling easy processing without the need for login credentials or session cookies. ## How to use In order to use TikTok Ad Library Scraper you need to provide number of results that you want to scrape from TikTok. Next go to TikTok Ad Library. Do search that you want. Copy the URL and set it as input paramter for the scraper. Example of valid URLs for scraping: - https://library.tiktok.com/ads?region=AT&start_time=1664575200000&end_time=1743626023752&adv_name=&adv_biz_ids=&query_type=&sort_type=last_shown_date,desc - https://library.tiktok.com/ads?region=AT&start_time=1664575200000&end_time=1743626023752&adv_name=%22jetbrains%22&adv_biz_ids=&query_type=1&sort_type=last_shown_date,desc - https://library.tiktok.com/ads?region=AT&start_time=1664575200000&end_time=1743626023752&adv_name=JETBRAINS%20S.R.O.&adv_biz_ids=7028872473361777410&query_type=2&sort_type=last_shown_date,desc - https://library.tiktok.com/ads/detail/?ad_id=1820859151010817 ### Examples #### Input json { "urls": [ { "url": "https://library.tiktok.com/ads?region=AT&start_time=1664575200000&end_time=1743626023752&adv_name=JETBRAINS%20S.R.O.&adv_biz_ids=7028872473361777410&query_type=2&sort_type=last_shown_date,desc", "method": "GET" }, { "url": "https://library.tiktok.com/ads/detail/?ad_id=1820859151010817", "method": "GET" } ], "maxRecords": 100 } #### Output json { "url": "https://library.tiktok.com/api/v1/items/1820859151010817/details?lang=en-US", "id": "1820859151010817", "name": "JetBrains s.r.o.", "auditStatus": "1", "type": "2", "firstShownDate": { "date": "2025-01-11T00:00:00.000Z", "timestamp": 1736553600000 }, "lastShownDate": { "date": "2025-02-03T00:00:00.000Z", "timestamp": 1738540800000 }, "videos": [ { "videoUrl": "https://library.tiktok.com/api/v1/cdn/1743532704/video/aHR0cHM6Ly92MTZtLnRpa3Rva2Nkbi5jb20vNmVkNmQ4OGY1N2Y5MDkyYTZmMjU1MjVhZmYzYmFlOWMvNjdlYzg3MmUvdmlkZW8vdG9zL2FsaXNnL3Rvcy1hbGlzZy12ZS0wMDUxYzAwMS1zZy9vMDlQWXNEZVFGQVVJektBc2dFQVNlWkdNNmZFZnNhQmVncmNBTC8=/f198446c-9a12-4fce-bbc6-cfd4c3dd17dc?a=475769&bti=PDU2NmYwMy86&ch=0&cr=0&dr=1&cd=0%7C0%7C0%7C0&cv=1&br=1108&bt=554&cs=0&ds=1&ft=.NpOcInz7ThRvJ5OXq8Zmo&mime_type=video_mp4&qs=0&rc=Njo2OGQ2NTo6ZWkzN2c3NEBpMzhuZnc5cjppeDMzODYzNEAwLy8uMzAvNmAxYTRhYTNhYSNvYy5jMmRraS1gLS1kMC1zcw%3D%3D&vvpl=1&l=202504011838236AB9ABF49C554F8C5418&btag=e00088000&cc=3", "coverImage": "https://p21-ad-sg.ibyteimg.com/origin/tos-alisg-p-0051c001-sg/o0oAgLeeA9UZf6Aes1sKMParqEQOIBFBd0qAfD" } ], "estimatedAudience": { "estimated": "100K-200K", "from": 100000, "to": 200000 }, "spent": "", "impression": 0, "showMode": 1, "imageUrls": ["https://p21-ad-sg.ibyteimg.com/origin/tos-alisg-p-0051c001-sg/o0oAgLeeA9UZf6Aes1sKMParqEQOIBFBd0qAfD"], "rejectionInfo": null, "advertiser": { "name": "JetBrains s.r.o.", "advBizId": "7028872473361777410", "registryLocation": "Czech Republic", "sponsor": "JetBrains s.r.o." }, "targeting": { "audience": "No", "interest": "", "videoInteractions": "", "creatorInteractions": "", "targetAudienceSize": { "estimated": "62.2M-76.1M", "from": 62200000, "to": 76100000 }, "byGeneder": [ { "region": "ES", "female": true, "male": true, "unknown": true }, { "region": "CH", "female": true, "male": true, "unknown": true }, { "region": "PT", "female": true, "male": true, "unknown": true }, { "region": "EE", "female": true, "male": true, "unknown": true }, { "region": "LT", "female": true, "male": true, "unknown": true }, { "region": "BE", "female": true, "male": true, "unknown": true }, { "region": "FI", "female": true, "male": true, "unknown": true }, { "region": "IE", "female": true, "male": true, "unknown": true }, { "region": "SE", "female": true, "male": true, "unknown": true }, { "region": "AT", "female": true, "male": true, "unknown": true }, { "region": "DK", "female": true, "male": true, "unknown": true }, { "region": "NL", "female": true, "male": true, "unknown": true }, { "region": "FR", "female": true, "male": true, "unknown": true }, { "region": "NO", "female": true, "male": true, "unknown": true }, { "region": "DE", "female": true, "male": true, "unknown": true }, { "region": "IT", "female": true, "male": true, "unknown": true }, { "region": "LV", "female": true, "male": true, "unknown": true } ], "byAge": [ { "region": "ES", "13-17": false, "18-24": false, "25-34": true, "35-44": true, "45-54": true, "55+": false }, { "region": "CH", "13-17": false, "18-24": false, "25-34": true, "35-44": true, "45-54": true, "55+": false }, { "region": "PT", "13-17": false, "18-24": false, "25-34": true, "35-44": true, "45-54": true, "55+": false }, { "region": "EE", "13-17": false, "18-24": false, "25-34": true, "35-44": true, "45-54": true, "55+": false }, { "region": "LT", "13-17": false, "18-24": false, "25-34": true, "35-44": true, "45-54": true, "55+": false }, { "region": "BE", "13-17": false, "18-24": false, "25-34": true, "35-44": true, "45-54": true, "55+": false }, { "region": "FI", "13-17": false, "18-24": false, "25-34": true, "35-44": true, "45-54": true, "55+": false }, { "region": "IE", "13-17": false, "18-24": false, "25-34": true, "35-44": true, "45-54": true, "55+": false }, { "region": "SE", "13-17": false, "18-24": false, "25-34": true, "35-44": true, "45-54": true, "55+": false }, { "region": "AT", "13-17": false, "18-24": false, "25-34": true, "35-44": true, "45-54": true, "55+": false }, { "region": "DK", "13-17": false, "18-24": false, "25-34": true, "35-44": true, "45-54": true, "55+": false }, { "region": "NL", "13-17": false, "18-24": false, "25-34": true, "35-44": true, "45-54": true, "55+": false }, { "region": "FR", "13-17": false, "18-24": false, "25-34": true, "35-44": true, "45-54": true, "55+": false }, { "region": "NO", "13-17": false, "18-24": false, "25-34": true, "35-44": true, "45-54": true, "55+": false }, { "region": "DE", "13-17": false, "18-24": false, "25-34": true, "35-44": true, "45-54": true, "55+": false }, { "region": "IT", "13-17": false, "18-24": false, "25-34": true, "35-44": true, "45-54": true, "55+": false }, { "region": "LV", "13-17": false, "18-24": false, "25-34": true, "35-44": true, "45-54": true, "55+": false } ], "byLocation": { "regions": 17, "totalImpressions": { "estimated": "100K-200K", "from": 100000, "to": 200000 }, "totalRegion": [ { "region": "ES", "impressions": { "estimated": "24K", "from": 24000 } }, { "region": "CH", "impressions": { "estimated": "0-1K", "from": 0, "to": 1000 } }, { "region": "PT", "impressions": { "estimated": "16K", "from": 16000 } }, { "region": "EE", "impressions": { "estimated": "3K", "from": 3000 } }, { "region": "LT", "impressions": { "estimated": "12K", "from": 12000 } }, { "region": "BE", "impressions": { "estimated": "7K", "from": 7000 } }, { "region": "FI", "impressions": { "estimated": "3K", "from": 3000 } }, { "region": "IE", "impressions": { "estimated": "5K", "from": 5000 } }, { "region": "SE", "impressions": { "estimated": "11K", "from": 11000 } }, { "region": "AT", "impressions": { "estimated": "3K", "from": 3000 } }, { "region": "DK", "impressions": { "estimated": "2K", "from": 2000 } }, { "region": "NL", "impressions": { "estimated": "8K", "from": 8000 } }, { "region": "FR", "impressions": { "estimated": "15K", "from": 15000 } }, { "region": "NO", "impressions": { "estimated": "3K", "from": 3000 } }, { "region": "DE", "impressions": { "estimated": "4K", "from": 4000 } }, { "region": "IT", "impressions": { "estimated": "26K", "from": 26000 } }, { "region": "LV", "impressions": { "estimated": "7K", "from": 7000 } } ] } } } ## TikTok Ad Library Scraper data output The output from TikTok Ad Library Scraper is stored in the dataset. After the run is finished, you can download the dataset in various data formats (JSON, CSV, XML, RSS, HTML Table). ## ❓FAQ ### Do I need proxies to scrape ads from TikTok? Proxy for this scraper is already preconfigured for optimal performance. ## Support For more custom/simplify outputs or Bug report please contact the developer (ivan.vasiljevic (at) hotmail.com) or report an issue.