API Threads Statistiche di engagement

Temporaneamente non disponibile

Stiamo ripristinando questa funzionalità. Nel frattempo le chiamate di solito non vanno a buon fine o non restituiscono risultati; le chiamate non riuscite e i risultati vuoti non vengono addebitati.

POST

Stato di salute dell'API

Operatività nelle ultime 24 ore
Temporaneamente non disponibile
  • Buono / normale
  • Disponibile
  • Limitato
  • Quasi del tutto inattivo
Temporaneamente non disponibile

Ultime 24 ore

Ultimi 30 giorni

Calcola l'engagement di un account Threads dai suoi post più recenti, a partire da username. posts imposta quanti usarne, da 3 a 50 (default 20). Contano solo i post scritti dall'account: risposte e repost sono esclusi, i post fissati sono inclusi. Ottieni media e mediana di like e interazioni, media di risposte, repost, citazioni e condivisioni, engagement_rate in percentuale, posts_per_week, post per ora UTC e giorno della settimana, il mix dei tipi di post e i 3 post migliori. Restituisce un solo oggetto, non un elenco.

Invia POST https://api.everyinfra.com/api/v1/social con platform impostato su threads e action impostato su engagement. 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.

Prompt per l'AI

#
Aiutami a scrivere uno script di raccolta dei dati con l'endpoint Threads Statistiche di engagement di EveryInfra (threads/engagement).

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 engagement, e inserisci i parametri in params.
- Parametri obbligatori:
  - username: Indica l'handle Threads (con o senza @) per profile, user_posts, followers, user_replies, user_media, user_reposts, followers_list, following_list ed engagement.
- Parametri facoltativi:
  - posts: Quanti post recenti dell'account usa engagement: un intero da 3 a 50, default 20.
- Restituisce un oggetto. Campi principali: username, display_name, url, follower_count, is_verified, sample_size (engagement: quanti post sono stati incl…), period_start (engagement: data di pubblicazione (UTC)…), period_end (engagement: data di pubblicazione (UTC)…), posts_per_week (engagement: numero medio di post a sett…), avg_like_count (engagement: media dei Mi piace per post), avg_comment_count (engagement: media delle risposte per po…), avg_repost_count (engagement: media dei repost per post); 23 campi in totale, elenco completo su https://api.everyinfra.com/api/v1/social/catalog?platform=threads.
- Esempio di corpo della richiesta:
{
  "platform": "threads",
  "action": "engagement",
  "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

#
NomePosizioneTipoObbligatorioPredefinitoDescrizione
AuthorizationheaderstringSì-Bearer seguito dalla tua chiave API. Creala nella console; non inserirla mai in un URL o in un repository di codice.
platformbodystringSìthreadsIdentificativo della piattaforma, valore fisso.
actionbodystringSìengagementIdentificativo della funzionalità, valore fisso.
usernamebody.paramsstringSì-Indica l'handle Threads (con o senza @) per profile, user_posts, followers, user_replies, user_media, user_reposts, followers_list, following_list ed engagement. Le azioni profile e user_posts non accettano URL completi del profilo; user_replies, user_media, user_reposts, followers_list, following_list ed engagement accettano anche un link del profilo, ad esempio https://www.threads.com/@mosseri. L'azione followers restituisce il numero complessivo di follower; per gli account stessi usa followers_list e following_list.
postsbody.paramsintegerNo-Quanti post recenti dell'account usa engagement: un intero da 3 a 50, default 20.

Esempi di codice

#
bash
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": "engagement",
  "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

#
Non è ancora disponibile una risposta di esempio per questi parametri. Questa anteprima mostra la struttura e i campi della risposta secondo la definizione dell'API, con … come segnaposto; non è il risultato di una chiamata reale.
json
{  "id": "req_…",  "platform": "threads",  "action": "engagement",  "results": {    "username": …,    "display_name": …,    "url": …,    "follower_count": …,    "is_verified": …,    "sample_size": …,    "period_start": …,    "period_end": …,    "posts_per_week": …,    "avg_like_count": …,    "avg_comment_count": …,    "avg_repost_count": …,    "avg_quote_count": …,    "avg_share_count": …,    "median_like_count": …,    "avg_interactions": …,    "median_interactions": …,    "engagement_rate": …,    "platform": …,    "posts_by_hour_utc": …,    "top_hours_utc": …,    "posts_by_weekday_utc": …,    "media_mix": …,    "top_posts": …  },  "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.

CampoSignificato
usernameUsername (@handle).
display_nameNome visualizzato; può essere diverso da username.
urlLink al record sulla piattaforma.
follower_countFollower. null significa non reso noto, non 0.
is_verifiedIndica se la piattaforma ha verificato l'account. null significa che non è possibile determinarlo.
sample_sizeengagement: quanti post sono stati inclusi nel calcolo. Contano solo i post scritti dall'account: risposte e repost sono esclusi, i post fissati sono inclusi.
period_startengagement: data di pubblicazione (UTC) del post meno recente incluso nel calcolo.
period_endengagement: data di pubblicazione (UTC) del post più recente incluso nel calcolo.
posts_per_weekengagement: numero medio di post a settimana in questo periodo.
avg_like_countengagement: media dei Mi piace per post.
avg_comment_countengagement: media delle risposte per post.
avg_repost_countengagement: media dei repost per post.
avg_quote_countengagement: media delle citazioni per post.
avg_share_countengagement: media delle condivisioni per post.
median_like_countengagement: mediana dei Mi piace per post.
avg_interactionsengagement: media delle interazioni per post; le interazioni sono la somma di Mi piace, risposte, repost, citazioni e condivisioni.
median_interactionsengagement: mediana delle interazioni per post.
engagement_rateengagement: tasso di engagement in percentuale: avg_interactions ÷ follower_count × 100. 0.17 significa 0.17%.
platformIdentificativo della piattaforma di origine, uguale a platform nella richiesta (ad esempio xiaohongshu, tiktok).
posts_by_hour_utcengagement: post per ora UTC, 24 numeri; il primo corrisponde all'ora 0.
top_hours_utcengagement: le ore (UTC, da 0 a 23) con più post, in ordine decrescente.
posts_by_weekday_utcengagement: post per giorno della settimana (UTC), 7 numeri, a partire dalla domenica.
media_mixengagement: quanti post di ciascun tipo: text (solo testo), image (una sola immagine), video e carousel (più immagini, o immagini e video insieme).
top_postsengagement: i post con più interazioni (fino a 3), ciascuno con url, text, posted_at, interactions, like_count, comment_count, repost_count, quote_count e share_count.

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.

Errori

Google Analytics: serve il consenso Privacy