Torna alle API
Dati di ricerca del TikTok Creative Center

TikTok Creative Center API

Trasforma le classifiche del TikTok Creative Center in dati che puoi interrogare: migliori annunci, hashtag di tendenza per paese, classifiche dei migliori video e schede del Creator Marketplace.

API del TikTok Creative Center disponibili

Top Ads, Trending Hashtags e Top Videos leggono le classifiche; Ad Analysis, Hashtag Insights e Creator Marketplace approfondiscono un annuncio, un hashtag o un gruppo di creator presi da quelle classifiche.

Quali dati del Creative Center puoi recuperare?

Ogni endpoint restituisce record stabili di SocQ costruiti a partire da ciò che il Creative Center mostra per l’annuncio, l’hashtag, la classifica o il creator scelto.

Annunci con le migliori prestazioni

Didascalia, settore, obiettivo, punteggio di clic, Mi piace e video degli annunci selezionati dal Creative Center, più, per un singolo annuncio, i paesi di destinazione, il percentile delle impression e le curve di clic e di fidelizzazione secondo per secondo.

Hashtag di tendenza

Classifiche per paese su 7, 30 o 90 giorni con posizione, numero di post e di visualizzazioni e curva di popolarità giornaliera; Hashtag Insights aggiunge, per un singolo hashtag, i paesi principali per punteggio e gli ID di alcuni video di esempio.

Classifiche dei migliori video

Classifiche giornaliere, settimanali e di lungo periodo per paese, con didascalia, creator, visualizzazioni nel periodo, visualizzazioni organiche e totali, tasso di engagement, tasso di visualizzazione a sei secondi e ID Marketplace del creator.

Schede del Creator Marketplace

Quote dei follower per età, genere, paese e dispositivo, visualizzazioni mediane, tassi di engagement e di crescita dei follower e tariffa di partenza che ogni creator indica per un video sponsorizzato.

SocQ e TikTok Creative Center

Il Creative Center è il sito di ricerca di TikTok per consultare le classifiche in un’interfaccia web. SocQ restituisce le stesse classifiche come record API che puoi archiviare, confrontare e combinare.

FunzionalitàSocQTikTok Creative Center
AccessoChiave API e record JSONInterfaccia web
Raccolta in bloccoFino a 300 annunci, 100 hashtag o 100 video per attivitàConsultazione pagina per pagina
Analisi di approfondimentoGli ID di una classifica alimentano l’endpoint successivoNavigazione manuale tra le pagine
OutputCampi stabili di SocQ con descrizioniGrafici e schede visive

Come funzionano le API del TikTok Creative Center

Tutti e sei gli endpoint usano lo stesso ciclo di vita asincrono di invio, interrogazione e lettura.

  1. 1. Leggi una classifica

    Invia filtri a Top Ads, Trending Hashtags o Top Videos, per esempio una parola chiave, un paese o un periodo.

  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. Approfondisci

    Invia l’id di un annuncio a Ad Analysis, l’id di un hashtag a Hashtag Insights o i valori creator_id a Creator Marketplace.

Inizia con una sola richiesta API

Autenticati con una chiave API di SocQ. Top Ads restituisce 20 risultati per impostazione predefinita e ne accetta fino a 300.

curl -X POST "https://api.socq.ai/v1/tiktok-creative-center/top-ads" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"skincare","time_range":"30d","sort_by":"likes"}'

# Then analyze one ad:
# POST /v1/tiktok-creative-center/ad-analysis
# {"ad_id":"7697084527089729557"}
# Poll GET /v1/tasks/{task_id}

Casi d’uso comuni dell’API del TikTok Creative Center

Ricerca sugli annunci dei concorrenti

Cerca in Top Ads per parola chiave, ordina per Mi piace e leggi settore, obiettivo e punteggio di clic di ogni annuncio per capire quali approcci creativi premia una categoria.

Diagnosi degli abbandoni di un annuncio

Invia un id di Top Ads a Ad Analysis e confronta secondo per secondo click_through_curve e retention_curve per vedere dove gli spettatori fanno clic e dove abbandonano.

Monitoraggio degli hashtag per mercato

Recupera a intervalli regolari gli hashtag di tendenza di ogni paese di interesse e usa popularity_curve per vedere quali sono ancora in crescita prima di pianificare i post.

Benchmark di hook e copertura

Ordina la classifica dei video di un paese per six_second_view_rate e confronta organic_views_count con views_count per capire quali aperture trattengono gli spettatori e quali video sono stati soprattutto promossi.

Selezione dei creator

Prendi i valori creator_id dalle classifiche dei video e confronta quote del pubblico, visualizzazioni mediane, engagement e tariffa di partenza indicata nelle loro schede del Creator Marketplace.

Ambito dei dati

I risultati seguono ciò che il Creative Center pubblica per ogni classifica, mercato e periodo.

  • Top Ads elenca gli annunci che superano le soglie di prestazione del Creative Center e che i rispettivi inserzionisti hanno autorizzato, quindi è una selezione curata e non l’insieme di tutti gli annunci su TikTok.
  • Le classifiche dei video vengono pubblicate con un certo ritardo, circa due giorni per la classifica giornaliera e settimane che terminano di domenica per quella settimanale; un mercato senza classifica restituisce zero risultati e non viene addebitato.
  • Le schede del Creator Marketplace esistono solo per i creator iscritti al Creator Marketplace di TikTok e si cercano per ID Marketplace, quindi gli ID presi altrove non trovano corrispondenza.
  • Le classifiche degli hashtag accettano solo un paese e un intervallo di tempo, senza filtro per settore, e le righe della classifica lasciano i paesi principali e i video di esempio a Hashtag Insights.
  • Punteggi di clic, percentili e valori di popolarità sono misure relative riportate dal Creative Center, non report delle campagne a livello di account.

Domande frequenti sull’API del TikTok Creative Center

Che cos’è TikTok Creative Center API?

TikTok Creative Center API è un’interfaccia programmatica per leggere come record JSON normalizzati i migliori annunci, gli hashtag di tendenza, le classifiche dei migliori video e le schede del Creator Marketplace del TikTok Creative Center.

Mi serve un account TikTok o un account pubblicitario?

No. Le richieste usano la tua chiave API di SocQ e leggono le classifiche che il Creative Center pubblica nelle sue pagine di ricerca pubbliche.

Come passo da una classifica a un singolo annuncio, hashtag o creator?

Ogni classifica restituisce l’ID richiesto dal relativo endpoint di dettaglio: l’id dell’annuncio va a Ad Analysis, l’id dell’hashtag a Hashtag Insights insieme allo stesso paese e il creator_id di Top Videos a Creator Marketplace.

Qual è la differenza tra Top Ads e Top Videos?

Top Ads restituisce annunci TikTok a pagamento con punteggio di clic, settore e obiettivo. Top Videos restituisce la classifica dei video di un paese con visualizzazioni, visualizzazioni organiche e tassi di engagement, più l’ID Marketplace di ogni creator.

Quanto sono aggiornati i dati?

Ogni richiesta restituisce ciò che il Creative Center ha pubblicato in quel momento e ogni record riporta il timestamp collected_at. Le classifiche giornaliere dei video sono indietro di circa due giorni rispetto alla data corrente e quelle settimanali terminano di domenica.

Quanto costano gli endpoint?

Top Ads, Trending Hashtags, Top Videos e Creator Marketplace costano 0,5 crediti per risultato restituito. Ad Analysis costa 1 credito e Hashtag Insights 0,5 crediti per richiesta.

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.