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
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
urls | Obbligatorio | Elenco 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.
- Prepara uno o più URL di post pubblici di Threads nel formato /@username/post/{post_id} su threads.com o threads.net.
- Invia i link come urls a /v1/threads/posts e salva il task_id restituito.
- Interroga /v1/tasks/{task_id} finché l’attività non va a buon fine o restituisce un errore.
- 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 trueCasi 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.
API correlate
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.