threads/
profiles

Raccogli i profili pubblici di Threads a partire dagli URL supportati, con identità normalizzata, biografie, immagini del profilo, siti web e metriche visibili dell’account.

Threads Profiles API

Input con URL del profilo
Campi di identità e sito web
Metriche visibili dell’account
0,6 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 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

ParametriObbligatorioDescrizione
urlsObbligatorioElenco 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.

  1. Prepara uno o più URL di profili pubblici di Threads nel formato /@username su threads.com o threads.net.
  2. Invia i link come urls a /v1/threads/profiles 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/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 true

Casi 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.

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.

Esplora altre piattaforme

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

Threads Profiles API — FAQ

Threads Profiles API recupera i record dei profili pubblici da uno o più URL di profili Threads supportati. Restituisce identità normalizzata, biografia, immagine del profilo, sito web, conteggi visibili di follower, seguiti e post e momento di raccolta.

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 risultati possono includere ID del profilo, URL, nome utente, nome visualizzato, biografia, immagine del profilo, sito web, conteggi di follower, seguiti e post e momento di raccolta.

Un record di profilo pubblico può non fornire una biografia, un’immagine del profilo, un sito web o tutti i conteggi visibili. I client dovrebbero accettare valori facoltativi null o vuoti.

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