API di TikTok

TikTok Ricerca nella libreria annunci API

Cerca nella Ads Library pubblica di TikTok per parola chiave o inserzionista (inserzionista, titolo, fascia di pubblico, date di esecuzione, link alla libreria e video).

0,80 USD/1k richieste, paghi a richiesta, nessun abbonamento.

Top Ads Dashboard | TikTok Creative Center
ads.tiktok.com/business/creativecenter/inspiration/topads/pc/en
TikTokCreative CenterLog in

Explore Top Ads on TikTok

spotifySearch

Top Ads Dashboard

GermanyAd FormatObjectiveAd Language

Spotify

Spotify Premium: 3 months free

500K-1M audience · last shown Sep 27, 2025

Cosa ha restituito l'APIads[0]
{
"adId": "7648493525660270600",
"adTitle": "Spotify Premium: 3 months free",
"brandName": "Spotify",
"estimatedAudience": "500K-1M",
"firstShownUtc": 1758067200,
"lastShownUtc": 1758931200,
"url": "https://library.tiktok.com/ads/detail?ad_id=7648493525660270600&region=DE",
"videoUrl": "https://p16-ads-sign-useast8.tiktokcdn.com/obj/ad-video/7648493525660270600~tplv-ad-video.mp4",
... 3 campi in più
}
Disponibilità
97,50%
30d · 27.870 chiamate
Richieste
27.895
30 g · settimanale, ultime 12 sett.
Risposta
2,4s
mediana · 30d

Prezzi e provider

Prezzi dell'API TikTok Ricerca nella libreria annunci: una sola API, 2 provider intercambiabili

Serve per primo il provider più economico. Se fallisce, subentra il successivo nella stessa chiamata.

Paghi
8,00 USD
0,80 USD/1k richieste, solo per ciò che usi. Nessun piano mensile.
Le tue prime 125 richieste sono gratuite con il saldo iniziale di 0,10 USD.

Provalo

Ottieni TikTok Ricerca nella libreria annunci in una sola richiesta

Apri in
Risposta di esempio
Le esecuzioni gratuite restituiscono solo i primi 3 risultati. Ricarica una chiave per ottenere la risposta completa.

Questo esempio mostra 17 campi su 18. Vedi tutti i campi

{
  "found": true,
  "data": {
    "nextCursor": "eyJvZmZzZXQiOjIwfQ==",
    "hasMore": true,
    "total": 46,
    "ads": [
      {
        "adId": "7648493525660270600",
        "adTitle": "Spotify Premium: 3 months free",
        "brandName": "Spotify",
        "estimatedAudience": "500K-1M",
        "firstShownUtc": 1758067200,
        "lastShownUtc": 1758931200,
        "url": "https://library.tiktok.com/ads/detail?ad_id=7648493525660270600&region=DE",
        "videoUrl": "https://p16-ads-sign-useast8.tiktokcdn.com/obj/ad-video/7648493525660270600~tplv-ad-video.mp4",
        "coverUrl": "https://p16-ads-sign-useast8.tiktokcdn.com/obj/ad-video/7648493525660270600~tplv-ad-cover.jpeg",
        "status": "active",
        "format": "video"
      },
      {
        "adId": "7648501298817568001",
        "adTitle": "Discover Weekly, reimagined",
        "brandName": "Spotify",
        "estimatedAudience": "1M-2M",
        "firstShownUtc": 1757548800,
        "lastShownUtc": 1758758400,
        "url": "https://library.tiktok.com/ads/detail?ad_id=7648501298817568001&region=DE",
        "videoUrl": "https://p16-ads-sign-useast8.tiktokcdn.com/obj/ad-video/7648501298817568001~tplv-ad-video.mp4",
        "coverUrl": "https://p16-ads-sign-useast8.tiktokcdn.com/obj/ad-video/7648501298817568001~tplv-ad-cover.jpeg",
        "status": "active",
        "format": "video"
      }
    ]
  }
}

Riferimento completo di parametri e risposta - ogni campo, tipo ed esempio per questo endpoint.

Riferimento

Una richiesta, una sola forma di risposta.

Ogni campo che invii e ogni campo che ricevi, ciascuno con un esempio reale.

Ultima verifica 2026-11-21 · disponibilità e latenza misurate su 30d

Corpo della richiesta

JSON, inviato a questo endpoint.

  • advertiserNamestring

    Nome dell'inserzionista di cui elencare gli annunci (es. Spotify). Fornisci advertiserName oppure query, mai entrambi.

  • cursorstring

    Cursore opaco dal nextCursor di una risposta precedente. Omettilo per la prima pagina.

  • daysinteger

    Number of days of library history to search, from 1 to 365.

  • querystring

    spotify

    Parola chiave con cui cercare nei titoli e nel contenuto degli annunci (es. spotify). Fornisci query oppure advertiserName, mai entrambi.

  • regionstring

    DE

    Codice regione di due lettere per la Commercial Content Library di TikTok, come DE, FR, GB o IT. Ogni regione contiene un insieme diverso di annunci. Omettilo per usare la regione predefinita della libreria, DE. La copertura è UE e SEE; un codice non UE come US non è servito.

Tu invii. Un piccolo corpo JSON. I valori mostrati sono esempi da sostituire con i tuoi.

Risposta

JSON, un valore di esempio per campo.

each addata.ads[]

