tiktok/
search

Cerca i video TikTok pubblici per parola chiave con filtri di pertinenza, data, Mi piace e finestra di pubblicazione, con record normalizzati su creator, contenuti, media ed engagement.

TikTok Search API

Scoperta per parola chiave
Campioni di ricerca
Finestre temporali
0,7 crediti per risultato
Pronto
Pronto

Inserisci i parametri e invia una richiesta. Qui compariranno lo stato dell’attività e i risultati normalizzati.

README

A cura di SocQ · Aggiornato il

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

ParametriObbligatorioDescrizione
queryObbligatorioQuery a parola chiave obbligatoria e non vuota per la scoperta di video TikTok pubblici.
results_limitFacoltativoLimite positivo richiesto di risultati video. Il valore predefinito è 100.
sort_byFacoltativoOrdinamento dei risultati: relevance, date o likes. Il valore predefinito è relevance.
published_withinFacoltativoFinestra 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.

  1. Trasforma l’argomento di ricerca in una query specifica e scegli results_limit, sort_by e published_within.
  2. Invia la richiesta con POST a /v1/tiktok/search e salva il task_id restituito.
  3. Interroga /v1/tasks/{task_id} finché l’attività raggiunge succeeded o failed.
  4. 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 true

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

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.

Esplora altre piattaforme

Combina i dati di TikTok con i dati pubblici delle altre piattaforme social supportate.

TikTok Search API — FAQ

TikTok Search API trova i video accessibili pubblicamente a partire da una parola chiave o da una frase. Restituisce dati normalizzati su video, creator, didascalia, media, pubblicazione ed engagement, con ordinamento e filtri temporali supportati.

query è una parola chiave o una frase obbligatoria e non vuota, per esempio un brand, un prodotto, una campagna, una persona o un argomento di ricerca.

relevance organizza i risultati per pertinenza all’argomento, date dà risalto alle pubblicazioni recenti e likes dà risalto ai Mi piace pubblici. relevance è il valore predefinito.

published_within accetta day, week, month, three_months e six_months per i video pubblicati nel corrispondente periodo recente.

results_limit imposta il limite richiesto di risultati video, deve essere un numero intero positivo e ha come valore predefinito 100.

I risultati includono ID del video, URL canonico, didascalia, lingua, orario di pubblicazione, creator, engagement pubblico, hashtag, menzioni, media e dati musicali.

search_query registra il termine che ha prodotto il risultato, mentre collected_at registra il momento di raccolta per avere istantanee di ricerca tracciabili.

Ogni risultato normalizzato di un video di ricerca restituito costa 0,7 crediti.