Torna alle API
Trasparenza pubblicitaria di TikTok

TikTok Ad Library API

Scopri i record pubblicitari pubblici supportati di TikTok con una query oppure risolvi l’URL di un annuncio noto in campi normalizzati per ricerca, revisione e archiviazione.

API della TikTok Ad Library disponibili

Usa Search per scoprire i record pubblicitari pubblici per inserzionista o parola chiave e Ad Details per risolvere l’URL di un solo annuncio pubblico noto e idoneo.

Quali dati pubblici sugli annunci puoi recuperare?

I campi restituiti riflettono le informazioni pubbliche attualmente esposte per ogni record supportato; i valori della fonte non disponibili restano null o vuoti.

Identità dell’annuncio e dell’inserzionista

Raccogli ID pubblici degli annunci, URL dei record disponibili, nomi degli inserzionisti, riferimenti degli inserzionisti e tipi di risorsa stabili.

Creatività e destinazione

Ispeziona testo dell’annuncio, formato, riferimenti ai media e URL pubblici delle pagine di destinazione, quando disponibili.

Contesto di diffusione visibile

Leggi date di visualizzazione supportate, data di pubblicazione, paesi, piattaforme, pubblico e informazioni sulle impression, quando esposti.

Contesto della raccolta

Conserva i campi normalizzati di fonte e raccolta per code di revisione, cataloghi e dataset di ricerca.

SocQ e i prodotti pubblicitari di TikTok

SocQ offre la raccolta in sola lettura dei record di trasparenza pubblici supportati. I prodotti di TikTok hanno scopi diversi, dall’accesso alla libreria pubblica alla gestione autorizzata delle campagne.

FunzionalitàSocQProdotti pubblicitari di TikTok
Uso principaleCercare e normalizzare i record pubblici di annunci supportatiTrasparenza pubblica o operazioni autorizzate sulle campagne, a seconda del prodotto
InputUn inserzionista o una parola chiave, oppure l’URL di un annuncio notoI controlli variano in base alla superficie di TikTok interessata
Dati privati delle campagneNon disponibiliRichiedono l’account, il prodotto, l’approvazione e i permessi applicabili
AzioniFlusso di lavoro di dati pubblici in sola letturaAds Manager supporta le operazioni autorizzate sulle campagne
Formato della rispostaRecord di annunci stabili di SocQViste o risposte native specifiche del prodotto

Come funzionano le API della TikTok Ad Library

Entrambi gli endpoint usano un ciclo di vita asincrono di invio, interrogazione e lettura; Search può raccogliere più pagine della fonte, mentre Ad Details restituisce al massimo un record.

  1. 1. Scegli un endpoint

    Invia un inserzionista o una parola chiave a Search, oppure l’URL di un annuncio TikTok pubblico idoneo a Ad Details.

  2. 2. Interroga l’attività

    Usa il task_id restituito con /v1/tasks/{task_id} finché l’elaborazione non riesce o non fallisce.

  3. 3. Leggi i record normalizzati

    Consuma data.results.items e l’eventuale cursore dei risultati dell’attività; una richiesta di dettaglio restituisce zero o un annuncio.

Inizia con una sola richiesta API

Autenticati con una chiave API di SocQ. Search restituisce 12 risultati per impostazione predefinita; Ad Details non ha paginazione né results_limit.

curl -X POST "https://api.socq.ai/v1/tiktok-ad-library/search" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"Anysphere","results_limit":12}'

# Or resolve one known ad URL:
# POST /v1/tiktok-ad-library/ad
# {"url":"https://library.tiktok.com/ads/detail/?id=1871655924410641"}
# Poll GET /v1/tasks/{task_id}

Casi d’uso comuni dell’API della TikTok Ad Library

Monitoraggio dei brand

Crea insiemi periodici di revisione degli annunci pubblici disponibili associati al nome di un inserzionista noto.

Revisione delle creatività

Risolvi annunci selezionati e ispeziona i campi pubblici supportati su testo, inserzionista, formato, media e destinazione.

Archiviazione della trasparenza

Conserva i record pubblicitari pubblici normalizzati con le date di visualizzazione e il contesto della raccolta.

Arricchimento della ricerca

Usa i risultati di ricerca per individuare i record, poi trasforma gli URL di annunci pubblici noti in campi di dettaglio stabili.

Limiti e policy sui dati pubblici

I record pubblicitari pubblici dipendono da visibilità della fonte, idoneità, disponibilità geografica, ritardo di pubblicazione, conservazione e campi esposti dalla superficie di TikTok interessata.

  • L’assenza nei risultati di ricerca non prova che un inserzionista non abbia mai pubblicato un annuncio, e gli URL non disponibili possono non produrre alcun risultato di dettaglio.
  • Search non espone controlli per paese, data, sezione, lingua, settore, obiettivo, arricchimento od ordinamento.
  • Le date, il pubblico o le impression pubblici non sono report privati su spesa, conversioni, attribuzione o ritorno sulla spesa pubblicitaria.
  • I riferimenti ai media possono essere temporanei o controllati dalla fonte, e tutti i campi che dipendono dalla fonte possono essere null o vuoti.

Domande frequenti sull’API della TikTok Ad Library

SocQ è TikTok Ads Manager?

No. SocQ cerca e normalizza i record di trasparenza pubblici supportati; non gestisce account, campagne, budget, targeting o creatività.

Che cosa posso inviare?

Search accetta il nome di un inserzionista o una parola chiave. Ad Details accetta l’URL di un solo annuncio pubblico di TikTok noto e idoneo.

Ogni risultato contiene i dettagli completi dell’annuncio?

No. Search restituisce di solito riepiloghi, la ricerca di dettaglio può non restituire alcun record e tutti i campi che dipendono dalla fonte possono essere null o vuoti.

Come si calcola il costo di utilizzo?

Ogni record restituito costa 0,5 crediti SocQ senza alcun costo di base; Search restituisce 12 risultati per impostazione predefinita e Ad Details al massimo uno.

Riunisci in un unico flusso i dati pubblici di profili, contenuti ed engagement di piattaforme diverse per monitorare brand, creator e argomenti e condurre monitoraggi e analisi cross-platform in modo più efficiente.