TikTok Ads Library — Hosted Apify Actor

Hosted tiktok ads library that returns structured JSON without the captcha-solving, proxy-rotation, and site-update maintenance you'd otherwise own. Run it from the Apify Store with one click, or call it from your own service via the Apify API. Pay only for what you scrape — no monthly subscription.

What you get

• Structured JSON output — every tiktok ads library run returns clean, parseable records ready for analytics or downstream pipelines.
• Hosted on Apify — no servers, no proxies, no anti-bot maintenance. Click Run.
• Pay only for what you scrape — pricing scales with usage; no monthly subscription minimum.
• Multi-country support — pass a country / geo parameter to localize results across 50+ regions.
• Configurable result limits — cap the run at the exact number of records you need.
• Built-in proxy rotation — IP blocks, captchas, and rate limits are handled for you.

Why use this tiktok ads library

Most tiktok ads library solutions fall into one of two camps: free open-source libraries that break every few months when the upstream site changes, or expensive SaaS tools that charge $99-$399/month for the data layer plus a dashboard UI you may not need.

This Apify Actor sits in the middle: same structured data the SaaS tools ship, but priced per run instead of per month, with a hosted infrastructure that handles proxies, retries, and captcha solving so you don't have to.

Input

Field	Type	Default	Description
search	string	required	Advertiser name or keyword (e.g. "nike", "korean skincare"). One of search / ad_id / adv_biz_ids is required.
ad_id	string	—	Specific ad ID. Returns deeplink only (TikTok has no public detail API).
adv_biz_ids	string	—	TikTok advertiser business ID filter.
region	string	all	ISO country code or 'all'. Note: TikTok Ad Library does NOT support region=US — use 'all' to include US ads…
query_type	string	1	1 = by advertiser name, 0 = by keyword.
sort	string	last_shown_date,desc	Order results by recency or impression count.
start_date	string	—	Lower bound for ad's last-shown date (YYYY-MM-DD). Default: 1 year ago.
end_date	string	—	Upper bound for ad's last-shown date (YYYY-MM-DD). Default: now.
limit	integer	20	Max ads per request (1-100).
offset	integer	0	Result offset for pagination.
proxy_url	string	—	Optional IPv4 proxy URL in the form scheme://username:password@host:port. TikTok's library.tiktok.com has n…

Output

Every run pushes results to the Apify dataset as JSON records. Each record contains the structured fields surfaced by the tiktok ads library — fields, IDs, timestamps, and any nested objects. You can:

• Download the dataset as JSON, JSONL, CSV, or Excel from the Apify console
• Stream results via the Apify API for use in your own application
• Pipe results to webhooks, S3, BigQuery, or any of Apify's 30+ integrations
• Diff today's run against yesterday's to detect changes (new entries, removed entries, modified fields)

Use cases for the tiktok ads library

Competitor ad intelligence

Pull every active ad your top 5 competitors are running via the tiktok ads library. Map their messaging angles, creative formats, and regional spend allocation.

Ad-creative inspiration

Browse high-spending campaigns by category to copy proven creative formats — saves weeks of A/B testing from scratch.

Compliance auditing

Verify your own brand's compliance with platform ad policies by pulling all your live ads via the tiktok ads library weekly.

Market research

Aggregate tiktok ads library data across an entire vertical (e.g. all DTC mattress brands) to size paid-media spend and identify rising challengers.

FAQ

Is this tiktok ads library free?

The Actor itself is hosted on Apify with pay-per-event pricing — you only pay for what you actually scrape. There's no monthly subscription and no minimum spend. The first few runs typically cost less than a coffee. For long-running daily jobs, your monthly bill scales with the volume of data you pull.

How does this tiktok ads library compare to existing tools?

Most off-the-shelf tiktok ads library alternatives are either fragile open-source scripts that break every few months, or expensive SaaS subscriptions starting at $99-$399/month. This Actor sits in between: hosted infrastructure that handles proxy rotation and retries, but priced per run.

What input does the tiktok ads library accept?

The full input schema is rendered as a form on the Apify Store page — you can run a job by filling out a few fields with no code. The schema also accepts raw JSON if you're calling the Actor via the Apify API from your own service. See the Input section above for the field list.

How accurate is the tiktok ads library data?

The Actor scrapes data directly from the source, so accuracy matches what a human user would see on the page. There's no third-party cache or middleware — every run returns the live state. If the upstream site throttles requests, the Actor handles retries and proxy rotation transparently and surfaces a structured error in the dataset's errors field rather than failing silently.

Can I run this tiktok ads library on a schedule?

Yes — Apify has built-in scheduling. You can set the Actor to run hourly, daily, or weekly, and pipe results to webhooks, S3, or your data warehouse via the Apify integrations. Most teams schedule the tiktok ads library as a daily task and incrementally diff against the previous run to detect changes.

Pricing

This tiktok ads library uses Apify's pay-per-event pricing — every successful record costs a small fixed amount, so your bill scales linearly with usage. There's no monthly subscription and no minimum spend. See the Apify Store page for the current per-event price; expect typical workloads to cost a few dollars per run.