Threads Profiles
I profili di Threads sono pagine pubbliche di account con nomi utente, nomi visualizzati, biografie, immagini del profilo, siti web e conteggi visibili di follower, seguiti e post. Questi campi di identità e segnali dell’account supportano l’arricchimento dei profili, il confronto tra account pubblici e il monitoraggio nel tempo.
Funzionalità della Threads Profiles API
- Lotti di URL di profili supportatiElabora uno o più URL di profili di threads.com o threads.net nel formato /@username, rifiutando i link ai post e i percorsi non pertinenti.
- Identità del profilo normalizzataRestituisce ID del profilo, URL, nome utente, nome visualizzato, biografia, immagine del profilo e sito web collegato in un record del profilo coerente.
- Istantanee visibili dell’accountMantiene i conteggi disponibili di follower, seguiti e post insieme a collected_at, così ogni insieme di metriche pubbliche ha un momento di osservazione.
Parametri della Threads Profiles 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 il formato /@username; nomi utente semplici, URL di post e percorsi non pertinenti vengono rifiutati. |
Come usare la Threads Profiles API
Invia URL di profili pubblici noti, segui l’attività asincrona e leggi i record dei profili 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 i link come urls a /v1/threads/profiles 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/profiles" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.threads.com/@example"]}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueCasi d’uso della Threads Profiles API
- Arricchimento dei profili pubblici: Aggiungi nome utente, nome visualizzato, biografia, immagine del profilo, sito web e URL di origine ai record collegati a profili Threads noti.
- Confronto dell’impronta degli account: Confronta i conteggi visibili di follower, seguiti e post all’interno di un gruppo selezionato di profili pubblici.
- Monitoraggio dei profili pubblici: Salva i campi di identità e le metriche visibili con collected_at per confrontare la presentazione del profilo e i segnali dell’account in momenti di raccolta diversi.
Consigli degli esperti per la Threads Profiles API
- Convalida ogni URL rispetto al formato /@username su threads.com o threads.net prima dell’invio, così i link ai post e i percorsi non pertinenti non fanno fallire la richiesta.
- Normalizza gli URL inviati e deduplica i profili restituiti per id quando è disponibile, usando url come chiave stabile di riserva.
- Tratta biografia, immagine del profilo, sito web e singole metriche dell’account come campi facoltativi, così i record pubblici parziali restano utilizzabili.
- Tieni collected_at accanto ai conteggi di follower, seguiti e post, così le esecuzioni successive restano distinguibili come istantanee pubbliche separate.
API correlate
Oltre alla Threads Profiles 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 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.