TikTok Ad Library API: How to Research Competitor Ads at Scale

TL;DR: TikTok's Creative Center shows you what ads are performing in any region, industry, and time window. The problem is it's manual and you can't export anything. This guide shows you how to automate TikTok ad research with the SociaVault API — pull top-performing creatives, track CTR and engagement patterns, and build a competitive intelligence pipeline that runs on autopilot.

If you've spent any time in TikTok's Creative Center, you already know it's one of the most underrated tools in paid media. It shows you the actual top-performing ads across every industry and every market. Not estimated data — real performance rankings based on impressions, play rates, conversions, and engagement.

But the Creative Center has the same problem every manual tool has: it doesn't scale.

You can browse a few pages of results. You can filter by industry. But you can't export. You can't track changes over time. You can't set up alerts when a competitor in your space launches a new winning creative. You definitely can't pipe that data into your creative brief workflow or share it programmatically with your team.

That's where the API changes everything.

What You Get From the TikTok Ad Library API

The SociaVault TikTok Ad Library endpoints give you structured access to everything in the Creative Center:

Search endpoint — Find top ads by region, industry, objective, format, duration, language, and keyword. Sort by impressions, play rates, CTR, CVR, or likes.

Ad details endpoint — Get the full breakdown of any individual ad: its creative text, engagement metrics, countries targeted, landing page URL, video assets at multiple qualities, and second-by-second retention/click/conversion curves.

That second piece — the interactive time analysis — is something most people don't even know exists in the Creative Center. It tells you the exact second in the video where viewers clicked, converted, or dropped off.

Use Case 1: Building a Competitor Swipe File That Updates Itself

Every creative team keeps a swipe file. The problem is they go stale. Someone bookmarks 20 ads, then six months later the file is full of dead creatives that stopped running.

With the search endpoint, you can build a living swipe file:

const response = await fetch(
  "https://api.sociavault.com/v1/scrape/tiktok-ad-library/search?" +
    new URLSearchParams({
      industry: "beauty_personal_care",
      region: "US",
      period: "7",
      order_by: "ctr",
      limit: "20",
    }),
  { headers: { "X-API-Key": "YOUR_API_KEY" } },
);

const { data } = await response.json();
// data.ads contains the top 20 beauty ads by CTR from the last 7 days

Run this weekly. Store the results. Now you have a time-series of what creative approaches are winning in your industry every single week. You'll notice patterns before your competitors do — certain hooks, certain visual styles, certain CTAs that keep appearing at the top.

Use Case 2: Tracking Specific Brands

Want to know exactly what ads a competitor is running? Search with their brand name as the keyword:

const response = await fetch(
  "https://api.sociavault.com/v1/scrape/tiktok-ad-library/search?" +
    new URLSearchParams({
      query: "glossier",
      region: "US",
      period: "30",
      order_by: "impression",
    }),
  { headers: { "X-API-Key": "YOUR_API_KEY" } },
);

This returns their top ads ranked by impressions over the last 30 days. You can see their messaging angle, the video duration that's performing, and how their CTR compares to industry averages.

Use Case 3: Deep-Diving Into a Winning Ad

When you find an ad that's crushing it, pull the full details:

const response = await fetch(
  "https://api.sociavault.com/v1/scrape/tiktok-ad-library/ad?" +
    new URLSearchParams({ ad_id: "7645249124891607041" }),
  { headers: { "X-API-Key": "YOUR_API_KEY" } },
);

const { data } = await response.json();
// data.interactive_time_analysis shows second-by-second retention
// data.video_info.video_url gives you the actual video file
// data.landing_page shows where they're sending traffic

The interactive_time_analysis field is gold. It shows:

• Retention curve — exactly when viewers drop off
• Click distribution — which seconds trigger clicks
• CTR hotspots — the moments in the video with peak engagement

If a winning ad has a retention spike at second 3 and a click spike at second 15, you know exactly what hook format and CTA timing to replicate.

Use Case 4: Market Entry Research

Launching in a new country? Use the region filter to see what's already working there:

// What's performing in Germany right now?
const response = await fetch(
  "https://api.sociavault.com/v1/scrape/tiktok-ad-library/search?" +
    new URLSearchParams({
      region: "DE",
      industry: "tech_electronics",
      period: "30",
      order_by: "cvr",
      ad_language: "de",
    }),
  { headers: { "X-API-Key": "YOUR_API_KEY" } },
);

You instantly know:

• What messaging resonates in that market
• What video styles perform (duration, format)
• What CTR/CVR benchmarks to expect
• Whether Spark Ads or standard ads dominate

Available Filters

The search endpoint supports filtering by:

Filter	Options
Region	80+ country codes (US, GB, DE, FR, JP, BR, etc.)
Period	7, 30, or 180 days
Industry	21 categories (beauty, tech, gaming, food, travel, etc.)
Objective	App installs, conversions, traffic, reach, video views, etc.
Duration	Under 10s, 10-20s, 20-30s, 30-40s, 40-50s, over 50s
Likes	Top 1-20%, 21-40%, 41-60%, 61-80%, 81-100%
Format	Spark Ads vs Non-Spark Ads
Language	16 languages including EN, ES, DE, FR, JA, KO
Sort	For You, Impressions, 2s play rate, 6s play rate, CVR, CTR, Likes

Building a Weekly Competitor Intelligence Report

Here's a practical workflow agencies use:

1. Monday morning cron job hits the search endpoint for each client's industry
2. Results get compared against last week's results to flag new entrants
3. Any ad with CTR above industry median gets flagged for creative review
4. The ad details endpoint pulls retention curves for the top 5 new ads
5. A Slack message summarizes: "3 new high-CTR beauty ads this week. Top hook: UGC testimonial format. Average duration: 22 seconds."

No manual Creative Center browsing. No screenshot folders. The intelligence pipeline runs itself.

Pricing

Both endpoints cost 1 credit per request. If you're pulling 20 ads per search (the default), that's 1 credit to get 20 ads. Pulling details for each of those is 20 more credits. A full weekly report across 5 industries costs around 105 credits total — less than $2.

Getting Started

The TikTok Ad Library endpoints are available now on your SociaVault dashboard. If you're already using SociaVault for TikTok profile or video data, the same API key works — just point at the new endpoint paths.

Check the API docs for the full parameter reference and response schema.