tiktok-ad-library/
ad

Risolvi un URL noto di un annuncio TikTok pubblico in campi normalizzati su creatività, inserzionista, diffusione, destinazione, impression, media, pubblicazione e raccolta.

TikTok Ad Library Ad API

URL singolo
Un solo annuncio al massimo
Record canonico dell’annuncio
0,5 crediti per risultato
Pronto
Pronto

Inserisci i parametri e invia una richiesta. Qui compariranno lo stato dell’attività e i risultati normalizzati.

README

A cura di SocQ · Aggiornato il

TikTok Ad Library Ad

TikTok Ad Library Ad risolve un record pubblicitario pubblico noto dopo che una ricerca o una revisione manuale ha prodotto un URL idoneo. Ricava un identificatore a monte e restituisce al massimo un annuncio normalizzato; non cerca gli annunci di un inserzionista, non elenca le campagne e non espone i dati privati sulle prestazioni di Ads Manager.

Funzionalità della TikTok Ad Library Ad API

  • Input con URL di un annuncio notoInvia un solo URL ufficiale http o https di TikTok il cui percorso contiene /ad.
  • Ricavo dell’identificatoreDà la precedenza al primo valore della query id, poi ad_id, poi al segmento numerico più a destra del percorso; altrimenti il provider riceve l’URL come alternativa di riserva.
  • Dettaglio a oggetto singoloRichiede un solo oggetto di dettaglio a monte e restituisce al massimo un record, solo se è presente un’identità di annuncio supportata.
  • Campi canonici dell’annuncioRicevi campi stabili su inserzionista, testo, date, paese, piattaforma, formato, destinazione, impression, media, pubblicazione e raccolta.
  • Fedeltà alla fonte con valori nulliMantiene null i valori non disponibili, perché i record della Commercial Content Library e di Creative Center possono esporre campi diversi.

Parametri della TikTok Ad Library Ad API

ParametriObbligatorioDescrizione
urlObbligatorioSingolo URL ufficiale http o https di TikTok obbligatorio, il cui percorso contiene /ad. Preferisci un valore utilizzabile della query id o ad_id, oppure un segmento numerico del percorso.

Come usare la TikTok Ad Library Ad API

Invia l’URL di un annuncio pubblico noto, interroga l’attività asincrona ed elabora il risultato singolo, se disponibile.

  1. Scegli un URL ufficiale di un annuncio TikTok, possibilmente con un id, un ad_id o un identificatore numerico nel percorso.
  2. Invia con POST url a /v1/tiktok-ad-library/ad e salva il task_id restituito.
  3. Interroga /v1/tasks/{task_id} finché l’attività non raggiunge uno stato finale.
  4. In caso di successo leggi data.results.items; l’operazione di dettaglio restituisce zero o un elemento.
curl -X POST "https://api.socq.ai/v1/tiktok-ad-library/ad" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://library.tiktok.com/ads/detail/?id=1871655924410641"}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items; the detail operation returns at most one item

Casi d’uso della TikTok Ad Library Ad API

  • Ispezione di annunci selezionati: Risolvi un annuncio scelto da un risultato di ricerca nei campi di dettaglio normalizzati attualmente disponibili.
  • Revisione della creatività: Esamina testo della creatività pubblica, identità dell’inserzionista, formato, media e destinazione di un annuncio noto.
  • Archivio di trasparenza: Conserva un record pubblico con URL di origine, date di visualizzazione, contesto di diffusione e momento di raccolta.
  • Confronto tra librerie: Confronta i metadati pubblici supportati tra record di annunci selezionati, senza considerarli prestazioni della campagna.

Consigli degli esperti per la TikTok Ad Library Ad API

  • Preferisci gli URL con un valore numerico esplicito della query id o ad_id, per evitare il comportamento di riserva che dipende dal provider.
  • Un URL valido non garantisce che la fonte a monte esponga ancora un oggetto annuncio identificabile.
  • Considera i campi di Ads Library e Creative Center specifici della fonte e non direttamente intercambiabili.
  • Archivia i riferimenti a media o landing page solo nel rispetto dei termini applicabili, perché gli URL possono scadere o reindirizzare.
  • Non dedurre targeting, spesa, conversioni o prestazioni dalle date di visualizzazione o dalle impression pubbliche.
  • Usa l’endpoint di ricerca quando ti serve la scoperta; questo endpoint di dettaglio non elenca mai gli annunci di un inserzionista.

Oltre alla TikTok Ad Library Ad API, usa queste API quando ti serve un altro tipo di dati pubblici di TikTok Ad Library.

  • TikTok Ad Library Search API — Cerca i record pubblicitari pubblici di TikTok supportati per nome di un inserzionista o parola chiave, con un limite di risultati allineato alle pagine.

Esplora altre piattaforme

Combina i dati di TikTok Ad Library con i dati pubblici delle altre piattaforme social supportate.

TikTok Ad Library Ad API — FAQ

TikTok Ad Library Ad API è un’interfaccia programmatica per risolvere un URL noto di un annuncio TikTok pubblico in al massimo un record di dettaglio normalizzato, con campi supportati su inserzionista, creatività, diffusione, destinazione, impression, media e orari.

Invia un solo URL ufficiale http o https di TikTok il cui percorso contiene /ad. La console della pagina rifiuta gli host contraffatti prima dell’invio.

L’adattatore prende il primo valore non vuoto di id, altrimenti ad_id, altrimenti il segmento del percorso interamente numerico più a destra. Se non ne esiste nessuno, passa l’URL come alternativa di riserva che dipende dal provider.

No. L’endpoint accetta un solo URL, restituisce al massimo un annuncio, non usa la paginazione e non ha results_limit.

I record pubblici di Ads Library e Creative Center espongono campi diversi e i record di origine possono omettere inserzionista, date, paesi, formato, destinazione, impression o media.

No. Non fornisce offerte, budget, conversioni, attribuzione, targeting privato né la configurazione completa della campagna di Ads Manager.

Un record di annuncio restituito costa 0,5 crediti SocQ, senza costo base. La stima è di un risultato e un risultato vuoto non comporta alcun addebito.