TikTok Ads Library API

TikTok Ads Library Scraper API for Ads, Targeting and Top Ads

Search TikTok’s ad library by keyword or advertiser, read each ad’s creative, landing page, payer, targeting and reach, and list Creative Center top ads by market. Build a reference of the campaigns running on TikTok.

Gibran Pulga, CEO of Desys FinanceGibran PulgaCEO, Desys Finance

We use ScrapeAtlas to gather social sentiment data for our banking partners at a scale we wouldn't have been able to otherwise.

WHAT YOU CAN BUILD / 05 ENDPOINTS

Put TikTok Ads Library data to work.

Find your use case, then explore the request and response.

Search ads

GET/v1/tiktok/ad-library/search

Build a TikTok creative research library by searching ads by keyword or advertiser, filtered by country, dates, media type, status, age, reach and gender.

Get ad

GET/v1/tiktok/ad-library/ad

Build an ad research card with the creative, landing page, advertiser account, payer, targeting and reach by country, age and gender.

Search advertisers

GET/v1/tiktok/ad-library/advertisers/search

Build an advertiser picker that turns a brand name into the business IDs used for pinned ad searches and reports.

Advertiser report

GET/v1/tiktok/ad-library/report

Build an advertiser activity view with the share of ads by country and the number of ads published each day.

Top ads

GET/v1/tiktok/ads/top

Build a top-performing creative board by market and period, ranked by reach, click-through rate or likes, with video renditions.

HOW IT WORKS

From API key to TikTok Ads Library data in four steps.

Run a sample below without a key.

  1. 01

    Get your API key

    Create a free account and copy your key. You start with 100 free credits; no card needed.

  2. 02

    Choose an endpoint

    Pick one of the 5 TikTok Ads Library endpoints and add its input, such as a search query.

  3. 03

    Send one request

    Call it with your key in the x-api-key header. ScrapeAtlas reads the public TikTok Ads Library data and retries when a read fails.

  4. 04

    Use the JSON

    Get structured JSON with a coverage status. Only successful requests use a credit.

LIVE RESULTS

Try a sample request.

Try the TikTok Ads Library API right here. This sample uses the Search ads endpoint and returns live JSON. No API key needed.

  1. 01
    Choose a sample value

    Start with skincare, or change the query field to your own value.

  2. 02
    Select Run sample

    Execute the sample code and see the response in the JSON response tab.

  3. 03
    Build on the result

    Open the full playground to try more parameters and copy code for your app.

Open this endpoint in the playground Request and response fields
LIVE SAMPLE / Search adsNo API key needed

Preparing the sample…

// Run this sample here — no API key needed.
const value = "skincare";
const url = new URL("/website/demo/tiktok-ads",
  "https://api.scrapeatlas.com");
url.searchParams.set("value", value);

const response = await fetch(url);
const data = await response.json();
console.log(data);
GET/v1/tiktok/ad-library/search

A live example from our playground. Change the value above, then select Run sample.

CUSTOMER STORIES

What they are saying
about us.

  • Matteo L.Small-Business (50 or fewer emp.)

    “Easy, Affordable Scraping for Product Ideas—More Platforms Needed”

    I use ScrapeAtlas to find product ideas—real ideas that people need. I couldn’t get to people’s ideas on social media platforms without it. I like that it’s easy and capable, and it isn’t expensive. I value the scraping and MCP features. …

    Read on G2
  • Ms H.Sales, Mid-Market (51-1000 emp.)

    “ScrapeAtlas Replaces Multiple Scrapers with One Simple Solution”

    ScrapeAtlas saves me from juggling a different scraper for every platform. … ScrapeAtlas solves the problem of getting reliable public data from many social and e-commerce platforms without building and maintaining my own scrapers.

    Read on G2
  • We use ScrapeAtlas to gather social sentiment data for our banking partners at a scale we wouldn't have been able to otherwise.

    Gibran PulgaCEO, Desys Finance
  • Stas D.Founder, Marketing and Advertising

    “Reliable parsers and flexible API for audience search”

    I like the convenient documentation and conditions at ScrapeAtlas. The parsers work great: I use keyword data from fresh threads to find target audiences and clients in Threads. I also appreciate the higher quality API responses and more detailed request customization. The initial setup was very easy for me.

    Read on G2

