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
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
url | Obbligatorio | Singolo 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.
- Scegli un URL ufficiale di un annuncio TikTok, possibilmente con un id, un ad_id o un identificatore numerico nel percorso.
- Invia con POST url a /v1/tiktok-ad-library/ad e salva il task_id restituito.
- Interroga /v1/tasks/{task_id} finché l’attività non raggiunge uno stato finale.
- 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 itemCasi 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.
API correlate
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.