ApifyTikTok AdsAdvertising

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

Price: $0.003/resultAl precio del proveedor
Success rate: 100 %Last 30 days · 119 calls
Latency p50: 11 sp95 28 s
Last verified: 26 sept 2026Verified working

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

Try onlinePróximamenteProvider docs ↗

Uses platform quota
Synchronous response
Reads public data

Parámetros

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

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
Parámetros de consulta
`timeout`	entero	Opcional	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`	entero	Opcional	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`	número	Opcional	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`

Parámetros de consulta
timeoutenteroOpcional
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)
Ejemplo: 90
maxItemsenteroOpcional
optional row cap; pay-per-event actors that take the row count from their own input ignore it, so maxTotalChargeUsd is the spend limit
Ejemplo: 50
maxTotalChargeUsdnúmeroOpcional
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
Ejemplo: 0.5

Ejemplos de código

Sustituye $TOOLSWITCH_KEY por la clave que creaste en la consola.

Preview

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());

La API de la pasarela está en versión preliminar; su URL y autenticación pueden cambiar. Los parámetros del ejemplo son datos de muestra. Las llamadas se facturan a $0.003/result, incluida la tarifa de servicio.