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
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
urls | Obbligatorio | Elenco 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_limit | Facoltativo | Numero 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.
- Prepara uno o più URL di profili pubblici di Threads nel formato /@username su threads.com o threads.net.
- Invia con POST urls e un results_limit facoltativo a /v1/threads/user-posts, poi 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/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 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.
API correlate
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.