TikTok Creative Center è il posto in cui i marketer cercano gli annunci con le prestazioni migliori, gli hashtag in crescita in un paese e i video in cima alle classifiche. Il Creator Marketplace aggiunge i dati sul pubblico e le tariffe di partenza dei creator. Il 2026-11-17 SocQ ha aggiunto sei endpoint che restituiscono questi dati in JSON, elencati nella pagina della piattaforma TikTok Creative Center.
I sei endpoint funzionano in tre coppie. Un endpoint elenco trova i candidati e un endpoint di dettaglio prende l'ID da quell'elenco e restituisce l'approfondimento. Questa guida tratta ogni coppia: cosa restituisce, la richiesta, il prezzo e quando usarla.
Risposta rapida: invia un body JSON a
POST https://api.socq.ai/v1/tiktok-creative-center/<endpoint>. Salva iltask_idrestituito, interrogaGET /v1/tasks/{task_id}finchéstatusnon èsucceeded, poi leggidata.results.items.
I nuovi endpoint di TikTok Creative Center
1 credito SocQ = $0.005. Gli endpoint elenco addebitano per risultato, senza costo base.
| Endpoint | Cosa restituisce | Prezzo |
|---|---|---|
| Top Ads API | Gli annunci con le prestazioni migliori, con didascalia, inserzionista, settore, obiettivo, CTR, like e video | 0.5 crediti ($0.0025) per annuncio |
| Ad Analysis API | Dettagli di un annuncio, percentile delle impression e curve di click-through e retention secondo per secondo | 1 credito ($0.005) per chiamata |
| Trending Hashtags API | Hashtag di tendenza in un paese con posizione, post, visualizzazioni e curva di popolarità giornaliera | 0.5 crediti ($0.0025) per hashtag |
| Hashtag Insights API | Totali di un hashtag, curva di popolarità, paesi principali e ID di video di esempio | 0.5 crediti ($0.0025) per chiamata |
| Top Videos API | La classifica dei video migliori di un paese con posizione, creator, visualizzazioni nel periodo e totali e tassi di engagement | 0.5 crediti ($0.0025) per video |
| Creator Marketplace API | Schede dei creator con età, genere, paese e dispositivi dei follower, visualizzazioni mediane, tasso di engagement e tariffa di partenza | 0.5 crediti ($0.0025) per creator |
Autenticazione e flusso asincrono dei task
Tutte le richieste si autenticano con una chiave API. Lo stesso header serve per l'invio, lo stato del task e i risultati:
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
Ogni raccolta viene eseguita come task in background:
submit -> task_id -> queued -> running -> succeeded
\-> failed
La chiamata di invio risponde subito con data.task_id e data.status. Interroga il task con quell'ID:
curl "https://api.socq.ai/v1/tasks/$TASK_ID?limit=50" \
-H "Authorization: Bearer $SOCQ_API_KEY"
Quando status è succeeded, la risposta include result_count, credits_amount e la prima pagina di record normalizzati in data.results.items. limit vale 50 per impostazione predefinita e arriva fino a 500. Se results.has_more è true, passa results.next_cursor come cursor per leggere la pagina successiva. Un task fallito riporta error_message.
Tutti gli endpoint qui descritti accettano anche un callback_url facoltativo. Al termine del task SocQ invia una sola POST con un riepilogo; i record vanno letti dall'endpoint del task. Un timeout lato client non annulla il task, quindi riprendi con lo stesso ID invece di inviarlo di nuovo. Un 402 indica che l'account ha esaurito i crediti, un 429 che la chiave ha raggiunto un limite di frequenza o di crediti.
Top Ads e Ad Analysis: costruisci una raccolta di riferimenti creativi
La Top Ads API sfoglia gli annunci che TikTok Creative Center classifica come i più performanti. Ogni annuncio include didascalia, inserzionista, settore, obiettivo della campagna, ctr, like e il video completo. Tutti i campi sono facoltativi: query cerca nelle didascalie e nei brand degli annunci, time_range è 7d, 30d (predefinito) o 180d, e sort_by è relevance (predefinito) o likes. results_limit vale 20 per impostazione predefinita e accetta da 1 a 300. (docs)
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"}'
La Ad Analysis API prende l'id di un risultato di Top Ads come ad_id. Oltre a dettagli, paesi e landing page dell'annuncio, restituisce impressions_percentile rispetto ad annunci comparabili, una click_through_curve e una retention_curve, ciascuna con un valore per ogni secondo di video. Leggi le due curve insieme per individuare l'hook, il punto in cui gli spettatori abbandonano e il momento in cui agiscono. (docs)
curl -X POST "https://api.socq.ai/v1/tiktok-creative-center/ad-analysis" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"ad_id": "7697084527089729557"}'
Quando usarle: ricerca creativa per una nuova campagna. Recupera 20 annunci migliori nella tua categoria (10 crediti), poi analizza i cinque più pertinenti (5 crediti). In totale 15 crediti, cioè $0.075.
Trending Hashtags e Hashtag Insights: individua i tag in crescita per paese
La Trending Hashtags API restituisce gli hashtag in crescita in un paese, ciascuno con posizione, numero di post, numero di visualizzazioni e una popularity_curve giornaliera per il periodo. Tutti i campi sono facoltativi: country è un codice di due lettere (predefinito US) e time_range è 7d (predefinito), 30d o 90d. results_limit vale 20 per impostazione predefinita e accetta da 1 a 100. (docs)
curl -X POST "https://api.socq.ai/v1/tiktok-creative-center/trending-hashtags" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"country": "US", "time_range": "7d", "results_limit": 20}'
La Hashtag Insights API prende un id di Trending Hashtags come hashtag_id, insieme allo stesso country. Restituisce i totali di post e visualizzazioni, la curva di popolarità giornaliera, top_countries con un punteggio che indica quanto il tag è popolare rispetto alle dimensioni di ciascun paese, e i video_ids di alcuni video di esempio. time_range vale 7d per impostazione predefinita. (docs)
curl -X POST "https://api.socq.ai/v1/tiktok-creative-center/trending-hashtag-detail" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"hashtag_id": "7155204034885287979", "country": "US", "time_range": "7d"}'
Quando usarle: scegliere gli hashtag per un lancio in un mercato specifico, oppure verificare se un tag è globale o locale prima di costruirci attorno dei contenuti. Per misurare un hashtag che hai già in mente, anche se non è di tendenza, la TikTok Hashtag Views API restituisce video e visualizzazioni totali per un massimo di 20 tag alla volta.
Top Videos e Creator Marketplace: trova i creator e le loro tariffe
La Top Videos API legge la classifica di TikTok Creative Center dei video più performanti in un paese. Ogni voce ha posizione, didascalia, creator, creator_id, visualizzazioni nel periodo della classifica, visualizzazioni organiche, visualizzazioni totali, tasso di engagement e tasso di visualizzazione a sei secondi. Tutti i campi sono facoltativi: country vale US per impostazione predefinita, period è daily (predefinito), weekly o long_term, e sort_by è views (predefinito), engagement_rate o six_second_view_rate. Viene usata l'ultima classifica pubblicata. results_limit vale 20 per impostazione predefinita e accetta da 1 a 100. (docs)
curl -X POST "https://api.socq.ai/v1/tiktok-creative-center/top-videos" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"country": "US", "period": "daily", "results_limit": 20}'
La Creator Marketplace API prende da 1 a 20 creator_ids numerici, ad esempio i valori creator_id di Top Videos. Ogni creator con una scheda restituisce la distribuzione per età, genere, paese e dispositivo dei follower, il numero di follower, le visualizzazioni mediane, il tasso di engagement, il tasso di crescita dei follower, il tasso di visualizzazione a sei secondi, gli ID dei video recenti e lo starting_price indicato per un video sponsorizzato. Vengono addebitati solo i creator che hanno una scheda. (docs)
curl -X POST "https://api.socq.ai/v1/tiktok-creative-center/creator-cards" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"creator_ids": ["7011198409688219653", "7070293872819044358"]}'
Quando usarle: costruire una shortlist di creator tenendo conto del budget. Una classifica giornaliera di 20 video (10 crediti) e le schede di 20 creator (10 crediti) costano 20 crediti, cioè $0.10.
Come si integra con gli altri endpoint di TikTok
I dati di Creative Center sono aggregati da TikTok: classifiche, posizioni e curve. Per il profilo, i video e i commenti di un singolo creator, usa gli endpoint della guida allo scraping di TikTok. Per i paesi dei follower ricavati dall'account pubblico di un creator e per i controlli sulle visualizzazioni false, consulta la guida ai nuovi endpoint di TikTok. Gli annunci pubblicati su Meta sono coperti dalle API della Facebook Ad Library.
Domande frequenti
Serve un account TikTok Ads o Creator Marketplace?
No. Ti autentichi con una chiave API SocQ e invii i campi mostrati sopra.
Da dove viene ad_id?
Da un risultato di Top Ads: passa il suo id ad Ad Analysis come ad_id. Allo stesso modo, l'id di Trending Hashtags va a Hashtag Insights come hashtag_id, e il creator_id di Top Videos va a Creator Marketplace.
Quali paesi posso interrogare?
Trending Hashtags, Hashtag Insights e Top Videos accettano un codice country di due lettere, come US, GB o JP, con US come valore predefinito. Per Hashtag Insights usa lo stesso country con cui hai trovato l'hashtag.
La tariffa di partenza di un creator è sempre presente?
La tariffa fa parte della scheda del Creator Marketplace, e restituiscono un risultato solo i creator che hanno una scheda. Come per gli altri campi SocQ, un valore che la fonte non fornisce viene restituito come null.
Come vengono addebitati i risultati vuoti?
Gli endpoint a pagamento per risultato non hanno costo base, quindi una chiamata che non restituisce nulla non costa nulla. Ad Analysis e Hashtag Insights vengono addebitati una volta per chiamata.
TIKTOK CREATIVE CENTER API
Prova il flusso di lavoro con un URL pubblico di TikTok Creative Center
Invia input pubblici e ricevi record normalizzati con un contesto di origine tracciabile.
Scopri le API di TikTok Creative Center