🔍 TikTok Ads Library Scraper

Transform your ad intelligence with our TikTok Ads Library scraper! Whether you're analyzing competitor strategies, monitoring brand campaigns, or conducting market research, this tool efficiently collects and structures advertising data from TikTok's Ad Library.

💎 Why Choose Our TikTok Ads Scraper?

• 🎯 Advanced Search Options: Find ads by advertiser name, exact match, or advertiser ID
• 🚀 High-Volume Collection: Gather up to hundreds of ads in a single run with optimized pagination
• 🌐 Global Coverage: Access ads from multiple regions with support for all TikTok-supported countries
• 📊 Rich Ad Details: Extract comprehensive ad information including media URLs, dates, and performance metrics
• 🖼️ Media Access: Capture links to all ad creative assets including videos and images

🔮 How to Power Up Your Search Queries?

• 1. 🔤 Keyword Search : Search for ads containing specific words or phrases in their content
• 2. 🎯 Exact Match Search : For precise targeting, wrap your search term in quotes to find exact matches
• 3. 🆔 Advertiser ID Search : Search directly by TikTok advertiser ID for complete campaign analysis

✨ What You'll Get

📰 News Data Structure

Field	Description
AD ID	Unique identifier for the ad
Advertiser Name	Name of the company/entity running the ad
Ad Dates	First and last shown dates with timestamps
Ad Audience	Estimated audience information
Ad Details	Comprehensive details including spend, type, audit status, and impressions
Ad Media	URLs to all creative assets (videos, images, cover images)
Ad Region	Region where the ad was displayed

🚀 Performance Features

⚡️ Lightning Fast:

• Efficient proxy rotation
• Optimized resource usage
• Smart retry mechanism

🛠️ Smart Handling:

• Automatic URL standardization
• Proxy health monitoring

🌍 Global Coverage:

• Works with any TikTok-supported region
• Standardizes output format

📋 Quick Start

Input Parameters

Parameter	Type	Default	Description
region	string	"all"	Region code for which you want to scrape ads
startDate	string	"2025-01-01"	Start date for ads (format: YYYY-MM-DD)
endDate	string	""	End date for ads (empty for current date)
query	string	""	Search query (keyword, advertiser name, or ID)
queryType	string	"2"	Query type (1=Keyword, 2=Advertiser Name/ID)
maxAds	number	20	Maximum number of ads to scrape
proxyConfiguration	object	{useApifyProxy: true}	Proxy configuration

Input Example

1{
2  "region": "US",
3  "startDate": "2025-01-01",
4  "endDate": "2025-03-01",
5  "query": "\"NETFLIX\"",
6  "queryType": "2",
7  "maxAds": 100,
8  "proxyConfiguration": {
9    "useApifyProxy": true
10  }
11}

Output Example

1[
2  {
3    "AD ID": "1820020351685681",
4    "Advertiser Name": "Bouazza Helmi",
5    "AD Preview": "https://p21-ad-sg.ibyteimg.com/origin/tos-alisg-p-0051c001-sg/okrEGLAREFAKi4BAIb7DgCu8Z5zLfeNwhDWfC8",
6    "Ad Dates": [
7      {
8        "FirstShown": "2025-01-01",
9        "FirstShownTimestamp": 1735689600
10      },
11      {
12        "LastShown": "2025-03-08",
13        "LastShownTimestamp": 1741392000
14      }
15    ],
16    "Ad Audience": "100K-200K",
17    "Ad Details": [
18      {
19        "Estimated Audience": "100K-200K"
20      },
21      {
22        "Spent": ""
23      },
24      {
25        "Type": "2"
26      },
27      {
28        "Audit Status": "1"
29      },
30      {
31        "Impression": ""
32      },
33      {
34        "Sponsor": "Digital Marketing Agency"
35      },
36      {
37        "Target Audience Size": "5.2M-6.4M"
38      }
39    ],
40    "Ad Media": [
41      "Video 1: https://library.tiktok.com/api/v1/cdn/1741534040/video/aHR0cHM6Ly92MTZtLnRpa3Rva2Nkbi5jb20vMDkzMTJhY2RkZDRhYTI1ODhlZmYwZTIwYTYzOTI1NWEvNjdjZTA3Y2MvdmlkZW8vdG9zL2FsaXNnL3Rvcy1hbGlzZy12ZS0wMDUxYzAwMS1zZy9vNER3SGdUQ0VDODR1SUVQOGZiekcyZURUZkJSWkE1V1FLQUJGTi8=/f8eb26d4-832d-465a-a583-9f16dda4eeac?a=475769&bti=PDU2NmYwMy86&ch=0&cr=0&dr=1&cd=0%7C0%7C0%7C0&cv=1&br=908&bt=454&cs=0&ds=1&ft=.NpOcInz7ThMe2OOXq8Zmo&mime_type=video_mp4&qs=0&rc=ZTllOjM8NTtoZ2Y7N2dmZEBpanN1OHg5cmpmdTMzODYzNEAvYC0xM18zXmMxYzQvNC0zYSM1bWkyMmRrc2xgLS1kMC1zcw%3D%3D&vvpl=1&l=2025030915271919A020BE52B2A1947586&btag=e000b8000&cc=3",
42      "Cover 1: https://p21-ad-sg.ibyteimg.com/origin/tos-alisg-p-0051c001-sg/okrEGLAREFAKi4BAIb7DgCu8Z5zLfeNwhDWfC8",
43      "Image 1: https://p21-ad-sg.ibyteimg.com/origin/tos-alisg-p-0051c001-sg/okrEGLAREFAKi4BAIb7DgCu8Z5zLfeNwhDWfC8"
44    ],
45    "Ad Targeting": {
46      "regions": [
47        {
48          "region": "FR",
49          "impressions": "152K"
50        }
51      ],
52      "age": [
53        {
54          "region": "FR",
55          "13-17": false,
56          "18-24": true,
57          "25-34": true,
58          "35-44": true,
59          "45-54": false,
60          "55+": false
61        }
62      ],
63      "gender": [
64        {
65          "region": "FR",
66          "female": true,
67          "male": true,
68          "unknown": false
69        }
70      ]
71    },
72    "Ad Sponsor": "Digital Marketing Agency",
73    "Ad Target Audience Size": "5.2M-6.4M",
74    "Ad Detail URL": "https://library.tiktok.com/ads/detail/?ad_id=1820020351685681"
75  }
76]

🤝 Support & Resources

Need help? Have questions? We're here to help! If you encounter any issues or have feature requests, please don't hesitate to open an issue.

❤️ Love our scraper? Please leave a review here