TikTok Ads Library Scraper

Extract public TikTok Creative Center Top Ads into a clean dataset for competitive ad research, creative inspiration, and campaign monitoring.

What does TikTok Ads Library Scraper do?

TikTok Ads Library Scraper collects public ad creative records from TikTok Creative Center Top Ads.

It helps you turn visible TikTok ad examples into structured data.

You can search by keyword.

You can select markets such as US, GB, DE, FR, BR, JP, or AU.

You can choose a time period.

You can limit the number of ads saved.

Each result includes ad text, identifiers, creative media links, filter context, and public performance labels when TikTok provides them.

Who is it for?

Performance marketers use it to watch competitor creatives.

Ecommerce brands use it to discover hooks and offers that are working on TikTok.

Agencies use it to prepare creative research decks.

Growth teams use it to monitor ad trends in target regions.

Researchers use it to analyze public advertising patterns.

Founders use it to quickly understand how similar products are promoted.

Why use this actor?

🧠 Find creative angles faster.

📊 Export TikTok ad examples to spreadsheets or BI tools.

🌎 Compare ads across markets.

🔎 Search by brand, product, or topic keywords.

⏱️ Save manual browsing time.

🧩 Combine TikTok ad intelligence with your own campaign notes.

What data can it extract?

Field	Description
adId	TikTok Creative Center ad identifier
detailUrl	Public Creative Center detail URL
brandName	Brand name when available
advertiserName	Advertiser name when available
adText	Public ad title or caption text
landingPageUrl	Landing page URL when available
videoUrl	Public creative video URL when available
coverImageUrl	Creative thumbnail image
durationSeconds	Video duration
likes	Public like count label when available
ctr	Public CTR metric when available
costIndex	Public cost index when available
industryKey	TikTok industry key
objectiveKey	TikTok objective key
countryCode	Market used for the search
keyword	Keyword used for the search
scrapedAt	Timestamp of extraction

How much does it cost to scrape TikTok ads?

The actor uses pay-per-event pricing.

There is a small start event for each run.

There is a per-result event for each ad record saved.

For a small research run, set maxItems to 20.

For broader monitoring, increase maxItems after you confirm the filters return useful data.

Exact pricing is shown on the Apify actor page before you start a run.

How to scrape TikTok ads

1. Open the actor on Apify.

2. Enter one or more keywords, for example skincare, game, or running shoes.

3. Add one or more region codes, for example US.

4. Choose a period such as the last 7 or 30 days.

5. Set maxItems.

6. Start the run.

7. Export the dataset as JSON, CSV, Excel, XML, RSS, or HTML.

Input configuration

keywords

Optional keyword searches.

Leave empty to collect general top ads for the selected region.

regions

Country codes used by TikTok Creative Center.

Examples: US, GB, DE, FR, BR, JP, AU.

period

Supported values are 7, 30, 120, and 180 days.

maxItems

Global maximum number of ads saved.

Use a small value for the first run.

languages

Optional language filters such as en, es, de, fr, pt, or ja.

industries and objectives

Optional TikTok Creative Center filter keys.

Leave empty unless you already know the keys you need.

Example input

{
  "keywords": [],
  "regions": ["US"],
  "period": "7",
  "sortBy": "for_you",
  "maxItems": 20
}

Example output

{
  "adId": "7652301642913873941",
  "detailUrl": "https://ads.tiktok.com/business/creativecenter/topads/7652301642913873941",
  "brandName": null,
  "adText": "Example public TikTok ad text...",
  "videoUrl": "https://...",
  "coverImageUrl": "https://...",
  "likes": 1779,
  "ctr": 0.43,
  "countryCode": "US",
  "keyword": "coffee",
  "periodDays": 7,
  "scrapedAt": "2026-06-27T00:00:00.000Z"
}

Tips for better results

Start with one country and one keyword.

Use short product category keywords.

Try both branded and generic searches.

Compare periods to see whether creatives are recent or persistent.

If a keyword returns few ads, broaden the term.

If you need trend monitoring, schedule the actor to run weekly.

Integrations

Send results to Google Sheets for creative review.

Export CSV for media buying analysis.

Connect datasets to Make or Zapier for alerts.

