Torna alle API
Dati pubblici di Threads

Threads Public Data API

Recupera profili Threads pubblici, risolvi post noti o raccogli i post di profili selezionati con campi normalizzati su identità, contenuti, media, engagement e date.

API di Threads disponibili

Usa Profiles per i dati degli account, Posts per un singolo post pubblico noto o User Posts per una raccolta limitata di profili selezionati.

Quali dati di Threads puoi recuperare?

SocQ restituisce record pubblici normalizzati di account e post con identità, contenuti, media, engagement visibile, fonte e contesto del momento della raccolta.

Dettagli pubblici del profilo

Recupera ID dei profili, URL, nomi utente, nomi visualizzati, biografie, immagini, siti web collegati, conteggi visibili degli account e momento della raccolta.

Contenuto di post noti

Trasforma l’URL di un post pubblico in identità del post, testo, dettagli dell’autore, URL di origine e media disponibili.

Engagement visibile dei post

Conserva le date di pubblicazione e di raccolta insieme ai conteggi disponibili di Mi piace, commenti, repost e condivisioni.

Post di profili selezionati

Sfoglia un insieme limitato di post pubblici di ogni URL di profilo e mantieni il profilo inviato collegato ai risultati.

SocQ vs API di Threads

SocQ si concentra sulla raccolta di dati pubblici supportati di Threads. L’API di Threads di Meta è pensata per pubblicazione autorizzata, risposte, insight e flussi di lavoro di scoperta supportati.

FunzionalitàSocQAPI di Threads
Uso principaleRaccogliere profili pubblici, post e i post recenti di un utenteCreare integrazioni autorizzate di pubblicazione, risposte, insight e scoperta
OAuth del clienteChiave API di SocQ; nessun OAuth Threads del clienteApp Meta, autorizzazione dell’utente Threads e token di accesso
Input inizialeURL pubblico di un profilo o di un post di ThreadsContesto di un account autorizzato, ID di Threads e parametri di ricerca supportati
Pubblicare o gestire risposteNon supportatoSupportato con i permessi di Threads richiesti
Formato della rispostaRecord normalizzati di SocQOggetti nativi della Graph API di Threads

Come funziona l’API di Threads

Profiles, Posts e User Posts usano lo stesso flusso di lavoro con attività asincrona e risultati paginati.

  1. 1. Invia gli URL pubblici

    Invia gli URL di profili o post all’API corrispondente e salva il task_id restituito.

  2. 2. Segui l’attività

    Interroga /v1/tasks/{task_id} finché l’elaborazione non è completata.

  3. 3. Recupera i risultati

    Leggi data.results.items e usa next_cursor finché has_more è true.

Raccogli i post di un profilo Threads

Autenticati con la tua chiave API di SocQ e invia a User Posts l’URL di un profilo pubblico. Profiles e Posts usano lo stesso flusso di attività.

curl -X POST "https://api.socq.ai/v1/threads/user-posts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.threads.com/@example"],"results_limit":100}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Casi d’uso comuni dell’API di Threads

Ricerca su creator e profili

Arricchisci gli URL di profilo noti con identità pubblica, biografia, sito web, metriche visibili dell’account e momento della raccolta.

Analisi di post noti

Trasforma gli URL dei post selezionati in contenuto, autore, media, data di pubblicazione, engagement visibile e campi di origine.

Monitoraggio dei contenuti dei creator

Raccogli un insieme limitato di post di profili selezionati e confronta i contenuti tra raccolte ripetute.

Reportistica sull’engagement

Usa i conteggi visibili e collected_at per confrontare le istantanee dei post pubblici, senza considerarle metriche in tempo reale.

Limiti e policy sui dati pubblici

I risultati di Threads sono record pubblici riferiti a un preciso momento. Queste API non accedono a contenuti privati e non pubblicano, modificano, eliminano né gestiscono account e post di Threads.

  • Profiles accetta URL /@username di threads.com e threads.net. I nomi utente semplici e gli URL dei post vengono rifiutati.
  • Posts accetta URL /@username/post/{post_id}. Non supporta results_limit né la scoperta dei post di un profilo.
  • User Posts accetta URL di profilo /@username. results_limit ha il valore predefinito 100, accetta da 1 a 2.000 e si applica separatamente a ogni profilo.
  • User Posts non indica se un risultato sia un post originale, una risposta, una citazione o un repost.
  • Un post può includere comments_count, ma le singole risposte e gli alberi delle risposte non vengono restituiti.
  • I campi facoltativi di identità, contenuto, media, data ed engagement possono essere vuoti se il record pubblico non li espone.

Domande frequenti sull’API di Threads

Che cos’è l’API di Threads?

L’API di Threads è un insieme di endpoint di SocQ per recuperare dati pubblici dei profili, risolvere post noti e raccogliere un insieme limitato di post di profili selezionati.

Quale API di Threads devo usare?

Usa Profiles per i record degli account /@username, Posts per i link esatti /@username/post/{post_id} e User Posts per una raccolta limitata da ogni URL di profilo /@username.

Come funziona il limite dei risultati di User Posts?

results_limit ha il valore predefinito 100, accetta numeri interi da 1 a 2.000 e si applica separatamente a ogni URL di profilo inviato.

I risultati di User Posts indicano risposte o repost?

Nel risultato normalizzato non è esposto alcun sottotipo di post. Considera ogni elemento come un post pubblico trovato a partire dal profilo inviato, senza dedurre se sia un post originale, una risposta, una citazione o un repost.

I post di Threads e le metriche di engagement sono completi o in tempo reale?

No. I risultati riflettono i campi pubblici disponibili al momento della raccolta, non includono gli alberi completi delle risposte e vanno considerati istantanee riferite a un preciso momento, non feed in tempo reale.

Quanto costa la raccolta di dati da Threads?

Ogni profilo restituito costa 0,6 crediti, mentre ogni post restituito da Posts o User Posts costa 0,5 crediti. Gli insiemi di risultati vuoti non hanno alcun costo per i risultati.

Riunisci in un unico flusso i dati pubblici di profili, contenuti ed engagement di piattaforme diverse per monitorare brand, creator e argomenti e condurre monitoraggi e analisi cross-platform in modo più efficiente.