threads/
posts

Raccogli i post pubblici di Threads a partire dagli URL supportati, con testo, identità dell’autore, media, data di pubblicazione ed engagement visibile in record normalizzati.

Threads Posts API

Input con URL del post
Contesto dell’autore
Istantanea dell’engagement
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 Posts

I post di Threads sono pubblicazioni pubbliche basate sul testo, con identità dell’autore, riferimenti ai media, data di pubblicazione e conteggi visibili di Mi piace, commenti, repost e condivisioni. Questi record supportano la ricerca su post selezionati, la verifica delle fonti, il confronto dei contenuti e l’analisi dell’engagement con indicazione temporale.

Funzionalità della Threads Posts API

  • Risoluzione diretta dell’URL del postTrasforma gli URL pubblici di threads.com o threads.net nel formato /@username/post/{post_id} in record dei post inviati, e non di un feed del profilo.
  • Contenuto del post e attribuzione dell’autoreRestituisce identificatori dei post, URL di origine, testo e, se disponibili, ID, nomi utente, nomi visualizzati e URL dei profili degli autori, per record tracciabili.
  • Media e istantanea dell’engagement visibileMantiene insieme, per ogni post, i riferimenti ai media normalizzati, gli orari di pubblicazione e raccolta e i conteggi visibili di Mi piace, commenti, repost e condivisioni.

Parametri della Threads Posts API

ParametriObbligatorioDescrizione
urlsObbligatorioElenco obbligatorio di URL di post pubblici di Threads su threads.com o threads.net nel formato /@username/post/{post_id}.

Come usare la Threads Posts API

Invia i post pubblici di Threads che già conosci, segui l’attività asincrona e leggi i risultati normalizzati con la paginazione a cursore.

  1. Prepara uno o più URL di post pubblici di Threads nel formato /@username/post/{post_id} su threads.com o threads.net.
  2. Invia i link come urls a /v1/threads/posts e 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/posts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.threads.com/@example/post/POST_ID"]}'

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

Casi d’uso della Threads Posts API

  • Arricchire un elenco di post selezionati: Converti URL di post noti in record con ID, testo, campi dell’autore, media, timestamp e link di origine per un dataset definito.
  • Verificare contenuti pubblici e attribuzione: Usa testo, riferimenti ai media, identità dell’autore e URL originale per esaminare pubblicazioni selezionate mantenendo la loro fonte pubblica.
  • Confrontare le istantanee dell’engagement: Abbina likes_count, comments_count, reposts_count e shares_count a collected_at per confrontare osservazioni raccolte in momenti diversi.

Consigli degli esperti per la Threads Posts API

  • Convalida ogni URL rispetto al formato /@username/post/{post_id} prima dell’invio, così pagine di profili e altri percorsi di Threads non fanno fallire la richiesta.
  • Deduplica i link inviati in base al percorso del post prima di raggrupparli, così gli hostname alternativi supportati non generano lavoro ripetuto per lo stesso post.
  • Usa questo endpoint solo per URL di post noti e ometti results_limit, perché non scopre il feed di un profilo né espande un post nelle risposte.
  • Tratta testo, campi dell’autore, media, data di pubblicazione e singole metriche come facoltativi, così un post pubblico esposto solo in parte non interrompe l’elaborazione dei risultati.
  • Salva collected_at insieme ai campi di engagement visibili per conservare il momento in cui è stata osservata ogni istantanea.

Oltre alla Threads Posts API, usa queste API quando ti serve un altro tipo di dati pubblici di Threads.

  • 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 User Posts API — Individua i post pubblici dagli URL dei profili di Threads con un limite per profilo, contenuti normalizzati, autori, media, date, engagement visibile e contesto della fonte.
  • 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 Posts API — FAQ

Threads Posts API trasforma gli URL pubblici supportati dei post di Threads in record normalizzati con testo, identità dell’autore, media, data di pubblicazione e conteggi visibili di Mi piace, commenti, repost e condivisioni.

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/post/{post_id}. Le pagine dei profili e gli altri formati di percorso vengono rifiutati.

No. Il payload di selezione dei post usa urls senza results_limit, perché ogni input identifica un post pubblico specifico e non un feed da limitare.

No. Un record di post può includere il valore visibile di comments_count, ma non contiene il testo delle risposte, i loro autori né un albero delle risposte.

Testo, dettagli dell’autore, media, data di pubblicazione e singoli valori di engagement possono essere vuoti quando il record della fonte pubblica non espone un valore utilizzabile.

Ogni record di post restituito costa 0,5 crediti SocQ. Un insieme di risultati vuoto non comporta alcun addebito.