API Threads Dettagli
Stato di salute dell'API
- Operatività nelle ultime 24 ore
- Normale
- Buono / normale
- Disponibile
- Limitato
- Quasi del tutto inattivo
Ultime 24 ore
Ultimi 30 giorni
Verifica un account Threads dal suo handle. Ottieni nome visualizzato, bio, numero di follower, link esterno e flag di verifica e privacy. Passa l'handle con o senza @, non l'URL del profilo. I profili privati non vengono aperti.
Invia POST https://api.everyinfra.com/api/v1/social con platform impostato su threads e action impostato su profile. Prezzo $0.56 per 1.000 richieste ($0.000556 per chiamata). Le chiamate non riuscite e i risultati vuoti non vengono addebitati. Sincrona. Per i job più lenti, aggiungi "mode": "async" al corpo della richiesta, recupera il job_id ed esegui il polling.
Threads Details legge il profilo pubblico di un account Threads a partire dal suo handle e restituisce un singolo record: user_id, handle, nome visualizzato, bio, numero di follower, indicatori di verifica e privacy, link al profilo e avatar. Chi si occupa di creator marketing o di ricerca sui social la usa per confermare chi c'è dietro un handle e quanto è ampio il pubblico, per valutare i creator prima di una campagna o per tenere uno storico datato dei follower degli account che monitora.
username è solo l'handle, con o senza @, perché questa funzionalità non interpreta i link completi al profilo. display_name può differire dall'handle. bio è il testo scritto dall'account e può contenere a capo ed emoji, quindi normalizzalo prima di cercare parole chiave. Un follower_count null indica un numero non reso noto, non un pubblico vuoto. avatar_url può essere un link a un'immagine ridimensionata che scade, quindi scarica l'immagine se ti serve conservarla.
Prompt per l'AI
#Aiutami a scrivere uno script di raccolta dei dati con l'endpoint Threads Dettagli di EveryInfra (threads/profile).
Come funziona l'endpoint:
- Richiesta: POST https://api.everyinfra.com/api/v1/social con l'header Authorization: Bearer <chiave API>. Leggi la chiave dalla variabile d'ambiente EVERYINFRA_API_KEY e non scriverla mai direttamente nel codice.
- Nel corpo della richiesta imposta platform su threads e action su profile, e inserisci i parametri in params.
- Parametri obbligatori:
- username: Indica l'handle Threads (con o senza @) per le azioni profile, user_posts e followers. Le azioni profile e user_posts non accettano URL completi del profilo.
- Restituisce un oggetto. Campi principali: user_id, username, display_name, bio, follower_count, is_verified, is_private, url, avatar_url, external_url.
- Esempio di corpo della richiesta:
{
"platform": "threads",
"action": "profile",
"params": {
"username": "zuck"
}
}
- Prezzo: $0.56 per 1.000 richieste; le richieste non riuscite e i risultati vuoti non vengono addebitati.
- Per decine o centinaia di target, aggiungi "mode": "async" al corpo: ricevi subito un job_id ed esegui il polling su GET https://api.everyinfra.com/api/v1/jobs/{job_id} per ottenere il risultato.
- In caso di 422, correggi la richiesta usando i nomi dei parametri e i valori consentiti suggeriti nell'errore; in caso di 429 o 503, attendi il tempo indicato da Retry-After e riprova.
Prima di scrivere il codice, chiedimi quali target mi servono, quanti, quali campi e quale formato di output voglio; poi conferma con me il piano e il costo indicativo.Parametri della richiesta
#| Nome | Posizione | Tipo | Obbligatorio | Predefinito | Descrizione |
|---|---|---|---|---|---|
Authorization | header | string | Sì | - | Bearer seguito dalla tua chiave API. Creala nella console; non inserirla mai in un URL o in un repository di codice. |
platform | body | string | Sì | threads | Identificativo della piattaforma, valore fisso. |
action | body | string | Sì | profile | Identificativo della funzionalità, valore fisso. |
username | body.params | string | Sì | - | Indica l'handle Threads (con o senza @) per le azioni profile, user_posts e followers. Le azioni profile e user_posts non accettano URL completi del profilo. L'azione followers restituisce il numero complessivo di follower, non un elenco degli utenti. |
Esempi di codice
#curl -X POST 'https://api.everyinfra.com/api/v1/social' \
-H "Authorization: Bearer $EVERYINFRA_API_KEY" \
-H 'Content-Type: application/json' \
--data-raw '{
"platform": "threads",
"action": "profile",
"params": {
"username": "zuck"
}
}'Definizione OpenAPI (JSON)Gli esempi leggono la chiave dalla variabile d'ambiente EVERYINFRA_API_KEY; il codice copiato non contiene mai la tua chiave.
Esempio di risposta
#{ "id": "req_…", "platform": "threads", "action": "profile", "results": { "user_id": "•••", "username": "zuck", "display_name": "•••", "bio": "Mostly superintelligence and MMA takes", "follower_count": 5744623, "is_verified": true, "is_private": false, "url": "https://www.threads.net/@zuck", "avatar_url": "https://instagram.fbau6-1.fna.fbcdn.net/•••", "platform": "threads" }, "billing": { "charged": …, "charged_usd": …, "balance_after_usd": …, … }, "quota": { … }}
Campi della risposta
#I dati di business si trovano in results. La tabella elenca i campi che un record può contenere; i valori che la piattaforma non mostra non vengono mai inventati.
| Campo | Significato |
|---|---|
user_id | ID univoco dell'utente sulla piattaforma. |
username | Username (@handle). |
display_name | Nome visualizzato; può essere diverso da username. |
bio | Bio del profilo scritta dall'account; può contenere interruzioni di riga ed emoji. |
follower_count | Follower. null significa non reso noto, non 0. |
is_verified | Indica se la piattaforma ha verificato l'account. null significa che non è possibile determinarlo. |
is_private | Mantiene il significato attribuito dalla piattaforma |
url | Link al record sulla piattaforma. |
avatar_url | Link all'immagine dell'avatar. Alcune piattaforme restituiscono URL CDN con dimensioni specifiche, che possono scadere. |
platform | Identificativo della piattaforma di origine, uguale a platform nella richiesta (ad esempio xiaohongshu, tiktok). |
external_url | Mantiene il significato attribuito dalla piattaforma |
FAQ
#Posso passare un link al profilo threads.net o threads.com?
#No. Invia solo l'handle, cioè la parte dopo la @ in un link come threads.com/@zuck: quindi zuck o @zuck. Questa funzionalità non interpreta gli URL completi del profilo di nessuno dei due domini, e nemmeno un nome visualizzato identifica l'account.
Come distinguo gli account verificati da quelli privati?
#is_verified è true per gli account verificati da Threads; null significa che non è stato possibile effettuare il controllo, il che è diverso da false. is_private è true quando l'account mantiene privati i propri post: il profilo viene comunque restituito, ma i post non sono pubblici.
Come leggo i post dell'account?
#Passa lo stesso handle alla funzionalità Threads Posts by user, che, come questa, accetta l'handle e non un link al profilo. Per un singolo post di cui hai già il link, la funzionalità Threads Post details accetta l'URL completo del post, nel formato threads.com/@<handle>/post/<code>.
Errori e addebiti
#- 401
- Chiave mancante o non valida.
- 402
- Saldo insufficiente. Effettua prima una ricarica.
- 422
- Nome o valore del parametro non valido. Correggilo seguendo i suggerimenti dell'errore. Nessun addebito.
- 429
- Raggiunto il limite di richieste al minuto. Attendi il tempo indicato da Retry-After, poi riprova.
- 503
- Impossibile completare. L'importo trattenuto torna sul tuo saldo. Se l'esito è incerto, verificalo prima di riprovare.
- Risposta 200 vuota
- Nessun dato. Nessun addebito.
Riferimenti ufficiali
#Usati solo per verificare oggetti e terminologia. Non implicano alcuna autorizzazione o approvazione di EveryInfra da parte della piattaforma.
- Documentazione ufficiale di Meta: profili di Threads, numero di follower e limiti di accesso ↗
Le fonti ufficiali di Meta definiscono `username`, nome visualizzato, bio e `follower_count`, e indicano che la scoperta dei profili pubblici richiede autorizzazioni specifiche, che l'accesso standard è limitato ad alcuni account ufficiali e che si applicano soglie relative ad account pubblici e follower. Citate qui solo per spiegare la terminologia della piattaforma, non implicano che questa API disponga di tali autorizzazioni o che corrisponda alle funzionalità degli endpoint ufficiali.
Verificato il 2026-09-04