ThreadsRicerca su ThreadsRisposte su ThreadsGuida alle API

API di ricerca Threads: cerca post e utenti, raccogli risposte e repost

Cinque nuovi endpoint SocQ per Threads: ricerca di post per parola chiave e hashtag, ricerca utenti, risposte sotto un post, risposte di un utente e repost di un utente, con richieste e prezzi per risultato.

SocQAggiornato il 19 novembre 20267 min di lettura

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 query a POST /v1/threads/search o /search-users, oppure URL di Threads in urls a /post-replies, /user-replies o /user-reposts, con Authorization: Bearer $SOCQ_API_KEY. Interroga GET /v1/tasks/{task_id} finché status non è succeeded, poi leggi data.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

EndpointCosa restituisceInputPrezzo
SearchI post principali per una parola chiave o un hashtag, circa 20, con testo, autore, like, risposte, repost, media e oraquery0.6 crediti ($0.003) per post
User SearchGli account che corrispondono a un nome o a un nome utente, di solito fino a 10, con nome visualizzato, avatar e verificaquery0.6 crediti ($0.003) per account
Post RepliesLe risposte sotto un post, circa 20 per post, con autore, like, risposte, media e oraURL dei post0.3 crediti ($0.0015) per risposta
User RepliesLe ultime risposte pubbliche di un account, fino a circa 25, con engagement e mediaURL dei profili0.5 crediti ($0.0025) per risposta
User RepostsI post che un account ha ripubblicato di recente, fino a circa 25, ciascuno con il suo autore originaleURL dei profili0.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

  1. Esegui Search sul nome di un prodotto o su un hashtag per trovare i post con cui le persone interagiscono.
  2. Passa gli URL dei post più forti a Post Replies per leggere le reazioni.
  3. 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.
  4. 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