threads/
user-posts

Scopri i post pubblici di Threads a partire da uno o più URL di profili supportati, con testo del post, contesto dell’autore, media, timestamp ed engagement visibile come record normalizzati.

Threads User Posts API

Input con URL del profilo
Limite di risultati per profilo
Post pubblici normalizzati
0,5 crediti per risultato
Pronto
Pronto

Inserisci i parametri e invia una richiesta. Qui compariranno lo stato dell’attività e i risultati normalizzati.

README

A cura di SocQ · Aggiornato il

Threads User Posts

I Threads User Posts sono pubblicazioni pubbliche individuate dalle pagine di profili selezionati, con testo del post, identità dell’autore, riferimenti ai media, orari di pubblicazione e conteggi visibili di engagement. Questi record e i timestamp di raccolta supportano l’archiviazione dei contenuti degli account, la ricerca sui formati e il confronto dell’engagement pubblico.

Funzionalità della Threads User Posts API

  • Scoperta limitata basata sui profiliAccetta uno o più URL di profili pubblici di Threads e applica results_limit separatamente a ciascun profilo, con un valore predefinito di 100 e un intervallo accettato da 1 a 2.000.
  • Record normalizzati di post, autori e mediaRestituisce identificatori dei post, URL di origine, testo, identità dell’autore disponibile e riferimenti pubblici ai media in una struttura di risultato coerente.
  • Contesto di engagement e scopertaMantiene i conteggi visibili di Mi piace, commenti, repost e condivisioni insieme a data di pubblicazione, collected_at e contesto del profilo inviato, quando fornito dal record di origine.

Parametri della Threads User Posts API

ParametriObbligatorioDescrizione
urlsObbligatorioElenco obbligatorio di URL di profili pubblici di Threads su threads.com o threads.net. Ogni percorso deve usare /@username; nomi utente semplici, URL di post e percorsi non pertinenti vengono rifiutati.
results_limitFacoltativoNumero massimo di post richiesti per ciascun URL di profilo; il valore predefinito è 100 e accetta numeri interi da 1 a 2.000.

Come usare la Threads User Posts API

Invia URL di profili pubblici di Threads con un limite di risultati per profilo, segui l’attività asincrona e leggi i post normalizzati con la paginazione a cursore.

  1. Prepara uno o più URL di profili pubblici di Threads nel formato /@username su threads.com o threads.net.
  2. Invia con POST urls e un results_limit facoltativo a /v1/threads/user-posts, poi salva il task_id restituito.
  3. Interroga /v1/tasks/{task_id} finché l’attività non va a buon fine o restituisce un errore.
  4. Leggi data.results.items, poi richiedi il next_cursor restituito finché has_more resta true.
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 della Threads User Posts API

  • Dataset di post di profili selezionati: Conserva ID dei post, URL di origine, testo, campi dell’autore, riferimenti ai media, timestamp e contesto del profilo inviato per un gruppo definito di profili pubblici.
  • Ricerca su contenuti e formati: Usa il testo dei post, i riferimenti pubblici ai media, l’attribuzione dell’autore e gli orari di pubblicazione per esaminare gli argomenti ricorrenti e i formati dei contenuti in profili selezionati.
  • Confronto dell’engagement pubblico: Confronta i conteggi visibili di Mi piace, commenti, repost e condivisioni tra raccolte di profili, usando collected_at come riferimento per ogni osservazione.

Consigli degli esperti per la Threads User Posts API

  • Convalida ogni input come URL di profilo /@username di threads.com o threads.net prima dell’invio, così nomi utente semplici, link ai post e percorsi non pertinenti non fanno fallire la richiesta.
  • Calcola la profondità richiesta e la stima dei crediti precedente alla richiesta come numero di urls moltiplicato per results_limit, perché il limite si applica separatamente a ogni profilo.
  • Salva discovery_input, input_url e collected_at con ogni risultato, così i record a valle conservano il profilo inviato e il momento dell’osservazione.
  • Tratta testo, campi dell’autore, media, created_at e singole metriche come facoltativi e non dedurre se un record sia un post originale, una risposta, una citazione o un repost, perché non viene esposto alcun sottotipo.

Oltre alla Threads User Posts 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 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 Search API — Cerca su Threads per parola chiave o hashtag i post principali, con testo, autori, Mi piace, risposte, repost, media e data di pubblicazione.
  • Threads User Replies API — Raccoglie dagli URL dei profili Threads le ultime risposte pubbliche pubblicate da un account, con testo, engagement, media e link.
  • Threads User Reposts API — Raccoglie dagli URL dei profili Threads i post ricondivisi di recente da un account, ognuno come post originale con autore, testo, engagement e media.

Esplora altre piattaforme

Combina i dati di Threads con i dati pubblici delle altre piattaforme social supportate.

Threads User Posts API — FAQ

Threads User Posts API individua i record dei post pubblici da uno o più URL di profili Threads supportati. Restituisce testo dei post, contesto dell’autore, media, timestamp, engagement visibile e contesto del profilo inviato, in forma normalizzata.

Invia un URL HTTP o HTTPS su threads.com, www.threads.com, threads.net o www.threads.net il cui percorso segue il formato /@username. Nomi utente semplici, URL di post e altri formati di percorso vengono rifiutati.

I record possono includere ID del post, URL, testo, identità pubblica dell’autore, riferimenti ai media, conteggi visibili di Mi piace, commenti, repost e condivisioni, created_at, collected_at e un contesto aggiuntivo di scoperta o di input. I valori facoltativi della fonte possono essere null o vuoti.

results_limit ha come valore predefinito 100 e accetta numeri interi da 1 a 2.000. Si applica a ogni URL di profilo, quindi due URL con results_limit 50 richiedono fino a 100 post.

Nella risposta normalizzata non viene esposto alcun sottotipo di post. Considera ogni elemento come un post pubblico individuato dall’URL del profilo inviato, senza dedurre se sia un post originale, una risposta, una citazione o un repost.

Ogni record di post restituito costa 0,5 crediti SocQ. La stima usa urls moltiplicato per results_limit e un insieme di risultati vuoto non comporta alcun addebito.