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
• Targeting data (first-party audience, interests, video/creator interactions)
• Audience size and reach range

📖 How to use

⬇️ Input

The input should be a TikTok Ads Library URL. For example:

{
    "startUrls": [
        {
            "url": "https://library.tiktok.com/ads?region=all&start_time=1759273200000&end_time=1774911600000&adv_name=NVIDIA%20GmbH&adv_biz_ids=6891503886842987266&query_type=2&sort_type=create_time,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.

⚠️ Warning: There is a known pagination bug in TikTok Ads Library itself (including in TikTok's own UI), not in this scraper. It is highly recommended to set sort_type=create_time,desc in your Ads Library URL before running, to reduce duplicates and missing ads.

⬆️ 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:

{
    "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
        },
        "firstPartyAudience": true,
        "interests": ["Food & Beverage", "Games"],
        "videoInteractions": null,
        "creatorInteractions": null,
        "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"
            }
        ]
    },
    "reach": {
        "lowerBound": 700000,
        "upperBound": 800000
    },
    "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.

❓ Why are some ads missing from my results?

This is usually caused by a known pagination bug in TikTok Ads Library itself (including in TikTok's own UI), not by this scraper. TikTok’s default sorting can be unstable when many ads share the same last shown date, so ads may shift positions between paginated requests, leading to skipped ads and duplicates.

It is highly recommended to use sort_type=create_time,desc in the Ads Library URL before starting the run, to reduce missing ads and duplicates.

⚖️ 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.