tiktok/
search-users

Cerca per parola chiave i creator e gli account TikTok pubblici per raccogliere identità normalizzata del profilo, numero di follower e informazioni della bio.

TikTok Search Users API

Ricerca di creator
Profili normalizzati
Scoperta di talenti
0,6 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 Users

La ricerca per parola chiave negli account pubblici dei creator permette di scoprire influencer di nicchia, profili di brand e creator di argomenti di tendenza. I record normalizzati degli account restituiscono handle dei profili, nomi visualizzati, biografie e numero di follower al momento della raccolta, per la ricerca di talenti.

Funzionalità della TikTok Search Users API

  • Scoperta di account per parola chiaveInvia una qualsiasi stringa di ricerca per trovare account TikTok pubblici, handle di creator e profili di community pertinenti.
  • Profili di creator normalizzatiRicevi record strutturati con nome utente, nome visualizzato, avatar, testo della bio e badge di account verificato.
  • Metriche del pubblicoEstrai il numero visibile di follower, di seguiti e il totale dei video pubblicati, riferiti al momento della raccolta.
  • Limite di risultati configurabileControlla la dimensione del lotto di risultati fino a 2.000 creator, con paginazione interna automatica a cursore.

Parametri della TikTok Search Users API

ParametriObbligatorioDescrizione
queryObbligatorioParola chiave o nome di ricerca per trovare account di creator TikTok pubblici corrispondenti.
results_limitFacoltativoNumero massimo di profili di creator da restituire; il valore predefinito è 100, con un intervallo da 1 a 2.000.

Come usare la TikTok Search Users API

Invia una query di ricerca come attività asincrona, poi recupera i record normalizzati dei creator interrogando l’attività.

  1. Scegli una parola chiave per la query di ricerca e un results_limit facoltativo fino a 2.000.
  2. Invia una richiesta POST a /v1/tiktok/search-users con la tua chiave API SocQ.
  3. Interroga /v1/tasks/{task_id} finché lo stato è succeeded.
  4. Recupera gli elementi di profilo normalizzati da data.results.items.
curl -X POST "https://api.socq.ai/v1/tiktok/search-users" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"taylor swift","results_limit":20}'

# Poll GET /v1/tasks/{task_id}, then inspect data.results.items.

Casi d’uso della TikTok Search Users API

  • Selezione di influencer e creator: Individua i creator pertinenti in nicchie specifiche e valuta le loro metriche attuali del pubblico.
  • Monitoraggio del brand e rilevamento di contraffazioni: Cerca i nomi dei brand per trovare account non ufficiali, impostori o community di fan.
  • Indicizzazione di database di talenti: Alimenta piattaforme CRM o di analisi con metadati aggiornati sull’identità dei creator e sui follower.

Consigli degli esperti per la TikTok Search Users API

  • Usa parole chiave di nicchia specifiche o frammenti di handle per restringere in modo efficace i risultati di ricerca.
  • Valori più alti di results_limit scorrono automaticamente più pagine a monte.
  • Controlla il booleano is_verified per distinguere gli account di celebrità confermati dalle pagine di fan.
  • Prosegui con TikTok User Videos per analizzare le prestazioni dei contenuti recenti dei risultati migliori.

Oltre alla TikTok Search Users 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 Search API — Cerca video pubblici per parola chiave con ordinamento e filtri di pubblicazione supportati.
  • TikTok Followers List API — Raccoglie i profili normalizzati visibili negli elenchi pubblici dei follower, con contesto della fonte conservato e metriche supportate.
  • TikTok User Videos API — Raccoglie i video pubblici del feed di un profilo a partire dal nome utente con didascalie, creator, media, date, engagement e contesto dell’account di origine.
  • 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.

Esplora altre piattaforme

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

TikTok Search Users API — FAQ

TikTok Search Users API offre una scoperta guidata da parole chiave degli account e dei profili pubblici dei creator su TikTok. Restituisce nomi utente normalizzati, nomi visualizzati, numero di follower e flag di verifica degli account, senza richiedere l’autenticazione di una sessione utente.

No. Tutte le richieste si autenticano con la tua chiave API SocQ, senza bisogno di un account sviluppatore ufficiale TikTok né di OAuth dell’utente.

L’endpoint TikTok Search restituisce i video pubblici che corrispondono a una query, mentre TikTok Search Users scopre in modo specifico account di creator e profili di canale.