API Threads Post in una località
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
Elenca i post di Threads taggati con un luogo, a partire da location_id, il valore location.id nei post restituiti da altre azioni. name è facoltativo e sort è top (default) o recent. Ogni riga è un post e ogni riga riporta location_info (id, name) per il luogo richiesto. 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 location_posts. 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 Post in una località di EveryInfra (threads/location_posts).
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 location_posts, e inserisci i parametri in params.
- Parametri obbligatori:
- location_id: ID della località per location_posts: l'id dentro location di un post restituito da un'altra azione.
- Parametri facoltativi:
- name: Nome della località per location_posts. Facoltativo.
- 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.
- sort: Ordine per topic_posts, location_posts e trend_posts: top per i più popolari (default) o recent per i più recenti. (valori consentiti: recent / top)
- 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; 76 campi in totale, elenco completo su https://api.everyinfra.com/api/v1/social/catalog?platform=threads.
- Esempio di corpo della richiesta:
{
"platform": "threads",
"action": "location_posts",
"params": {
"location_id": "1095776834684111"
}
}
- 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ì | location_posts | Identificativo della funzionalità, valore fisso. |
location_id | body.params | string | Sì | - | ID della località per location_posts: l'id dentro location di un post restituito da un'altra azione. |
name | body.params | string | No | - | Nome della località per location_posts. Facoltativo. |
page_token | body.params | string | No | - | 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. |
sort | body.params | string (enum) | No | - | Ordine per topic_posts, location_posts e trend_posts: top per i più popolari (default) o recent per i più recenti.Valori consentitirecenttop |
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": "location_posts",
"params": {
"location_id": "1095776834684111"
}
}'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": "location_posts", "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": …, "location_info": … } ], "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.
| Campo | Significato |
|---|---|
id | ID univoco del record sulla piattaforma. È univoco solo all'interno di una piattaforma; gli ID possono ripetersi tra piattaforme diverse. |
code | Codice del post: la parte del link al post che segue /post/. |
url | Link al record sulla piattaforma. |
text | Testo 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_username | Username dell'autore (@handle), di solito utilizzabile negli URL. |
author_name | Nome visualizzato dell'autore. |
author_id | ID univoco dell'autore sulla piattaforma. |
author_avatar_url | URL dell'avatar dell'autore; link firmato con scadenza. |
author_is_verified | Indica se l'account dell'autore ha il badge di verifica. |
author_is_private | Indica se l'account dell'autore è privato. |
author_follower_count | Numero di follower dell'autore. null significa non reso noto. |
like_count | Like. null significa che la piattaforma o questa funzionalità non li rende noti; non equivale a 0. |
comment_count | Commenti. null significa non resi noti, non 0. |
repost_count | Repost (distinti dai post con citazione). null significa non resi noti. |
quote_count | Citazioni: quante volte altri utenti hanno citato questo post nei propri. null significa che il dato non è divulgato, non che vale 0. |
share_count | Condivisioni. null significa non rese note, non 0. |
posted_at | Data 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_type | Tipo di post: text (solo testo), image (un'immagine), video (un video) o carousel (più immagini, oppure immagini e video insieme). |
image_count | Numero di immagini. |
video_count | Numero di video. |
media_url | URL del primo allegato; link firmato con scadenza. |
video_duration_seconds | Durata del primo video, in secondi; la durata di ciascun video è in duration_seconds di ogni voce di media. |
topic | Nome interno dell'argomento a cui è associato il post, ad es. bakingthreads; il nome visualizzato è in topic_name. |
topic_id | ID dell'argomento a cui è associato il post. |
topic_name | Nome visualizzato dell'argomento, ad es. Baking Threads. |
topic_emoji | Icona emoji dell'argomento (community). |
topic_is_community | Indica se l'argomento è una community. |
language | Codice della lingua del contenuto (ad esempio zh, en) secondo la piattaforma; può essere errato. |
is_edited | Indica se il post è stato modificato. |
is_reply | Indica se questo post è una risposta. |
reply_to_username | Username della persona a cui risponde questo post; assente quando il post non è una risposta. |
root_post_author_username | Username dell'autore del post in cima a questa conversazione. |
reply_level | Profondità della risposta: 1 è una risposta diretta al post principale, 2 è una risposta a una risposta, e così via. |
is_pinned | Indica se l'autore ha fissato il post sul proprio profilo. |
is_pinned_by_author | Solo risposte: indica se l'autore del post principale l'ha fissata nella sezione delle risposte. |
is_spoiler | Indica se il post è coperto da un avviso spoiler. |
reply_control | Chi può rispondere a questo post, ad es. everyone. |
counts_hidden | Indica se l'autore ha nascosto il numero di Mi piace e di condivisioni; quando è nascosto, like_count è null. |
thread_id | ID del thread dell'autore, cioè la serie di post pubblicati uno dopo l'altro; i post dello stesso thread condividono questo valore. |
thread_length | Numero di post nel thread dell'autore; 1 quando il post non fa parte di un thread. |
thread_position | Posizione di questo post all'interno del thread. |
is_federated | Indica se il post è sincronizzato con il fediverso. |
is_paid_partnership | Indica se il post è etichettato come partnership pagata. Usalo per riconoscere gli annunci. |
ai_label | Come il post è etichettato come generato dall'IA, ad es. SELF_DISCLOSURE_FLOW (etichettato dall'autore); assente quando non c'è alcuna etichetta. |
text_translation | Traduzione in inglese del testo fornita da Threads; presente solo quando il testo non è in inglese e Threads fornisce una traduzione. |
attached_text | Testo completo dell'allegato di testo lungo del post (l'allegato di testo di Threads). |
fediverse_like_count | Numero di Mi piace dal lato del fediverso (Mastodon e altri). |
fediverse_reply_count | Numero di risposte dal lato del fediverso. |
is_liked_by_author | Solo risposte: indica se l'autore del post principale ha messo Mi piace a questa risposta. |
is_collapsed | Solo risposte: la piattaforma ha compresso questa risposta. Presente solo quando è true. |
reply_approval_enabled | L'autore ha attivato l'approvazione delle risposte, quindi le risposte devono prima essere approvate. Presente solo quando è true. |
is_ghost_post | Il post è un ghost post, un post a tempo che scompare automaticamente dopo un po'. Presente solo quando è true. |
ghost_expires_at | Momento in cui il ghost post scompare. |
is_markup | Il post è un post Markup, disegnato o annotato sopra il post di qualcun altro. Presente solo quando è true. |
hashtags | Hashtag presenti nel testo, in ordine di apparizione; assente se non ce ne sono. |
mentions | Username menzionati con @ nel testo. |
links | Link presenti nel testo e link allegati al post. |
image_urls | Array di link alle immagini nell'ordine di visualizzazione della piattaforma; assente se non ci sono immagini. |
video_urls | URL di tutti i video; link firmati con scadenza. |
tagged_users | Username delle persone taggate nelle immagini e nei video. |
media | Elenco 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_preview | Scheda 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). |
location | Luogo allegato al post: id (ID del luogo), name (nome del luogo) e url (la pagina di questo luogo su Threads). |
quoted_post | Il post originale citato da questo post: id, code, url, text, author_username e posted_at. |
reposted_post | Il post originale ripubblicato da questo post, con la stessa struttura di quoted_post. |
gif | GIF nel post: url, webp_url (URL in formato WebP), width e height (entrambi in pixel). |
music | Musica 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. |
podcast | Nei 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). |
scorecard | Tabellino 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). |
trend | La 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_badge | Il 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_like | Stile 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). |
platform | Identificativo della piattaforma di origine, uguale a platform nella richiesta (ad esempio xiaohongshu, tiktok). |
in_reply_to | Il post a cui risponde questa risposta: id, code, url, text, author_username, author_name, like_count, comment_count e posted_at. |
reposted_by | L'account (username) che ha ripubblicato questo post; la riga stessa è il post originale ripubblicato. |
reposted_at | Quando il post è stato ripubblicato. |
location_info | location_posts: il luogo richiesto, uguale in ogni riga: id e name. |
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.