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.

threads/posts
Post0,5 crediti per risultato

threads/profiles
Profili0,6 crediti per risultato

threads/user-posts
Post0,5 crediti per risultato

threads/post-replies
Commenti0,3 crediti per risultato

threads/search
Ricerca0,6 crediti per risultato

threads/search-users
Ricerca0,6 crediti per risultato

threads/user-replies
Post0,5 crediti per risultato

threads/user-reposts
Post0,5 crediti per risultato
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à | SocQ | API di Threads |
|---|---|---|
| Uso principale | Raccogliere profili pubblici, post e i post recenti di un utente | Creare integrazioni autorizzate di pubblicazione, risposte, insight e scoperta |
| OAuth del cliente | Chiave API di SocQ; nessun OAuth Threads del cliente | App Meta, autorizzazione dell’utente Threads e token di accesso |
| Input iniziale | URL pubblico di un profilo o di un post di Threads | Contesto di un account autorizzato, ID di Threads e parametri di ricerca supportati |
| Pubblicare o gestire risposte | Non supportato | Supportato con i permessi di Threads richiesti |
| Formato della risposta | Record normalizzati di SocQ | Oggetti 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. Invia gli URL pubblici
Invia gli URL di profili o post all’API corrispondente e salva il task_id restituito.
2. Segui l’attività
Interroga /v1/tasks/{task_id} finché l’elaborazione non è completata.
3. Recupera i risultati
Leggi data.results.items e usa next_cursor finché has_more è true.
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 trueCasi 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.
Combina i dati di più piattaforme per analisi di business più complete
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.
Bluesky API
Recupera i profili pubblici di Bluesky, risolvi URL di post noti o raccogli una pagina di post di un account, con campi normalizzati di identità, contenuti, media, timestamp ed engagement visibile.
Snapchat API
Recupera uno Spotlight pubblico noto di Snapchat come record normalizzato con i campi disponibili su creator, didascalia, media, audio, data, durata ed engagement.
Twitch API
Risolvi un nome utente Twitch pubblico noto in un profilo normalizzato, raccogli il suo inventario di video pubblici o recupera una clip con il suo video scaricabile per ricerca sui creator, arricchimento del catalogo, confronto e monitoraggio con istantanee.
Rednote API
Recupera profili e note pubblici, cerca note o utenti, raccogli commenti e risposte annidate e acquisisci una pagina di consigli della home.
Kwai API
Recupera profili Kwai pubblici, una pagina di post di un account o un post noto, con identità, contenuti, media, timestamp ed engagement visibile normalizzati.
Truth Social API
Recupera i dettagli pubblici di un account, raccogli una pagina della fonte con i post di un account o risolvi l’URL di un post noto in record normalizzati.