L'API di TikTok può cercare video, hashtag o trend?
Sì, l'API di TikTok può cercare video, annunci e trend, ciascuno in un'API separata: la Research API cerca video pubblici per parola chiave, hashtag, nome utente, regione o data, per i ricercatori che TikTok approva. La Commercial Content API cerca annunci per parola chiave o nome dell'inserzionista. L'API for Business restituisce gli hashtag più popolari, i loro video di tendenza e le parole chiave di ricerca in tendenza. La Display API legge il profilo e i video di un utente autorizzato.
easyCoexistence collega gli account TikTok tramite l'API for Business di TikTok, così Claude, ChatGPT o la tua piattaforma elencano i post e i commenti dell'account e leggono le sue statistiche, e get_social_credentials fornisce al tuo codice il token per gli endpoint business/ come i suggerimenti di hashtag, con ogni connessione monitorata 24 ore su 24.
Richieste della Research API consentite al giorno, per un massimo di 100.000 record, con il contatore azzerato alle 00:00 UTC.
Intervallo massimo tra start_date e end_date in una singola query video della Research API, che restituisce fino a 100 video per richiesta.
/discovery/trending_list/ classifica gli hashtag più popolari per un paese e una categoria negli ultimi 1, 7, 30 o 120 giorni.
/discovery/trending/search/ restituisce, per account con Advanced Access o un Verified Business Account, le parole chiave di ricerca in tendenza.
Lunghezza massima di search_term accettata dalla Commercial Content API, cercata come frase esatta per impostazione predefinita o come frase fuzzy.
Quale API TikTok può cercare?
Diverse, su due portali per sviluppatori, ciascuno pensato per un tipo diverso di sviluppatore. developers.tiktok.com ospita la Research API, la Commercial Content API e la Display API; business-api.tiktok.com ospita l'API for Business, i cui endpoint Discovery, Accounts e Mentions coprono i trend e i contenuti dell'azienda stessa:
Come cerca i video la Research API?
Con POST https://open.tiktokapis.com/v2/research/video/query/ e un client access token con lo scope research.data.basic. L'oggetto query combina condizioni and, or e not, ciascuna un'operazione come EQ o IN su un campo come keyword, hashtag_name, username, region_code, create_date o video_length. start_date e end_date, scritti come YYYYMMDD, possono distare al massimo 30 giorni, e max_count restituisce fino a 100 video per richiesta:
curl -X POST 'https://open.tiktokapis.com/v2/research/video/query/?fields=id,video_description,create_time' \
-H 'Authorization: Bearer <CLIENT_ACCESS_TOKEN>' \
-H 'Content-Type: application/json' \
-d '{
"query": {
"and": [
{ "operation": "IN", "field_name": "region_code", "field_values": ["JP", "US"] },
{ "operation": "EQ", "field_name": "hashtag_name", "field_values": ["animal"] }
],
"not": [
{ "operation": "EQ", "field_name": "video_length", "field_values": ["SHORT"] }
]
},
"max_count": 100,
"start_date": "20261001",
"end_date": "20261030"
}'Cosa restituisce la Research API e quanto sono aggiornati i dati?
I campi video pubblici indicati in fields, come id, video_description, create_time, region_code, view_count, like_count, comment_count, share_count, hashtag_names e username. La FAQ di TikTok avverte che statistiche come le visualizzazioni e il numero di follower possono impiegare fino a 10 giorni per aggiornarsi, e che i nuovi video possono impiegare fino a 48 ore per comparire nella ricerca. La quota giornaliera è di 1.000 richieste, fino a 100.000 record tra le API di ricerca, con reset alle 00:00 UTC.
Chi può usare la Research API?
I ricercatori il cui progetto TikTok approva; un account sviluppatore da solo non concede l'accesso. TikTok elenca istituti accademici negli Stati Uniti, nello SEE, nel Regno Unito, in Canada o in Svizzera, enti di ricerca senza scopo di lucro o indipendenti nell'UE, e organizzazioni accademiche o senza scopo di lucro in Brasile che studiano la sicurezza dei giovani online. I richiedenti devono operare indipendentemente da interessi commerciali, con una proposta di ricerca definita, finanziamenti dichiarati e una revisione etica, e TikTok di solito risponde entro 4 settimane. Alla domanda se creator, inserzionisti e utenti commerciali siano idonei, la sua FAQ risponde di no.
Come si cercano gli annunci con la Commercial Content API?
Con POST https://open.tiktokapis.com/v2/research/adlib/ad/query/ e lo scope research.adlib.basic. search_term accetta fino a 50 caratteri, cercati come exact_phrase per impostazione predefinita oppure come fuzzy_phrase, che trova una qualsiasi o tutte le sue parole in qualunque ordine; i filtri restringono i risultati per date di pubblicazione e paesi di destinazione, e ogni chiamata restituisce al massimo 10 annunci. La pagina prodotto di TikTok dice che i dati partono dagli annunci dell'UE e restano disponibili fino a un anno dopo l'ultima visualizzazione di un annuncio. Il pubblico e i ricercatori di qualunque paese possono presentare domanda tramite un modulo online, e TikTok prevede di rispondere entro 2 giorni lavorativi.
Quali trend restituisce l'API for Business?
Quelli dei suoi endpoint Discovery, che cambiano in base al token che ricevono. /discovery/trending_list/ classifica fino a 200 hashtag popolari per un paese, gli USA per impostazione predefinita, e una categoria di settore, negli ultimi 1, 7, 30 o 120 giorni, con il rank, le visualizzazioni e i post di ciascun hashtag; /discovery/video_list/ restituisce i primi 20 video di tendenza per fino a 10 di questi hashtag. Entrambi richiedono un advertiser_id e il token di accesso di un inserzionista. Altri due richiedono il token di un account TikTok con lo scope discovery.search.words, per account con Advanced Access o un Verified Business Account:
- /discovery/trending/search/: 20 parole chiave di ricerca in tendenza su TikTok, oppure personalizzate per l'account con
is_personalized. - /discovery/trending/search/keyword/: 20 parole chiave di ricerca consigliate per una query fino a 255 caratteri, come un prodotto o un marchio.
Cosa può cercare l'API di un account TikTok?
Gli hashtag per le sue didascalie e i post che contengono i suoi hashtag di marca. GET /business/hashtag/suggestion/ accetta una parola chiave e una lingua facoltativa e restituisce 10 hashtag, ordinati per corrispondenza esatta e poi per numero di post, ciascuno con il suo post_count. L'endpoint Mentions /business/mention/hashtag/video/list/ restituisce fino a 1.000 post pubblici degli ultimi 90 giorni che usano uno degli hashtag di marca attivati dall'azienda, fino a 50 di essi, ordinati per data, mi piace, commenti o condivisioni. Richiede lo scope biz.brand.insights e un account con Advanced Access o un Verified Business Account.
La Display API può cercare?
No. Legge l'utente che ha autorizzato l'app: /v2/user/info/ restituisce il profilo di quell'utente, /v2/video/list/ i suoi video pubblici, dal più recente, fino a 20 per pagina, e /v2/video/query/ video specifici tramite ID, con gli scope user.info.basic e video.list. Nessuno dei suoi endpoint accetta una parola chiave o un hashtag.
Cosa può cercare easyCoexistence su TikTok?
Ciò che risponde l'API dell'account connesso. list_social_posts elenca i post recenti dell'account e list_social_comments i commenti di un post, mentre il tuo codice chiama i percorsi di API for Business sotto business/ con il token di get_social_credentials, suggerimenti di hashtag inclusi. I percorsi /discovery/ richiedono il token di un inserzionista, quindi il token dell'account non li raggiunge, e la Research API e la Commercial Content API sono prodotti separati di developers.tiktok.com con domande di accesso proprie.
GET https://business-api.tiktok.com/open_api/v1.3/business/hashtag/suggestion/
?business_id=<BUSINESS_ID>&keyword=cold%20brew&language=en
Access-Token: <ACCESS_TOKEN>Errori comuni
- Richiedere la Research API per monitorare un marchio. La FAQ di TikTok risponde di no a creator, inserzionisti e utenti commerciali, e approva progetti di ricerca non commerciali.
- Interrogare un periodo lungo in una singola chiamata alla Research API. end_date può trovarsi al massimo 30 giorni dopo start_date, quindi dividi i periodi più lunghi in finestre.
- Leggere i suggerimenti di hashtag come trend. /business/hashtag/suggestion/ ordina per corrispondenza esatta e numero di post, mentre /discovery/trending_list/ classifica la popolarità in un periodo scelto.
- Chiamare gli endpoint di ricerca di tendenza per un account personale. Rispondono per account con Advanced Access o un Verified Business Account, con discovery.search.words sul token.
Da US$ 9 a US$ 0,75 per connessione al mese, con cifre decrescenti man mano che aggiungi connessioni, e con i primi 3 giorni di prova gratuita.
Domande frequenti
Posso cercare video TikTok per parola chiave tramite l'API?
Sì, con la Research API, una volta che TikTok approva il tuo progetto di ricerca: la sua query video accetta condizioni keyword e hashtag_name su video pubblici, fino a 100 per richiesta.
Esiste un'API TikTok per gli hashtag di tendenza?
Sì. /discovery/trending_list/ dell'API for Business classifica fino a 200 hashtag popolari per un paese e una categoria, ciascuno con le sue visualizzazioni e i suoi post, con il token di un inserzionista.
Esiste un'API TikTok per i video di tendenza?
Sì. /discovery/video_list/ dell'API for Business restituisce i primi 20 video di tendenza per fino a 10 hashtag popolari, con un advertiser_id e il token di accesso di un inserzionista.
L'API TikTok può trovare i commenti che menzionano il mio account?
Sì, per account con Advanced Access o un Verified Business Account: /business/mention/comment/list/ dell'API Mentions restituisce fino a 1.000 commenti o risposte che menzionano l'account con @, con gli scope biz.brand.insights e comment.list.
Continua a leggere
Collega il tuo primo canale in due minuti.
Nessuna revisione delle piattaforme da aspettare. Collega WhatsApp, Instagram, TikTok o un altro canale, poi chiedi alla tua AI di pubblicare, rispondere o fare un report, e guardala al lavoro.
- 3 giorni gratis
- Disdici quando vuoi
- Solo API ufficiali
- Monitorato 24/7
Verificato il