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à | SocQ | Prodotti pubblicitari di TikTok |
|---|---|---|
| Uso principale | Cercare e normalizzare i record pubblici di annunci supportati | Trasparenza pubblica o operazioni autorizzate sulle campagne, a seconda del prodotto |
| Input | Un inserzionista o una parola chiave, oppure l’URL di un annuncio noto | I controlli variano in base alla superficie di TikTok interessata |
| Dati privati delle campagne | Non disponibili | Richiedono l’account, il prodotto, l’approvazione e i permessi applicabili |
| Azioni | Flusso di lavoro di dati pubblici in sola lettura | Ads Manager supporta le operazioni autorizzate sulle campagne |
| Formato della risposta | Record di annunci stabili di SocQ | Viste 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. 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. Interroga l’attività
Usa il task_id restituito con /v1/tasks/{task_id} finché l’elaborazione non riesce o non fallisce.
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.
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.
Combina i dati di più piattaforme per analisi di business più complete
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.
YouTube API
Raccogli profili dei canali YouTube pubblici supportati, dettagli dei video, video dei canali, commenti, Shorts, risultati per parola chiave e hashtag e trascrizioni disponibili con un unico flusso di lavoro asincrono normalizzato.
Facebook API
Raccogli profili di pagine Facebook pubbliche, post, post di gruppi, commenti, eventi trovati per parola chiave e trascrizioni disponibili dei video, con campi normalizzati di identità, contenuti, origine, formato, luogo, media, reazioni, partecipazione ed engagement.
X API
Raccogli profili pubblici, relazioni di follower e seguiti, post, risposte, citazioni, repost, risultati di ricerca e tendenze attuali. Usa risultati coerenti per ricerca e monitoraggio.
LinkedIn API
Recupera dati pubblici di profili, aziende, post e offerte di lavoro su LinkedIn a partire da URL noti, con campi normalizzati su identità, carriera, azienda, contenuti, engagement e offerte.
Reddit API
Recupera post e commenti pubblici di Reddit a partire da URL noti, sfoglia i post new, top o hot dei subreddit oppure cerca discussioni per parola chiave e periodo di pubblicazione.
Pinterest API
Recupera dati pubblici dei profili Pinterest, risolvi Pin noti, raccogli i Pin di profili selezionati o cerca per parola chiave per ricerche su creator, contenuti e tendenze visive.

