ApifyTikTok 广告Advertising

Scrape the TikTok ad library by keyword

apify.tiktok-ads.library.search

Scrape publicly running TikTok ads from TikTok's ad library by keyword or advertiser

价格: $0.003/result按供应商原价
成功率: 100%近 30 天 · 119 次
延迟 p50: 11 秒p95 28 秒
最后验证: 2026年9月26日实测可用

POSThttps://toolswitch.dev/v1/tools/apify.tiktok-ads.library.search?timeout=90&maxItems=1&maxTotalChargeUsd=0.05预览

可用平台额度调用
同步返回
读取公开数据

参数

returns creative content, advertiser, dates, audience reach and targeting as TikTok discloses them in the Commercial Content Library. Community actor, not an official TikTok surface — the only route to this capability in the catalog, and the one most likely to break upstream, so check the actor's run history before relying on it

参数	类型	必填	说明	示例
查询参数
`timeout`	整数	可选	treg's key requires 1-90 so the run and its rows arrive before any wait gives up (a larger pull needs your own key)	`90`
`maxItems`	整数	可选	optional row cap; pay-per-event actors that take the row count from their own input ignore it, so maxTotalChargeUsd is the spend limit	`50`
`maxTotalChargeUsd`	数字	可选	the spend cap Apify enforces on every event this run bills, in dollars. treg's key requires it, above 0 and at most 1, and holds it for the call	`0.5`

查询参数
timeout整数可选
treg's key requires 1-90 so the run and its rows arrive before any wait gives up (a larger pull needs your own key)
示例：90
maxItems整数可选
optional row cap; pay-per-event actors that take the row count from their own input ignore it, so maxTotalChargeUsd is the spend limit
示例：50
maxTotalChargeUsd数字可选
the spend cap Apify enforces on every event this run bills, in dollars. treg's key requires it, above 0 and at most 1, and holds it for the call
示例：0.5

代码示例

将 $TOOLSWITCH_KEY 替换为你在控制台创建的密钥。

预览

curl -X POST 'https://toolswitch.dev/v1/tools/apify.tiktok-ads.library.search?timeout=90&maxItems=1&maxTotalChargeUsd=0.05' \
  -H "X-Toolswitch-Key: $TOOLSWITCH_KEY" \
  -H "Content-Type: application/json" \
  --data-raw '{"limit":1,"offset":0,"region":"all","search":"nike","query_type":"1"}'

import os
import json
import requests

response = requests.request(
    "POST",
    "https://toolswitch.dev/v1/tools/apify.tiktok-ads.library.search?timeout=90&maxItems=1&maxTotalChargeUsd=0.05",
    headers={"X-Toolswitch-Key": os.environ["TOOLSWITCH_KEY"]},
    json=json.loads("{\"limit\":1,\"offset\":0,\"region\":\"all\",\"search\":\"nike\",\"query_type\":\"1\"}"),
)
response.raise_for_status()
print(response.text)

const response = await fetch("https://toolswitch.dev/v1/tools/apify.tiktok-ads.library.search?timeout=90&maxItems=1&maxTotalChargeUsd=0.05", {
  method: "POST",
  headers: {
    "X-Toolswitch-Key": process.env.TOOLSWITCH_KEY ?? "",
    "Content-Type": "application/json",
  },
  body: JSON.stringify(JSON.parse("{\"limit\":1,\"offset\":0,\"region\":\"all\",\"search\":\"nike\",\"query_type\":\"1\"}")),
});
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
console.log(await response.text());

网关接口为预览版，地址与鉴权方式可能调整。示例参数仅为样例数据。调用按 $0.003/result 计费，已含服务费。