TikTok Search
I risultati di TikTok Search sono video pubblici corrispondenti a una parola chiave o a una frase, con dettagli del creator, didascalie, media, contesto di pubblicazione ed engagement visibile. Questi record supportano la scoperta degli argomenti, la ricerca sulle tendenze, il monitoraggio dei concorrenti e l’analisi delle opportunità di contenuto.
Funzionalità della TikTok Search API
- Scoperta di video per parola chiaveTrasforma la parola chiave di un argomento, un brand, un prodotto o un evento in un insieme di video candidati.
- Ordinamento per pertinenza e attualitàPassa tra pertinenza, data e Mi piace per ottenere prospettive tematiche, recenti o con molti Mi piace.
- Finestre di pubblicazioneDefinisci il periodo di ricerca con day, week, month, three_months o six_months.
- Campi di contenuto e creatorRestituisce campi di video, creator, engagement, hashtag e musica in una struttura coerente dei risultati di ricerca.
- Istantanee di ricerca tracciabiliRegistra ogni esperimento di ricerca tramite search_query e collected_at.
Parametri della TikTok Search API
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
query | Obbligatorio | Query a parola chiave obbligatoria e non vuota per la scoperta di video TikTok pubblici. |
results_limit | Facoltativo | Limite positivo richiesto di risultati video. Il valore predefinito è 100. |
sort_by | Facoltativo | Ordinamento dei risultati: relevance, date o likes. Il valore predefinito è relevance. |
published_within | Facoltativo | Finestra di pubblicazione facoltativa: day, week, month, three_months o six_months. |
Come usare la TikTok Search API
Definisci prima la domanda di ricerca, poi scegli la parola chiave, l’obiettivo di ordinamento e la finestra di pubblicazione.
- Trasforma l’argomento di ricerca in una query specifica e scegli results_limit, sort_by e published_within.
- Invia la richiesta con POST a /v1/tiktok/search e salva il task_id restituito.
- Interroga /v1/tasks/{task_id} finché l’attività raggiunge succeeded o failed.
- Leggi data.results.items. Quando has_more è true, continua con next_cursor.
curl -X POST "https://api.socq.ai/v1/tiktok/search" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"space exploration","results_limit":100,"sort_by":"relevance","published_within":"month"}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueCasi d’uso della TikTok Search API
- Analisi di mercato e di categoria: Usa termini di prodotto, categoria e caso d’uso per mappare il panorama dei contenuti TikTok e il campione di creator.
- Monitoraggio dello slancio degli eventi: Combina l’ordinamento per data con una finestra di un giorno o una settimana per seguire i contenuti recenti attorno a lanci, eventi e notizie.
- Ricerca creativa sui contenuti con molti Mi piace: Ordina per Mi piace e studia hook, didascalie, scelte musicali e combinazioni di hashtag ricorrenti.
- Monitoraggio delle menzioni del brand: Esegui query su brand e prodotti a intervalli regolari e salva istantanee per i team di contenuti e comunicazione.
Consigli degli esperti per la TikTok Search API
- Dividi un argomento ampio in query su brand, esigenza, occasione e tendenza, poi unisci gli insiemi di video ottenuti.
- Scegli relevance per mappare un argomento, date per seguire le nuove pubblicazioni e likes per studiare i modelli creativi più popolari.
- Usa published_within per mantenere i campioni su una scala temporale coerente, per esempio week per i report ricorrenti.
- Salva insieme query, sort_by, published_within e collected_at, così la ricerca può essere riprodotta.
- Deduplica tra le query per id del video e conserva ogni search_query che ha trovato il video.
- Ripeti le query principali a intervalli regolari per confrontare i cambiamenti di creator, temi ed engagement.
API correlate
Oltre alla TikTok Search API, usa queste API quando ti serve un altro tipo di dati pubblici di TikTok.
- TikTok Profiles API — Recupera identità del profilo pubblico, bio, flag dell’account e conteggi del pubblico a partire dal nome utente.
- TikTok Hashtags API — Raccoglie video pubblici, creator, media, suoni ed engagement per gli hashtag indicati.
- TikTok Comments API — Raccoglie i commenti pubblici di primo livello, autori, engagement, menzioni e flag di interazione del creator.
- TikTok Videos API — Recupera creator, didascalia, media, musica, tag, menzioni ed engagement dagli URL dei video.
- TikTok Live Room Info API — Consulta una diretta nota tramite la coppia di ID della stanza e del proprietario, restituendo stato, contesto del proprietario, immagine di copertina e conteggi del pubblico.
- TikTok Search Users API — Cerca account TikTok pubblici per parola chiave.
- TikTok Comment Replies API
- TikTok Followers List API
- TikTok Following List API
- TikTok User Videos API
- TikTok Trending Feed API
- TikTok Video Transcript API
- TikTok Song API
- TikTok Song Videos API
- TikTok Popular Songs API
- TikTok Top Search API
- TikTok User Live API
- TikTok Audience Demographics API
- TikTok Similar Accounts API
- TikTok Reposts API
- TikTok Playlists API
- TikTok Hashtag Views API
- TikTok Sound Search API
- TikTok Live Search API
- TikTok Photo Search API
- TikTok Trending Searches API
- TikTok Creator Search Insights API
- TikTok Live Ranking API
- TikTok Live Shopping API
- TikTok Fake Views Checker API
- TikTok Comment Keywords API