Threads Search
La ricerca di Threads porta in primo piano i post che l’app classifica più in alto per una parola chiave o un hashtag, e ognuno arriva con testo, autore, data di pubblicazione, immagini o video allegati e numero di Mi piace, risposte e repost. Ne risulta una lettura rapida di come si parla in questo momento di un argomento, di un prodotto o di un evento, e di quali account guidano la conversazione.
Funzionalità della Threads Search API
- Una query, i post principaliInserisci una parola chiave o un hashtag in query e ricevi i post principali che Threads mostra, circa 20, nella classifica usata dall’app.
- Mi piace, risposte e repost per ogni risultatometrics.likes_count, metrics.comments_count per le risposte e metrics.shares_count per i repost mostrano quali risultati attirano più attenzione.
- Gli account dietro ogni postauthor restituisce username, nome visualizzato, url del profilo, avatar e is_verified, così chi guida un argomento viene identificato insieme a ciò che ha scritto.
- Media e tempistichemedia elenca immagini o video allegati con le loro dimensioni, e published_at data ogni post per valutarne la recenza.
Parametri della Threads Search API
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
query | Obbligatorio | La parola chiave o l’hashtag da cercare, come basketball o l’hashtag di una campagna. Una query per richiesta. |
Come usare la Threads Search API
Invia una query e leggi i post principali quando l’attività è terminata.
- Invia con POST {"query": "basketball"} a /v1/threads/search e conserva il task_id restituito.
- Interroga GET /v1/tasks/{task_id} finché non indica succeeded.
- Leggi i post in results.items; se has_more è true, richiedi il resto con results.next_cursor.
curl -X POST "https://api.socq.ai/v1/threads/search" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"basketball"}'
# 0.6 credits per post returned; a search with no matches is free.Casi d’uso della Threads Search API
- Tastare il polso di un argomento: Cerca un prodotto, un evento o un tema e leggi il testo dei post principali per capire quali punti di vista e opinioni guidano la discussione.
- Individuare le voci che guidano una conversazione: Ordina gli autori dei risultati per Mi piace e repost ottenuti dai loro post, e annota quali sono verificati, per costruire una lista di contatti o di monitoraggio.
- Monitorare il nome di un brand o un hashtag: Esegui periodicamente la stessa query, conserva gli id dei nuovi post con il loro published_at e avrai un registro aggiornato delle nuove menzioni.
Consigli degli esperti per la Threads Search API
- Dividi un tema ampio in più query mirate, come nomi di prodotto, varianti di scrittura e hashtag correlati, perché ogni ricerca restituisce circa 20 post principali.
- Unisci per id i risultati di query che si sovrappongono, così un post che compare in due ricerche viene contato una volta sola.
- Nei report, intitola metrics.comments_count come numero di risposte e metrics.shares_count come numero di repost.
- Passa l’url di qualsiasi risultato a Threads Post Replies API quando ti serve la conversazione che c’è sotto.
API correlate
Oltre alla Threads 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 User Search API — Trova account Threads per nome o username con username, nome visualizzato, URL del profilo, avatar e stato di verifica.
- Threads User Replies API — Raccoglie dagli URL dei profili Threads le ultime risposte pubbliche pubblicate da un account, con testo, engagement, media e link.