TikTok Ad Library Scraper

Ad Intelligence

Operated by Sourcelane✓ verified

A scraper for the public TikTok Ad Library that extracts competitor ads and creatives: it searches the library by advertiser name or by keyword in ad copy, automatically paginates and can resume pagination to gather large sets of ads, and requires no login or cookies. The connector collects creative media (direct video URLs, cover images, and additional images), on-screen ad text, advertiser identity as declared to TikTok, ad format and audit status, flight dates (first and last shown), and TikTok’s disclosed audience size bands, producing one record per ad suitable for analysis of creatives, copy, timing, and estimated reach.

Verified Sep 28, 3:55 AM

$0.01

per ad

Up to 100 per call. Only pay for results returned; failed calls are refunded.

What people use it for

Competitor ad research — view which video and image ads a rival is running
Ad creative inspiration — build a library of TikTok ad videos, images, and copy for a category
Messaging analysis — track competitor positioning and messaging shifts over time
Launch monitoring — detect new competitor campaigns as they go live
Agency pitching — demonstrate competitor TikTok ad activity and creative/spend focus

Trust & reliability

7d uptime trend

Window	Uptime	Success rate	p50	p95
24h	—	—	—	—
7d	—	—	—	—
30d	—	—	—	—

Calling contract

Call it through Sourcelane's gateway or MCP server. We run the connector, apply your agent's spend guardrails, and bill only the results returned.

Call it via Sourcelane

curl -X POST https://api.usesourcelane.com/v1/call \
  -H "Authorization: Bearer sl_live_your_agent_key" \
  -H "Content-Type: application/json" \
  -d '{"listing":"tiktok-ad-library-scraper","params":{"advertiserName":"duolingo","maxItems":5},"maxResults":10}'

Request params

Field	Type	Required	Description
`searchMode`	string	optional	Search the ad library by advertiser name, or by a keyword that appears in the ad copy.
`advertiserName`	string	optional	Advertiser to pull ads for, e.g. 'nike'. Used when Search mode is 'Advertiser'.
`keyword`	string	optional	Phrase to search for inside ad copy, e.g. 'running shoes'. Used when Search mode is 'Keyword'.
`maxItems`	integer	optional	Maximum number of ads to return in this run. Set 0 for unlimited (the run will paginate until the library is exhausted or the run times out). Capped at 100 per call.
`pageId`	string	optional	Paste NEXT_PAGE_ID from the previous run's Key-value store to continue where that run stopped.

Each result contains

Field	Type	Description
`adId`	string	Ad Id
`adLibraryUrl`	string	Ad Library Url
`advertiser`	string	Advertiser
`resolvedAdvertiserName`	string	Resolved Advertiser Name
`adText`	string	Ad Text
`imageUrl`	string	Image Url
`videoUrl`	string	Video Url
`coverImageUrl`	string	Cover Image Url
`images`	array	Images
`adFormat`	string	Ad Format
`auditStatus`	string	Audit Status
`estimatedAudience`	string	Estimated Audience
`impressions`	integer	—
`spend`	null	—
`firstShownAt`	string	—
`lastShownAt`	string	—
`searchQuery`	string	—

Use TikTok Ad Library Scraper from Claude, ChatGPT or Cursor

Pick your tool and connect in under a minute. Then just ask — for example: “What ads is Shein running right now on Meta and Google? Group them by offer.”

Connect Claude

Web, desktop and mobile. Paste one URL.

1Copy your personal connector URL
2In Claude open Settings → Connectors → Add custom connector
3Paste the URL and click Add — done

Manual setup (config files, REST, Python) +

Claude Code

Adds the Sourcelane MCP server with your key as a header.

terminal

claude mcp add --transport http sourcelane https://api.usesourcelane.com/mcp \
  --header "Authorization: Bearer sl_live_your_agent_key"

Claude Desktop (config file)

Alternative to the connector URL: add to claude_desktop_config.json, then restart Claude.

claude_desktop_config.json

{
  "mcpServers": {
    "sourcelane": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.usesourcelane.com/mcp",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer sl_live_your_agent_key"
      }
    }
  }
}

Cursor & Windsurf

Add to ~/.cursor/mcp.json (or Windsurf's mcp_config.json).

mcp.json

{
  "mcpServers": {
    "sourcelane": {
      "url": "https://api.usesourcelane.com/mcp",
      "headers": {
        "Authorization": "Bearer sl_live_your_agent_key"
      }
    }
  }
}

VS Code

Save as .vscode/mcp.json. VS Code prompts for your key once.

.vscode/mcp.json

{
  "servers": {
    "sourcelane": {
      "type": "http",
      "url": "https://api.usesourcelane.com/mcp",
      "headers": {
        "Authorization": "Bearer ${input:sourcelane-key}"
      }
    }
  },
  "inputs": [
    {
      "type": "promptString",
      "id": "sourcelane-key",
      "description": "Sourcelane agent key",
      "password": true
    }
  ]
}

ChatGPT Custom GPT (Actions)

Create a GPT → Actions → Import from URL, then Authentication: API Key, Bearer.

OpenAPI schema URL

https://usesourcelane.com/openapi.json

REST

One POST. Pass maxResults to cap cost.

curl

curl -X POST https://api.usesourcelane.com/v1/call \
  -H "Authorization: Bearer sl_live_your_agent_key" \
  -H "Content-Type: application/json" \
  -d '{"listing":"tiktok-ad-library-scraper","params":{"advertiserName":"duolingo","maxItems":5},"maxResults":10}'

Python, LangChain, CrewAI, OpenAI Agents SDK…

Wrap the REST call as a tool, or point an MCP client at the endpoint.

python

import requests

res = requests.post(
    "https://api.usesourcelane.com/v1/call",
    headers={"Authorization": "Bearer sl_live_your_agent_key"},
    json={
        "listing": "tiktok-ad-library-scraper",
        "params": {"advertiserName":"duolingo","maxItems":5},
        "maxResults": 10,
    },
    timeout=300,
)
body = res.json()
print(body["receipt"]["chargedMicros"], "micro-USD for", body["receipt"]["results"], "results")
print(body["data"])

Reviews

—

0 reviews

Leave a review

Loading reviews…