tiktok-ad-library-api SKILL.md skillA

tiktok-ad-library-api from scavio-ai/skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add scavio-ai/skills/tiktok-ad-library-api@v1.0.0

Pins v1.0.0 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
scavio-ai/skills
Path
skills/tiktok-ad-library-api/SKILL.md
Versions recorded
3
Latest version
v1.0.0, committed Sep 3, 2026
First version recorded
Aug 25, 2026
Size
8,092 bytes
Repository stars
12
License
MIT

Search ads running on TikTok by keyword and/or industry, pull the top-performing ads with a performance highlight, and open one ad in full with its objective, engagement, the countries it ran in, its landing page and a playable video. 3 endpoints, 1 credit each, structured JSON.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# TikTok Ad Library API - Search Ads, Top Ads, Ad Detail

Search the ads running on TikTok by keyword and/or industry, pull the top-performing ads with a written performance highlight, and open one ad in full with its objective, engagement, the countries it ran in, its landing page and a playable video. All endpoints return structured JSON.

## When to trigger

Use this skill when the user asks to:
- Find TikTok ads for a brand, keyword, product or industry
- See what ads a competitor is running on TikTok and how they perform
- Pull the top-performing TikTok ads in a niche for creative research or swipe files
- Get one ad in full: objective, click-through rate, likes, the countries it ran in, its landing page and the video
- Do paid-social / creative research or ad-intelligence work on TikTok

## Setup

Get a free API key at [scavio.dev](https://scavio.dev/?utm_source=agent-skills&utm_medium=skill&utm_campaign=tiktok-ad-library-api) (50 free credits to get started, no card required):

```bash
export SCAVIO_API_KEY=sk_live_your_key
```

### If you do not have a key yet

An agent running this skill without `SCAVIO_API_KEY` set will get `401` on every
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add scavio-ai/skills/tiktok-ad-library-api@sha256:23be47feb593f8c8

The line at the top of this page pins the label v1.0.0, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_fonaxgajiiiqsvvl.svg)](https://markdownregistry.com/a/art_fonaxgajiiiqsvvl)

1 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 3 versions of this file, between Aug 25, 2026 and Sep 3, 2026, about one every 5 days.

versioncommittedcommitsizeaudit
v1.0.0 latest2026-09-03 f3b1131 8,092 BA view · diff
v1.0.02026-08-31 3169fe5 8,087 BA view · diff
v1.0.02026-08-25 a9beb5e 7,187 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (8092 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

scavio-ai/skills · 12 stars · license MIT · pushed 2026-10-21 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_fonaxgajiiiqsvvl
GET https://markdownregistry.com/api/v1/resolve?ref=scavio-ai/skills/tiktok-ad-library-api
GET https://markdownregistry.com/api/v1/blob/23be47feb593f8c8a625e0867da53fe66beb4ec19872992ad4c5f08beeeaad65

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from scavio-ai/skills

airbnb-scraper-api SKILL.md skill
scavio-ai/skills · skills/airbnb-scraper-api/SKILL.md · Airbnb scraper API: search stays for a location and date window with per-night and stay-total price plus the full…
v1.0.0 · audit A · 12 stars
aliexpress-product-data SKILL.md skill
scavio-ai/skills · skills/aliexpress-product-data/SKILL.md · Search AliExpress, browse a category, pull one product with every SKU variant, read translated buyer reviews, and open…
v1.0.0 · audit A · 12 stars
amazon-product-data SKILL.md skill
scavio-ai/skills · skills/amazon-product-data/SKILL.md · Amazon product data API: keyword search, full product detail by ASIN, and every seller offer on an ASIN with the…
v3.0.1 · audit A · 12 stars
apple-app-store-api SKILL.md skill
scavio-ai/skills · skills/apple-app-store-api/SKILL.md · Apple App Store API: search apps by keyword or publisher name, read a full listing by App Store id or bundle id with…
v1.0.0 · audit A · 12 stars
booking-com-hotel-data SKILL.md skill
scavio-ai/skills · skills/booking-com-hotel-data/SKILL.md · Booking.com hotel data API: search a destination and stay for live nightly prices, review scores and star ratings, pull…
v1.0.0 · audit A · 12 stars
capterra-reviews-api SKILL.md skill
scavio-ai/skills · skills/capterra-reviews-api/SKILL.md · Capterra reviews API: search B2B software for 20 ranked products, read a full profile with the complete pricing table…
v1.0.0 · audit A · 12 stars
chatgpt-scraper-api SKILL.md skill
scavio-ai/skills · skills/chatgpt-scraper-api/SKILL.md · ChatGPT scraper API for AI visibility: send a prompt, get the answer ChatGPT gives as JSON with every cited page…
v1.0.0 · audit A · 12 stars
companies-house-api SKILL.md skill
scavio-ai/skills · skills/companies-house-api/SKILL.md · Companies House API for the UK register: search by company name (current and former names), then pull the full register…
v1.0.0 · audit A · 12 stars
costco-product-data SKILL.md skill
scavio-ai/skills · skills/costco-product-data/SKILL.md · Costco product data API: search and category listings with per-warehouse shelf price and stock, full item detail for up…
v1.0.0 · audit A · 12 stars
douyin-scraper-api SKILL.md skill
scavio-ai/skills · skills/douyin-scraper-api/SKILL.md · Pull Douyin videos, user profiles and feeds, comments, hashtags, music, live rooms, the hot-search board, keyword…
v1.0.0 · audit A · 12 stars
ebay-product-data SKILL.md skill
scavio-ai/skills · skills/ebay-product-data/SKILL.md · eBay product data API: search live or SOLD listings for comps and resale pricing (price, condition, bids, shipping…
v1.0.0 · audit A · 12 stars
etsy-product-data SKILL.md skill
scavio-ai/skills · skills/etsy-product-data/SKILL.md · Search Etsy listings, pull one listing with its variations and reviews, open a shop's profile and catalogue, and page…
v1.0.0 · audit A · 12 stars

Every file in scavio-ai/skills

Browse by kind, by grade A, or by owner.