Use Apify webhooks to notify your team when a scheduled run finishes.

Store historical datasets to compare creative changes over time.

Join results with your own product taxonomy in a warehouse.

API usage

Node.js

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: process.env.APIFY_TOKEN });
const run = await client.actor('fetch_cat/tiktok-ads-library-scraper').call({
  keywords: [],
  regions: ['US'],
  period: '7',
  maxItems: 20
});
console.log(run.defaultDatasetId);

Python

from apify_client import ApifyClient

client = ApifyClient('MY-APIFY-TOKEN')
run = client.actor('fetch_cat/tiktok-ads-library-scraper').call(run_input={
    'keywords': [],
    'regions': ['US'],
    'period': '7',
    'maxItems': 20,
})
print(run['defaultDatasetId'])

cURL

curl -X POST 'https://api.apify.com/v2/acts/fetch_cat~tiktok-ads-library-scraper/runs?token=MY-APIFY-TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"keywords":[],"regions":["US"],"period":"7","maxItems":20}'

MCP usage

Use TikTok Ads Library Scraper as an AI-agent tool through Apify MCP. This lets Claude Code, Claude Desktop, and other MCP-compatible clients run the actor, pass structured inputs, and return the dataset ID for follow-up analysis in your agent workflow.

MCP URL:

https://mcp.apify.com/?tools=fetch_cat/tiktok-ads-library-scraper

Claude Code setup

$claude mcp add apify-tiktok-ads "https://mcp.apify.com/?tools=fetch_cat/tiktok-ads-library-scraper"

Claude Desktop setup

Add this server to your Claude Desktop MCP configuration:

{
  "mcpServers": {
    "apify-tiktok-ads": {
      "url": "https://mcp.apify.com/?tools=fetch_cat/tiktok-ads-library-scraper"
    }
  }
}

After connecting the MCP server, ask your assistant to run the TikTok Ads Library Scraper with your target market, keyword, and item limit. Example prompts showing MCP usage are included in the AI agent usage section below.

AI agent usage

AI agents can use this actor to collect competitor ad examples, summarize creative hooks, and prepare ad-intelligence briefs without manual Creative Center browsing. Keep prompts specific about market, keyword, period, and maximum result count so the agent can choose safe inputs.

Example prompts:

• “Find 20 public TikTok top ads in the US for skincare and summarize the most common hooks.”

• “Compare public TikTok ad creatives for running shoes in the US and GB over the last 30 days. Group results by offer angle.”

• “Run a weekly competitor-ad scan for coffee brands in the US, export the dataset, and highlight landing pages that appear repeatedly.”

Scheduling

Schedule the actor weekly to monitor new creatives.

Use separate schedules per market if you track many countries.

Keep maxItems practical for routine monitoring.

Troubleshooting

If you receive no results, try a broader keyword.

If a region returns no results, verify the country code.

If TikTok temporarily limits public access, retry later with a smaller run.

If you need exact industry keys, first run without industry filters.

Limits

The actor only extracts public Creative Center data.

It does not log in to TikTok.

It does not access private advertiser accounts.

Availability can vary by market, keyword, and TikTok's public interface.

Video URLs may expire because they are served by TikTok's media infrastructure.

Legality and ethical use

This actor is intended for public data research.

Respect TikTok's terms and applicable laws.

Do not use results for spam, harassment, or deceptive advertising.

Do not attempt to identify private users from aggregate ad information.

Related scrapers

• Google Ads Transparency Scraper

• TikTok Profile Scraper

• TikTok Hashtag Scraper

FAQ

Can I scrape TikTok ads without logging in?

Yes. This actor is designed for public Creative Center data and does not require user credentials.

Can I filter by country?

Yes. Use regions with country codes such as US, GB, or DE.

Can I get the video creative?

When TikTok provides a public video URL, the actor saves it as videoUrl.

Why is brandName sometimes empty?

Some public ad records do not include a brand label.

Can I monitor competitors over time?

Yes. Create a schedule and store each dataset for historical comparison.

Does it scrape private ads?

No. It only handles public data visible through TikTok Creative Center.

Changelog

Initial version extracts public Top Ads records with keywords, region filters, media URLs, and public performance labels.