POST

Stato di salute dell'API

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

Ultime 24 ore

Ultimi 30 giorni

Elenca i post che un account Threads ha ripubblicato, a partire da username (un handle o un link del profilo). Ogni riga è il post originale, con testo, autore e conteggi, oltre a reposted_by e reposted_at. Ogni chiamata restituisce una pagina con fino a 10 post e limit non ha effetto. Per la pagina successiva, ripassa il next_page_token della risposta come page_token; l'ultima pagina non ne ha.

Invia POST https://api.everyinfra.com/api/v1/social con platform impostato su threads e action impostato su user_reposts. 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 User reposts di EveryInfra (threads/user_reposts).

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 user_reposts, 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:
  - page_token: Token di pagina. Omettilo per la prima pagina, poi ripassa il next_page_token della risposta precedente esattamente come l'hai ricevuto, senza cambiare gli altri parametri.
- Restituisce un elenco di record. Campi principali di ogni record: id, code (Codice del post: la parte del link al p…), url, text, author_username, author_name, author_id, author_avatar_url (URL dell'avatar dell'autore), author_is_verified (Indica se l'account dell'autore ha il b…), author_is_private (Indica se l'account dell'autore è priva…), author_follower_count, like_count; 75 campi in totale, elenco completo su https://api.everyinfra.com/api/v1/social/catalog?platform=threads.
- Esempio di corpo della richiesta:
{
  "platform": "threads",
  "action": "user_reposts",
  "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ìuser_repostsIdentificativo 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.
page_tokenbody.paramsstringNo-Token di pagina. Omettilo per la prima pagina, poi ripassa il next_page_token della risposta precedente esattamente come l'hai ricevuto, senza cambiare gli altri parametri. Ogni pagina contiene fino a 10 post ed è una chiamata; limit non ha effetto. I token durano 24 ore; l'ultima pagina non ha next_page_token.

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": "user_reposts",
  "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": "user_reposts",  "results": [    {      "id": …,      "code": …,      "url": …,      "text": …,      "author_username": …,      "author_name": …,      "author_id": …,      "author_avatar_url": …,      "author_is_verified": …,      "author_is_private": …,      "author_follower_count": …,      "like_count": …,      "comment_count": …,      "repost_count": …,      "quote_count": …,      "share_count": …,      "posted_at": …,      "media_type": …,      "image_count": …,      "video_count": …,      "media_url": …,      "video_duration_seconds": …,      "topic": …,      "topic_id": …,      "topic_name": …,      "topic_emoji": …,      "topic_is_community": …,      "language": …,      "is_edited": …,      "is_reply": …,      "reply_to_username": …,      "root_post_author_username": …,      "reply_level": …,      "is_pinned": …,      "is_pinned_by_author": …,      "is_spoiler": …,      "reply_control": …,      "counts_hidden": …,      "thread_id": …,      "thread_length": …,      "thread_position": …,      "is_federated": …,      "is_paid_partnership": …,      "ai_label": …,      "text_translation": …,      "attached_text": …,      "fediverse_like_count": …,      "fediverse_reply_count": …,      "is_liked_by_author": …,      "is_collapsed": …,      "reply_approval_enabled": …,      "is_ghost_post": …,      "ghost_expires_at": …,      "is_markup": …,      "hashtags": …,      "mentions": …,      "links": …,      "image_urls": …,      "video_urls": …,      "tagged_users": …,      "media": …,      "link_preview": …,      "location": …,      "quoted_post": …,      "reposted_post": …,      "gif": …,      "music": …,      "podcast": …,      "scorecard": …,      "trend": …,      "author_badge": …,      "custom_like": …,      "platform": …,      "in_reply_to": …,      "reposted_by": …,      "reposted_at": …    }  ],  "next_page_token": …,  "pagination": { … },  "count": …,  "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
idID univoco del record sulla piattaforma. È univoco solo all'interno di una piattaforma; gli ID possono ripetersi tra piattaforme diverse.
codeCodice del post: la parte del link al post che segue /post/.
urlLink al record sulla piattaforma.
textTesto del contenuto senza HTML, restituito per intero e mai troncato (su alcune piattaforme i risultati degli elenchi contengono solo un estratto; lo indicano le note sui campi della piattaforma).
author_usernameUsername dell'autore (@handle), di solito utilizzabile negli URL.
author_nameNome visualizzato dell'autore.
author_idID univoco dell'autore sulla piattaforma.
author_avatar_urlURL dell'avatar dell'autore; link firmato con scadenza.
author_is_verifiedIndica se l'account dell'autore ha il badge di verifica.
author_is_privateIndica se l'account dell'autore è privato.
author_follower_countNumero di follower dell'autore. null significa non reso noto.
like_countLike. null significa che la piattaforma o questa funzionalità non li rende noti; non equivale a 0.
comment_countCommenti. null significa non resi noti, non 0.
repost_countRepost (distinti dai post con citazione). null significa non resi noti.
quote_countCitazioni: quante volte altri utenti hanno citato questo post nei propri. null significa che il dato non è divulgato, non che vale 0.
share_countCondivisioni. null significa non rese note, non 0.
posted_atData e ora di pubblicazione in formato ISO 8601, UTC (ad esempio 2026-08-07T12:34:56+00:00). Le stringhe non standard della piattaforma vengono passate così come sono, quindi esegui il parsing in modo difensivo. null significa che la piattaforma non le rende note.
media_typeTipo di post: text (solo testo), image (un'immagine), video (un video) o carousel (più immagini, oppure immagini e video insieme).
image_countNumero di immagini.
video_countNumero di video.
media_urlURL del primo allegato; link firmato con scadenza.
video_duration_secondsDurata del primo video, in secondi; la durata di ciascun video è in duration_seconds di ogni voce di media.
topicNome interno dell'argomento a cui è associato il post, ad es. bakingthreads; il nome visualizzato è in topic_name.
topic_idID dell'argomento a cui è associato il post.
topic_nameNome visualizzato dell'argomento, ad es. Baking Threads.
topic_emojiIcona emoji dell'argomento (community).
topic_is_communityIndica se l'argomento è una community.
languageCodice della lingua del contenuto (ad esempio zh, en) secondo la piattaforma; può essere errato.
is_editedIndica se il post è stato modificato.
is_replyIndica se questo post è una risposta.
reply_to_usernameUsername della persona a cui risponde questo post; assente quando il post non è una risposta.
root_post_author_usernameUsername dell'autore del post in cima a questa conversazione.
reply_levelProfondità della risposta: 1 è una risposta diretta al post principale, 2 è una risposta a una risposta, e così via.
is_pinnedIndica se l'autore ha fissato il post sul proprio profilo.
is_pinned_by_authorSolo risposte: indica se l'autore del post principale l'ha fissata nella sezione delle risposte.
is_spoilerIndica se il post è coperto da un avviso spoiler.
reply_controlChi può rispondere a questo post, ad es. everyone.
counts_hiddenIndica se l'autore ha nascosto il numero di Mi piace e di condivisioni; quando è nascosto, like_count è null.
thread_idID del thread dell'autore, cioè la serie di post pubblicati uno dopo l'altro; i post dello stesso thread condividono questo valore.
thread_lengthNumero di post nel thread dell'autore; 1 quando il post non fa parte di un thread.
thread_positionPosizione di questo post all'interno del thread.
is_federatedIndica se il post è sincronizzato con il fediverso.
is_paid_partnershipIndica se il post è etichettato come partnership pagata. Usalo per riconoscere gli annunci.
ai_labelCome il post è etichettato come generato dall'IA, ad es. SELF_DISCLOSURE_FLOW (etichettato dall'autore); assente quando non c'è alcuna etichetta.
text_translationTraduzione in inglese del testo fornita da Threads; presente solo quando il testo non è in inglese e Threads fornisce una traduzione.
attached_textTesto completo dell'allegato di testo lungo del post (l'allegato di testo di Threads).
fediverse_like_countNumero di Mi piace dal lato del fediverso (Mastodon e altri).
fediverse_reply_countNumero di risposte dal lato del fediverso.
is_liked_by_authorSolo risposte: indica se l'autore del post principale ha messo Mi piace a questa risposta.
is_collapsedSolo risposte: la piattaforma ha compresso questa risposta. Presente solo quando è true.
reply_approval_enabledL'autore ha attivato l'approvazione delle risposte, quindi le risposte devono prima essere approvate. Presente solo quando è true.
is_ghost_postIl post è un ghost post, un post a tempo che scompare automaticamente dopo un po'. Presente solo quando è true.
ghost_expires_atMomento in cui il ghost post scompare.
is_markupIl post è un post Markup, disegnato o annotato sopra il post di qualcun altro. Presente solo quando è true.
hashtagsHashtag presenti nel testo, in ordine di apparizione; assente se non ce ne sono.
mentionsUsername menzionati con @ nel testo.
linksLink presenti nel testo e link allegati al post.
image_urlsArray di link alle immagini nell'ordine di visualizzazione della piattaforma; assente se non ci sono immagini.
video_urlsURL di tutti i video; link firmati con scadenza.
tagged_usersUsername delle persone taggate nelle immagini e nei video.
mediaElenco degli allegati, una voce ciascuno; assente quando non ce ne sono. Ogni voce: type (image o video), url (URL del file, link firmato con scadenza), width e height (pixel), alt_text (testo alternativo, generato da Threads o scritto dall'autore); i video hanno anche thumbnail_url (immagine di copertina), has_audio (se c'è l'audio) e duration_seconds (durata in secondi).
link_previewScheda del link: url, title (titolo della scheda), description (descrizione della scheda), display_url (dominio visualizzato), image_url (immagine della scheda) e favicon_url (favicon del sito).
locationLuogo allegato al post: id (ID del luogo), name (nome del luogo) e url (la pagina di questo luogo su Threads).
quoted_postIl post originale citato da questo post: id, code, url, text, author_username e posted_at.
reposted_postIl post originale ripubblicato da questo post, con la stessa struttura di quoted_post.
gifGIF nel post: url, webp_url (URL in formato WebP), width e height (entrambi in pixel).
musicMusica allegata al post: song_id, title (titolo del brano), artist, cover_url (immagine di copertina) e start_ms (millisecondo del brano da cui parte la riproduzione); il testo del brano non è incluso.
podcastNei post, la scheda dell'episodio di podcast allegata al post: episode_name, episode_url, podcast_name, platform (piattaforma del podcast, ad es. SPOTIFY, APPLE) e image_url. In profile (dati dell'account), il podcast allegato alla pagina del profilo: name, url, platform e image_url, e per alcuni anche links (link di ascolto per piattaforma, ciascuno con platform e url).
scorecardTabellino sportivo allegato al post: status (upcoming: non iniziata, live: in corso, past: terminata), starts_at (ora di inizio), clock (cronometro di gara), period (quale periodo, ad es. Q4), home_team e away_team (ciascuna con name, short_name, score e logo_url) e url (link in fondo alla scheda).
trendLa tendenza in cui compare questo post: keyword (termine di ricerca della tendenza), id e summary (riepilogo scritto dalla piattaforma; presente solo in alcuni casi).
author_badgeIl badge dell'autore in questa community: type (tipo di badge, ad es. MEMBER) e label (etichetta d'identità scelta dall'autore nella community, ad es. il nome di una squadra).
custom_likeStile personalizzato del Mi piace che sostituisce il cuore predefinito su questo post: type (EMOJI o STICKER), emoji e sticker_url (URL della GIF dello sticker).
platformIdentificativo della piattaforma di origine, uguale a platform nella richiesta (ad esempio xiaohongshu, tiktok).
in_reply_toIl post a cui risponde questa risposta: id, code, url, text, author_username, author_name, like_count, comment_count e posted_at.
reposted_byL'account (username) che ha ripubblicato questo post; la riga stessa è il post originale ripubblicato.
reposted_atQuando il post è stato ripubblicato.

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