I primi endpoint Threads di SocQ leggono profili pubblici, singoli post e i post di un utente. Il 2026-11-17 ne sono arrivati altri cinque. Due sono di ricerca: trovare post per parola chiave o hashtag e trovare account per nome. Gli altri tre leggono conversazioni e amplificazione: le risposte sotto un post, le risposte che un account lascia altrove e i post che ripubblica.
Questa guida spiega cosa restituisce ogni nuovo endpoint, la richiesta, il prezzo e quando usarlo. Per un confronto con l’API Threads ufficiale di Meta e con altri fornitori, vedi alternative alle API di Threads.
Risposta rapida: invia una
queryaPOST /v1/threads/searcho/search-users, oppure URL di Threads inurlsa/post-replies,/user-replieso/user-reposts, conAuthorization: Bearer $SOCQ_API_KEY. InterrogaGET /v1/tasks/{task_id}finchéstatusnon èsucceeded, poi leggidata.results.items. I prezzi vanno da 0.3 a 0.6 crediti per risultato (da $0.0015 a $0.003, a $0.005 per credito), senza quota base.
I cinque nuovi endpoint Threads
| Endpoint | Cosa restituisce | Input | Prezzo |
|---|---|---|---|
| Search | I post principali per una parola chiave o un hashtag, circa 20, con testo, autore, like, risposte, repost, media e ora | query | 0.6 crediti ($0.003) per post |
| User Search | Gli account che corrispondono a un nome o a un nome utente, di solito fino a 10, con nome visualizzato, avatar e verifica | query | 0.6 crediti ($0.003) per account |
| Post Replies | Le risposte sotto un post, circa 20 per post, con autore, like, risposte, media e ora | URL dei post | 0.3 crediti ($0.0015) per risposta |
| User Replies | Le ultime risposte pubbliche di un account, fino a circa 25, con engagement e media | URL dei profili | 0.5 crediti ($0.0025) per risposta |
| User Reposts | I post che un account ha ripubblicato di recente, fino a circa 25, ciascuno con il suo autore originale | URL dei profili | 0.5 crediti ($0.0025) per post |
Cerca su Threads
Threads Search: post per parola chiave o hashtag
La Threads Search API cerca su Threads come fa l’app e restituisce i post principali per una parola chiave o un hashtag. Ogni post include testo, autore, like, risposte, repost, media e ora di pubblicazione. È il modo più rapido per vedere come si parla di un argomento, un prodotto o un evento su Threads e per trovare gli account che guidano la conversazione.
curl -X POST "https://api.socq.ai/v1/threads/search" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"query": "basketball"
}'
Ogni ricerca restituisce i post principali che Threads mostra per la query, circa 20. L’engagement si trova sotto metrics: likes_count, comments_count e shares_count. Consulta la documentazione di Search.
Threads User Search: account per nome
La Threads User Search API trova account per nome o nome utente. Ogni risultato restituisce nome utente, nome visualizzato, URL del profilo, avatar e stato di verifica. Usala per confermare l’handle giusto prima di recuperare post o risposte, o per trasformare un elenco di nomi in profili Threads per la ricerca di influencer.
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"
}'
Ogni ricerca restituisce gli account suggeriti da Threads, di solito fino a 10. Consulta la documentazione di User Search.
Leggi conversazioni e repost
Threads Post Replies: la conversazione sotto un post
La Threads Post Replies API legge la conversazione sotto un post. Ogni risposta include testo, autore, numero di like e di risposte, media allegati e ora, più il post_id del post a cui risponde. Usala per misurare la reazione a un annuncio, raccogliere il feedback dei clienti dai post di un brand o trovare le persone più coinvolte nel pubblico di un creator.
curl -X POST "https://api.socq.ai/v1/threads/post-replies" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"urls": ["https://www.threads.com/@unrivaledbasketball/post/Dfa88pLDs_1"]
}'
Usa URL dei post nel formato /@{username}/post/{code}. Ogni post restituisce le risposte che Threads mostra sotto di esso, circa 20. Consulta la documentazione di Post Replies.
Threads User Replies: come un account parla con gli altri
La Threads User Replies API restituisce le ultime risposte pubbliche di un account con testo, like, risposte, media, ora e link a ogni risposta. Le risposte mostrano tono e competenza in modo più diretto dei post curati, il che le rende utili per valutare i creator, monitorare un portavoce o studiare come un brand gestisce le conversazioni con i clienti.
curl -X POST "https://api.socq.ai/v1/threads/user-replies" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"urls": ["https://www.threads.com/@reuters"]
}'
Usa URL dei profili come https://www.threads.com/@username. Ogni profilo restituisce fino a circa 25 risposte. Consulta la documentazione di User Replies.
Threads User Reposts: chi amplifica un account
La Threads User Reposts API restituisce i post che un account ha scelto di ripubblicare. Ogni riga è il post originale con autore, testo, engagement e media. La cronologia dei repost è un segnale diretto di affinità: mappa le voci di cui un creator si fida, i partner che un brand promuove e i contenuti che si diffondono in una community.
curl -X POST "https://api.socq.ai/v1/threads/user-reposts" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"urls": ["https://www.threads.com/@shams"]
}'
Ogni profilo restituisce fino a circa 25 repost recenti; author è l’autore originale, non l’account che ha ripubblicato. Consulta la documentazione di User Reposts.
Un semplice flusso di ricerca
- Esegui Search sul nome di un prodotto o su un hashtag per trovare i post con cui le persone interagiscono.
- Passa gli URL dei post più forti a Post Replies per leggere le reazioni.
- Usa User Search per risolvere in handle i nomi che emergono, poi User Replies e User Reposts su quei profili per vedere come parlano e chi amplificano.
- Per i post di un account o i dettagli del profilo, usa gli endpoint precedenti User Posts e Profiles.
Autenticazione e flusso asincrono dei task
Ogni richiesta include la tua chiave API e un content type JSON:
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
Ogni chiamata di invio avvia un task in background:
submit -> task_id -> queued -> running -> succeeded
\-> failed
La risposta all’invio restituisce data.task_id e data.status. Interroga il task con la stessa chiave:
curl "https://api.socq.ai/v1/tasks/$TASK_ID?limit=50" \
-H "Authorization: Bearer $SOCQ_API_KEY"
Finché il task è queued, running o failed, la risposta contiene solo i metadati del task; in caso di failed, leggi error_message. Quando è succeeded, la stessa risposta include la prima pagina di record normalizzati in data.results.items. limit vale 50 per impostazione predefinita e arriva fino a 500. Se has_more è true, passa results.next_cursor come cursor per leggere la pagina successiva. fields accetta fino a 50 campi o percorsi puntati separati da virgole.
Un timeout lato client non annulla il task, quindi riprendi con lo stesso task_id invece di inviarlo di nuovo e pagare un duplicato. Puoi anche aggiungere callback_url al corpo dell’invio per ricevere una POST con il riepilogo del task quando termina.
Quanto costa un lavoro tipico
- Una ricerca per parola chiave che restituisce 20 post: 20 × 0.6 = 12 crediti, $0.06.
- Risposte sotto 10 post, circa 20 ciascuno: 200 × 0.3 = 60 crediti, $0.30.
- Risposte e repost di 10 account, circa 25 ciascuno: 500 × 0.5 = 250 crediti, $1.25.
FAQ
Posso andare oltre i primi 20 risultati di ricerca?
Search restituisce i post principali che Threads mostra per la query, circa 20 per ricerca. Per ampliare la copertura, esegui parole chiave o hashtag correlati come ricerche separate.
Mi serve un login di Threads o Instagram?
No. Una richiesta contiene solo la tua chiave API SocQ e una query o URL pubblici di Threads; non include credenziali di alcun account Threads.
User Reposts mostra chi ha ripubblicato?
Lo richiedi per un solo profilo, quindi ogni riga è stata ripubblicata da quel profilo. L’author di ogni riga è l’autore originale.
Posso inviare più profili o post in una volta?
Sì. Post Replies, User Replies e User Reposts accettano un elenco in urls, e i conteggi dei risultati si applicano per URL.
Dove posso vedere tutti gli endpoint Threads e i prezzi?
Nella pagina della piattaforma Threads e nella pagina dei prezzi.
THREADS API
Prova il flusso di lavoro con un URL pubblico di Threads
Invia input pubblici e ricevi record normalizzati con un contesto di origine tracciabile.
Scopri le API di Threads