Threads User Search
La ricerca utenti di Threads è l’elenco degli account che l’app suggerisce per un nome o un handle digitato, ognuno identificato da username, nome visualizzato, link al profilo, avatar e badge di verifica. Questi identificativi permettono di distinguere una persona o un brand reale dagli account con nomi simili e di trasformare un semplice elenco di nomi in profili Threads confermati.
Funzionalità della Threads User Search API
- Corrispondenze su nomi e handlequery accetta un nome visualizzato o uno username, e la risposta contiene gli account che Threads suggerisce, di solito fino a 10.
- Campi di identità pronti all’usoOgni risultato restituisce username, name e url, il link al profilo nella forma /@username che gli altri endpoint di Threads accettano come input.
- Badge e avatar per evitare ambiguitàis_verified e avatar_url aiutano a scegliere l’account autentico quando più risultati hanno lo stesso nome.
Parametri della Threads User Search API
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
query | Obbligatorio | Il nome di una persona o di un brand, oppure uno username di Threads, come shams. |
Come usare la Threads User Search API
Cerca un nome e leggi gli account suggeriti.
- Invia con POST {"query": "shams"} a /v1/threads/search-users.
- Interroga GET /v1/tasks/{task_id} con il task_id restituito finché lo status non è succeeded.
- Leggi gli account corrispondenti da results.items, seguendo results.next_cursor ogni volta che has_more è true.
curl -X POST "https://api.socq.ai/v1/threads/search-users" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"shams"}'
# 0.6 credits for each account returned.Casi d’uso della Threads User Search API
- Confermare un handle prima di raccogliere contenuti: Controlla username, nome visualizzato e is_verified per scegliere la corrispondenza giusta, poi usa il suo url per ottenere post, risposte o repost di quell’account.
- Trasformare un elenco di nomi in profili Threads: Cerca ogni nome di una lista di influencer o giornalisti e conserva l’url della corrispondenza verificata per costruire una colonna di link ai profili Threads.
- Individuare account sosia: Cerca un brand o un personaggio pubblico ed esamina le corrispondenze non verificate con nomi e avatar quasi identici, possibili imitatori o pagine di fan.
Consigli degli esperti per la Threads User Search API
- Prova sia il nome completo sia un probabile handle quando l’account che cerchi manca dal primo gruppo di risultati, perché query cerca su entrambi.
- Scegli una corrispondenza in base a username e is_verified invece di prendere la prima riga, perché i nomi comuni restituiscono diversi account simili.
- Passa l’url scelto direttamente a Threads User Posts, User Replies o User Reposts API, che accettano tutte link al profilo in questa stessa forma.
API correlate
Oltre alla Threads User Search API, usa queste API quando ti serve un altro tipo di dati pubblici di Threads.
- Threads Posts API — Raccoglie testo dei post pubblici, contesto dell’autore, media, date ed engagement visibile dagli URL dei post di Threads supportati.
- Threads Profiles API — Raccoglie identità del profilo pubblico, bio, immagini, siti web, conteggi visibili dell’account e contesto della raccolta dagli URL dei profili di Threads supportati.
- Threads User Posts API — Individua i post pubblici dagli URL dei profili di Threads con un limite per profilo, contenuti normalizzati, autori, media, date, engagement visibile e contesto della fonte.
- Threads Post Replies API — Raccoglie le risposte sotto i post di Threads dagli URL dei post, con testo, autori, numero di Mi piace e di risposte, media e ID del post a cui rispondono.
- Threads Search API — Cerca su Threads per parola chiave o hashtag i post principali, con testo, autori, Mi piace, risposte, repost, media e data di pubblicazione.
- Threads User Replies API — Raccoglie dagli URL dei profili Threads le ultime risposte pubbliche pubblicate da un account, con testo, engagement, media e link.