Sourcelane

TikTok Top Ads Scraper

Ad Intelligence

Operated by Sourcelane✓ verified

Scrape the best-performing TikTok ads from Creative Center by country, industry and objective - video, likes, CTR rank, budget, landing page and brand.

Read full description

A scraper that pulls top-performing TikTok ads from TikTok Creative Center across global markets, filtering by industry, campaign objective and language. It extracts ad metadata (title, brand, industry and campaign objective), creative assets (video files in multiple resolutions, cover image, duration and dimensions), performance metrics (likes, comments, shares, click-through rate rank/percentile, spend tier), serving details (markets where the ad ran, landing page, source, voiceover and search-ad flags) and a link to the ad in Creative Center. The connector automatically splits broad searches into industry/objective/language slices and deduplicates results across slices and countries; video and cover URLs are signed and time-limited.

Verified Oct 25, 10:11 PM

$0.002

per ad

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

What people use it for

You give it

  • Countriesrequired

    Markets to pull top-performing ads from.

  • Industries

    Only return ads from these industries or sub-industries.

  • Campaign objectives

    Only return ads run with these campaign objectives.

  • Ad languages

    Only return ads in these languages.

Optional settings

Time periodSort byInclude ad detailsMax ads

You get back

Text & content
Ad title
People & accounts
Brand name
Numbers & stats
LikesCountries shown
Location
Country
Links & media
Video duration secVideo widthVideo heightCover URLVideo URLVideo URLsCreative center URL
Other details
Ad IDIndustryIndustry IDParent industryObjectiveCommentsSharesCtr top percent+7 more

Trust & reliability

7d uptime trend
WindowUptimeSuccess ratep50p95Calls
24h————0
7d————0
30d————0

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-top-ads-scraper","params":{"countries":["US"],"maxItems":5},"maxResults":10}'

Request params

FieldTypeRequiredDescription
countriesarrayrequiredMarkets to pull top-performing ads from. Each country is searched separately and results are de-duplicated.
periodstringoptionalRank ads by performance over the last 7, 30 or 180 days.
sortBystringoptionalWhich performance metric ranks the ads within each filter slice.
industriesarrayoptionalOnly return ads from these industries or sub-industries. Leave empty for all industries.
objectivesarrayoptionalOnly return ads run with these campaign objectives. Leave empty for all objectives.
adLanguagesarrayoptionalOnly return ads in these languages. Leave empty for all languages.
includeDetailsbooleanoptionalAlso fetch comments, shares, landing page, every country the ad ran in, and the ad source (one extra request per ad).
maxItemsintegeroptionalMaximum number of unique ads to return. 0 = as many as the filters allow. Capped at 100 per call.

Each result contains

FieldTypeDescription
adIdstringAd ID
adTitlestringAd title
brandNamestringBrand
industrystringIndustry
industryIdstring—
parentIndustrystring—
objectivestringObjective
likesintegerLikes
commentsintegerComments
sharesintegerShares
ctrTopPercentinteger—
ctrRankstringCTR rank
budgetLevelstringBudget
videoDurationSecintegerDuration (s)
videoWidthinteger—
videoHeightinteger—
coverUrlstringCover
videoUrlstringVideo
videoUrlsobject—
landingPagenullLanding page
countriesShownarray—
sourcestring—
hasVoiceOverboolean—
isSearchAdboolean—
creativeCenterUrlstringCreative Center
countrystringCountry
periodinteger—
sortBystring—
scrapedAtstring—

Use TikTok Top Ads 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. One click, then confirm.

  1. 1Click Add to Claude — claude.ai opens with Sourcelane filled in
  2. 2Click Continue to confirm — it then works in Claude desktop and mobile too
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-top-ads-scraper","params":{"countries":["US"],"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-top-ads-scraper",
        "params": {"countries":["US"],"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

5
0
4
0
3
0
2
0
1
0

Leave a review

Loading reviews…

Related Ad Library connectors

See all Ad Library data connectors →