Populated whenever the provider has data for the entity.

  • adIdstring

    7648493525660270600

    TikTok ad id. Populated whenever the provider has data for the entity.

  • adTitlestring

    Spotify Premium: 3 months free

    Ad title as shown in TikTok's ad library. Populated whenever the provider has data for the entity.

  • brandNamestring

    Spotify

    Advertiser name on the ad.

  • coverUrlstring

    https://p16-ads-sign-useast8.tiktokcdn.com/obj/ad-video/7648493525660270600~tplv-ad-cover.jpeg

    Cover image URL of the ad's first video. Populated whenever the provider has data for the entity.

  • estimatedAudiencestring

    500K-1M

    Audience size band TikTok publishes for the ad, for example "100K-200K".

  • firstShownUtcinteger

    1758067200

    UTC epoch timestamp in seconds (Unix time) when TikTok first showed the ad. Multiply by 1000 for a JS Date in milliseconds.

  • formatstring

    video

    TikTok's creative format code for the ad, as the ad library reports it.

  • lastShownUtcinteger

    1758931200

    UTC epoch timestamp in seconds (Unix time) when TikTok last showed the ad. Multiply by 1000 for a JS Date in milliseconds.

  • statusstring

    active

    TikTok's audit status code for the ad, as the ad library reports it.

  • urlstring

    https://library.tiktok.com/ads/detail?ad_id=7648493525660270600&region=DE

    Link to the ad's detail page in TikTok's public Ads Library.

  • videoUrlstring

    https://p16-ads-sign-useast8.tiktokcdn.com/obj/ad-video/7648493525660270600~tplv-ad-video.mp4

    Playable URL of the ad's first video. Populated whenever the provider has data for the entity.

datadata
  • hasMoreboolean

    true

  • nextCursorstring

    eyJvZmZzZXQiOjIwfQ==

    Opaque cursor for the next page of ads, or null when this lane has no more. Pass it back as cursor to continue.

  • totalinteger

    46

top level
  • foundboolean

    true

  • reason"not_found"

    Present only when `found` is false, and says why there is no result. `not_found`: the source states the target does not exist, or returned nothing for it. A `found: false` answer is a successful call, not an error, and `costUsd` is what it actually cost.

Tu ricevi. Campi con nome e tipo nella stessa struttura, qualunque fonte risponda.

FAQ

Sull'API TikTok Ricerca nella libreria annunci

L'API TikTok Ricerca nella libreria annunci di AnyAPI restituisce dati TikTok come JSON normalizzato da una sola chiamata POST a /v1/run/tiktok.ad_library_search. Cerca nella Ads Library pubblica di TikTok per parola chiave o inserzionista (inserzionista, titolo, fascia di pubblico, date di esecuzione, link alla libreria e video). AnyAPI instrada ogni richiesta su 2 fonti e passa automaticamente a un'altra quando una fallisce. Costa da 0,80 USD ogni 1.000 richieste, in dollari statunitensi, senza abbonamento e senza minimo mensile. Negli ultimi 30 giorni, il 97,5% delle chiamate TikTok Ricerca nella libreria annunci tramite AnyAPI è riuscito, con un tempo di risposta mediano di 2,4 secondi su 27.870 chiamate misurate.

Costa da 0,80 USD ogni 1.000 richieste, in dollari statunitensi, senza abbonamento e senza minimo mensile. Ricarichi un portafoglio in USD e ogni chiamata lo scala. Alcune richieste fallite finanziate dal portafoglio comportano costi di elaborazione che trasferiamo al costo, senza ricarico; la risposta di errore mostra l'importo addebitato.

Cerca nella Ads Library pubblica di TikTok per parola chiave o inserzionista (inserzionista, titolo, fascia di pubblico, date di esecuzione, link alla libreria e video). La risposta è JSON normalizzato con la stessa busta che restituisce ogni endpoint AnyAPI, quindi analizzare un secondo endpoint significa cambiare l'URL e nient'altro.

Negli ultimi 30 giorni, il 97,5% delle chiamate TikTok Ricerca nella libreria annunci tramite AnyAPI è riuscito, con un tempo di risposta mediano di 2,4 secondi su 27.870 chiamate misurate. Sono misurazioni di AnyAPI sul traffico che passa dal gateway, ricalcolate di continuo, non un obiettivo di livello di servizio pubblicato.

Sì. Un nuovo account AnyAPI parte con 0,10 USD di saldo gratuito e senza bisogno di carta, che copre 125 chiamate TikTok Ricerca nella libreria annunci a 0,0008 USD ciascuna.

AnyAPI interroga la successiva delle sue 2 fonti nella stessa richiesta, partendo dalla più economica, quindi una fonte che cade non fa fallire la tua chiamata.

Invia una richiesta POST a https://api.getanyapi.com/v1/run/tiktok.ad_library_search con la tua chiave AnyAPI in un header "Authorization: Bearer" e l'input come corpo JSON. La stessa chiave e lo stesso portafoglio funzionano su ogni endpoint AnyAPI.

No. Aggiungi dollari statunitensi a un unico saldo prepagato AnyAPI e ogni richiesta lo scala. Non c'è un piano mensile né un minimo, e lo stesso saldo paga ogni endpoint AnyAPI.

Sì. Installa @getanyapi/sdk da npm per TypeScript o getanyapi da pip per Python. Entrambi chiamano ogni endpoint AnyAPI con la stessa chiave, e funziona anche qualsiasi client HTTP.

Sì. Un agente può collegarsi al server MCP di AnyAPI su https://api.getanyapi.com/mcp, oppure creare da solo la propria chiave di prova gratuita con un POST non autenticato a https://api.getanyapi.com/agent/signup e chiamare questo endpoint via HTTP.