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
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
query | Obbligatorio | Parola chiave o nome di ricerca per trovare account di creator TikTok pubblici corrispondenti. |
results_limit | Facoltativo | Numero 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à.
- Scegli una parola chiave per la query di ricerca e un results_limit facoltativo fino a 2.000.
- Invia una richiesta POST a /v1/tiktok/search-users con la tua chiave API SocQ.
- Interroga /v1/tasks/{task_id} finché lo stato è succeeded.
- 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.
API correlate
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.
- TikTok Comments API
- TikTok Videos API
- TikTok Comment Replies API
- TikTok Following List 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