Nigel Yong — Founder, PostOnce

Pay as you go

Start free.
Build at your pace.

One-time credit packs, priced in US dollars. Credits never expire, and there is no monthly commitment.

Free

Try the API with your next idea.

$0No credit card needed

100 free credits

One starter grant per account

Starter

For a new idea or a one-off project.

$19USD / one-time

10,000 credits

$1.90 per 1,000 credits

Growth

Popular

For regular workflows and bigger builds.

$89USD / one-time

50,000 credits

$1.78 per 1,000 credits

Save 6.3% compared with Starter

Scale

For high-volume data collection.

$249USD / one-time

200,000 credits

$1.25 per 1,000 credits

Save 34.5% compared with Starter

Enterprise Plan

Want to scrape larger volumes?

Let’s talk about a plan that fits your scale.

TikTok Ads Library API

Frequently Asked Questions

Explore the API reference

TikTok Ads Library API and scraping

What can I retrieve from the TikTok Ads Library API?

Search TikTok ads by keyword or advertiser, read each ad’s creative, landing page, advertiser account, payer, targeting and reach, look up advertiser business IDs and activity reports, and list Creative Center top ads with performance metrics. Results keep TikTok’s field names; ad dates are Unix milliseconds and report dates Unix seconds.

How do I scrape TikTok Ads Library results by keyword or advertiser?

Send query for a keyword search or advertiser_name for an advertiser search; add adv_biz_ids from Search advertisers to pin the exact advertiser. Filter by region, last-shown dates, media type, status, age, reach and gender, and pass the returned cursor with the same inputs for the next 12 ads.

How can I use the TikTok Ads Library for competitor research?

Resolve a competitor’s business ID with Search advertisers, then collect their ads with Search ads sorted by last shown date, creation date or unique users. Advertiser report adds the share of their ads by country and the number of ads they published each day.

TikTok Ads Library: ad transparency, targeting and top ads

Which ad transparency fields does the TikTok Ads Library publish?

Get ad returns the ad text, video and images, first and last shown dates, landing page, call to action, objective, payer, registration country and the advertiser’s TikTok account with its follower count and account type. Pass an ad ID or a library.tiktok.com detail URL.

Can I see who an ad in the TikTok Ads Library targeted and reached?

Yes. Get ad returns the published targeting, including age and gender by country, audience size, interests, languages, devices and operating systems, plus unique users reached by country with age and gender breakdowns and numeric bounds for the audience band.

Does the TikTok Ads Library API list top-performing ads by country?

Top ads lists Creative Center top ads for a market and a 7, 30 or 180-day period, ranked by reach, click-through rate, view rates, conversion rate or likes, and filtered by objective, industry, language and Spark Ads format. Get ad adds comments, shares and per-second analytics for a top ad.

API access and integration

How do I get a ScrapeAtlas API key and authenticate requests?

Create a ScrapeAtlas account and generate an API key in the dashboard. Send the key in the x-api-key request header when calling https://api.scrapeatlas.com. The API playground lets you enter an endpoint’s parameters and inspect its JSON response.

Can I call the scraping API from Python, JavaScript or the CLI?

Yes. Send authenticated HTTP requests from Python, JavaScript or another language that supports HTTP. The endpoint reference includes request examples and response fields. Use the ScrapeAtlas CLI for terminal workflows and pass the returned pagination values when requesting additional result pages.

Can I connect an AI assistant to the ScrapeAtlas MCP server?

Yes. Connect an MCP-compatible assistant to the ScrapeAtlas MCP server to discover and call the public platform tools with your ScrapeAtlas account. The agent reference also gives coding assistants a readable guide to the endpoints and their request schemas.

Make something with it

Ready to build?

Bring social data into your next project.
Start with 100 free credits and see what you can build.

No credit card needed.Building with an AI agent?