API di Threads
Cerca post e profili su Threads per ottenere testo pubblico, dettagli sugli autori, numero di follower e metriche delle discussioni.
La ricerca di profili per parola chiave viene eseguita come attività asincrona. Uno stato della risposta non garantisce un elenco di account.
Invia POST https://api.everyinfra.com/api/v1/social con platform impostato su threads e action impostato sul nome di una funzionalità dell'elenco qui sotto, ad esempio search.
- 7 funzionalità
- $0.56 per 1.000 richieste
- Nessun addebito per chiamate non riuscite o risultati vuoti
- Operatività nelle ultime 24 ore 100%
Disponibilità della piattaforma
- Operatività nelle ultime 24 ore
- 100%
Ultimi 30 giorni
Funzionalità disponibili
Ogni azione di Threads: cosa fa, quanto costa e come ha funzionato nelle ultime 24 ore. Apri un'azione per vederne parametri, campi della risposta ed esempi di codice.
| Funzionalità | Cosa fa | Per 1.000Righe vuote: $0.56 | Stato nelle ultime 24 ore · Tutto regolare |
|---|---|---|---|
Ricercasearch | Estrai i post Threads che menzionano una parola chiave, con testo, autore, numero di like e commenti e ora di pubblicazione di ogni post. | Buono · operatività 100% | |
Profiliprofile | Verifica un account Threads dal suo handle. | Normale | |
Post dell'utenteuser_posts | Elenca i post di un account Threads con conteggi separati di like, commenti, repost, citazioni, condivisioni e visualizzazioni, più hashtag e menzioni. | Normale | |
Dettagli del postpost_detail | Leggi un singolo post Threads dal suo URL completo. | Normale | |
Commenticomments | Raccogli le risposte sotto un post Threads. | Normale | |
Scoperta di profilidiscover_profiles | Scopri profili di creator Threads legati a una parola chiave. | Normale | |
Followerfollowers | Ottieni il numero di follower, account seguiti, post e like di un account Threads, con un flag precision che indica i valori arrotondati. | Normale |
Cosa accetta ogni azione di API di Threads?
Ogni risposta qui sotto associa un'azione richiamabile ai suoi input reali. Il significato dei parametri e i valori ammessi dipendono dall'azione: un nome familiare non ha lo stesso significato su tutte le piattaforme.
Le fonti ufficiali sono linkate solo per chiarire il termine della piattaforma accanto a cui compaiono. Non implicano autorizzazione o approvazione da parte della piattaforma e le funzionalità del sito ufficiale non fanno parte dell'API di EveryInfra, a meno che questa pagina non le elenchi.
| Azione | Obbligatori | Facoltativi | Consegna | Limite | Per 1.000Righe vuote: $0.56 | Campi della risposta |
|---|---|---|---|---|---|---|
searchRicerca Estrai i post Threads che menzionano una parola chiave, con testo, autore, numero di like e commenti e ora di pubblicazione di ogni post. Non cerca profili per nome e non garantisce né la cronologia completa né una copertura in tempo reale. | keyword | — | Consegna Sync | Valori del catalogo: defaultLimit=15, maxLimit=50. Per alcune azioni limit può controllare le pagine o l'espansione per elemento padre, quindi non è sempre un numero finale di righe. | id · url · text · author_name · author_username · author_id · like_count · comment_count · posted_at · author_is_verified · media · hashtags · mentions · links · platform | |
profileProfili 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. | username | — | Consegna Sync | — | user_id · username · display_name · bio · follower_count · is_verified · is_private · url · avatar_url · platform · external_url | |
user_postsPost dell'utente Elenca i post di un account Threads con conteggi separati di like, commenti, repost, citazioni, condivisioni e visualizzazioni, più hashtag e menzioni. Passa l'handle, non l'URL del profilo. Un batch potrebbe non coprire l'intera cronologia ed esclude le risposte dell'account. | username | — | Consegna Sync | Valori del catalogo: defaultLimit=10, maxLimit=50. Per alcune azioni limit può controllare le pagine o l'espansione per elemento padre, quindi non è sempre un numero finale di righe. | id · code · url · text · author_username · author_name · author_is_verified · like_count · comment_count · repost_count · quote_count · share_count · view_count · posted_at · platform · media_type · hashtags · mentions | |
post_detailDettagli del post Leggi un singolo post Threads dal suo URL completo. Ottieni testo, autore, conteggi di engagement, hashtag, media e un flag di partnership a pagamento. Restituisce solo il post, non l'intero thread che lo circonda. | url | — | Consegna Sync | — | id · code · url · text · author_username · author_name · author_is_verified · like_count · comment_count · repost_count · quote_count · share_count · view_count · posted_at · is_paid_partnership · author_id · author_avatar_url · image_count · image_urls · platform · media_url · hashtags | |
commentsCommenti Raccogli le risposte sotto un post Threads. Ogni risposta ha testo, autore, verifica, numero di like e il contenuto a cui risponde. Passa l'URL completo del post. Le risposte annidate potrebbero non essere restituite tutte. | url | — | Consegna Sync | — | id · url · text · author_username · author_name · author_is_verified · like_count · comment_count · reply_to · posted_at · platform | |
discover_profilesScoperta di profili Scopri profili di creator Threads legati a una parola chiave. Ottieni bio, numero di follower, verifica, link esterni ed eventuali email o numeri di telefono indicati. Viene eseguito come job asincrono, quindi leggi il risultato finale, non la prima risposta di stato. Una corrispondenza non prova né l'identità né l'idoneità. | keyword | since, until | Consegna Async | Valori del catalogo: defaultLimit=10, maxLimit=50. Per alcune azioni limit può controllare le pagine o l'espansione per elemento padre, quindi non è sempre un numero finale di righe. | username · display_name · bio · follower_count · is_verified · url · avatar_url · platform · emails · phones · external_links | |
followersFollower Ottieni il numero di follower, account seguiti, post e like di un account Threads, con un flag | username | channel | Consegna Sync | — | id · username · url · follower_count · following_count · post_count · like_count · connection_count · precision · platform |
Cosa significano i parametri search di API di Threads?
Estrai i post Threads che menzionano una parola chiave, con testo, autore, numero di like e commenti e ora di pubblicazione di ogni post. Non cerca profili per nome e non garantisce né la cronologia completa né una copertura in tempo reale.
Riferimento API completo: parametri, esempi di codice, esempio di risposta e statokeywordObbligatorio- Indica la query di ricerca per trovare post pubblici con search o profili di creator con discover_profiles. L'azione discover_profiles è asincrona: la risposta iniziale con lo stato del task non va interpretata come l'elenco finale dei creator.Documentazione ufficiale di Meta: ricerca per parola chiave e metriche di engagement su Threads — Le fonti ufficiali di Meta definiscono la scoperta dei post pubblici tramite parole chiave di ricerca e distinguono risposte, repost, citazioni e condivisioni esterne alla piattaforma. Questo definisce gli oggetti e la terminologia di Threads, ma non indica che questo endpoint API supporti tutte le funzionalità ufficiali di filtro, scrittura o analisi. · Verificato
Cosa significano i parametri profile di API di Threads?
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.
Riferimento API completo: parametri, esempi di codice, esempio di risposta e statousernameObbligatorio- 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.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
Cosa significano i parametri user_posts di API di Threads?
Elenca i post di un account Threads con conteggi separati di like, commenti, repost, citazioni, condivisioni e visualizzazioni, più hashtag e menzioni. Passa l'handle, non l'URL del profilo. Un batch potrebbe non coprire l'intera cronologia ed esclude le risposte dell'account.
Riferimento API completo: parametri, esempi di codice, esempio di risposta e statousernameObbligatorio- 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.Documentazione ufficiale di Meta: trovare i post di Threads tramite username — Le fonti ufficiali di Meta distinguono gli endpoint del profilo utente da quelli dei post dell'utente, spiegano come `profile_posts` individui i post tramite lo username esatto ed elencano campi distinti come `id`, `shortcode` e `permalink`. Non bisogna presumere che questo endpoint API supporti `access_token`, la paginazione e i parametri di data ufficiali. · Verificato
Cosa significano i parametri post_detail di API di Threads?
Leggi un singolo post Threads dal suo URL completo. Ottieni testo, autore, conteggi di engagement, hashtag, media e un flag di partnership a pagamento. Restituisce solo il post, non l'intero thread che lo circonda.
Riferimento API completo: parametri, esempi di codice, esempio di risposta e statourlObbligatorio- Indica l'URL completo del post (ad es. https://www.threads.com/@username/post/POST_CODE) per le azioni post_detail e comments. L'azione comments non garantisce l'estrazione di tutti i thread di commenti annidati.Documentazione ufficiale di Meta: repost, citazioni e condivisioni esterne su Threads — Le fonti ufficiali di Meta distinguono repost, citazioni e condivisioni, e definiscono le condivisioni come condivisioni esterne alla piattaforma. Questo chiarisce le metriche di engagement del post originale, ma non garantisce che ogni metrica sia presente in ogni risposta né che le azioni di pubblicazione siano supportate. · Verificato
Cosa significano i parametri comments di API di Threads?
Raccogli le risposte sotto un post Threads. Ogni risposta ha testo, autore, verifica, numero di like e il contenuto a cui risponde. Passa l'URL completo del post. Le risposte annidate potrebbero non essere restituite tutte.
Riferimento API completo: parametri, esempi di codice, esempio di risposta e statourlObbligatorio- Indica l'URL completo del post (ad es. https://www.threads.com/@username/post/POST_CODE) per le azioni post_detail e comments. L'azione comments non garantisce l'estrazione di tutti i thread di commenti annidati.Documentazione ufficiale di Meta: differenza tra risposte di primo livello e alberi di conversazione completi — Le fonti ufficiali di Meta distinguono le risposte di primo livello dalle conversazioni complete a profondità illimitata, e definiscono `replied_to` come ID del contenuto genitore diretto. In questa API, `reply_to` indica lo username a cui si risponde, non il campo ufficiale `replied_to`, e non garantisce un albero completo dei commenti; anche i limiti ufficiali di visibilità e diritto d'autore possono causare campi mancanti. · VerificatoDocumentazione ufficiale di Meta: autorizzazioni necessarie per leggere le risposte su Threads — La documentazione ufficiale di Meta sulla gestione delle risposte riguarda i post Threads dell'account stesso e richiede un token di accesso adeguato e autorizzazioni di lettura. Citarla non garantisce l'accesso a post arbitrari di terze parti né dimostra che questo prodotto abbia ricevuto un'autorizzazione dalla piattaforma. · Verificato
Cosa significano i parametri discover_profiles di API di Threads?
Scopri profili di creator Threads legati a una parola chiave. Ottieni bio, numero di follower, verifica, link esterni ed eventuali email o numeri di telefono indicati. Viene eseguito come job asincrono, quindi leggi il risultato finale, non la prima risposta di stato. Una corrispondenza non prova né l'identità né l'idoneità.
Riferimento API completo: parametri, esempi di codice, esempio di risposta e statokeywordObbligatorio- Indica la query di ricerca per trovare post pubblici con search o profili di creator con discover_profiles. L'azione discover_profiles è asincrona: la risposta iniziale con lo stato del task non va interpretata come l'elenco finale dei creator.Documentazione ufficiale di Meta: la scoperta dei profili pubblici non è una ricerca utenti per parola chiave esatta — Il `profile_lookup` ufficiale di Meta richiede uno username esatto ed è soggetto ad autorizzazioni, livelli di accesso e requisiti dell'account. La scoperta di profili candidati per parola chiave in questa API non va considerata equivalente alle ricerche esatte ufficiali, e la documentazione ufficiale non garantisce la copertura di tutti gli utenti. · Verificato
sinceFacoltativo- Parametro condiviso per il limite inferiore della data in discover_profiles. Non è garantito che filtri i profili trovati e non filtra per data di creazione dell'account.
untilFacoltativo- Parametro condiviso per il limite superiore della data in discover_profiles. Non garantisce la copertura completa dei creator di quel periodo, e search non ha un filtro per data.
Cosa significano i parametri followers di API di Threads?
Ottieni il numero di follower, account seguiti, post e like di un account Threads, con un flag precision che indica i valori arrotondati. Restituisce solo i conteggi, senza l'elenco di chi segue l'account e senza andamento nel tempo.
usernameObbligatorio- 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.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
channelFacoltativo- Fallback di compatibilità per indicare l'handle di un account nell'azione followers. Ha priorità inferiore rispetto a username e restituisce il numero di follower, non elenchi di membri di canali o gruppi.
Come usare l'API di Threads
- 01Scegli un'azione della piattaforma dal catalogo pubblico.
- 02Invia piattaforma, azione e parametri obbligatori a POST /api/v1/social.
- 03Leggi il risultato dalla risposta. Per un'azione asincrona, interroga periodicamente il job ID restituito.
- 04Salva i campi della risposta che servono alla tua applicazione.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"threads","action":"search","params":{"keyword":"<keyword>"}}'
Guide su API di Threads
Esempi pratici e metodi basati su queste azioni. Verifica prima azioni, parametri e campi attuali in questa pagina: esempi e limiti di un articolo non sostituiscono il catalogo aggiornato.
Schema per il monitoraggio della reputazione su più piattaforme: definisci l'ambito prima di valutare i peggioramenti
Progetta un flusso di monitoraggio della reputazione tracciabile partendo da elenchi di target, identità dei commenti e cursori incrementali; usa campioni offline per mostrare la deduplicazione e le lacune di acquisizione, mantenendo la revisione manuale.
Leggi l'articoloPrimi passi con l'API unificata per i dati: dal catalogo delle funzionalità al primo risultato utilizzabile
Accedi ai dati di più piattaforme con platform, action e params: leggi il catalogo delle funzionalità, completa richieste minime, gestisci task asincroni, risultati parziali e addebiti, e crea record di dati tracciabili.
Leggi l'articoloDomande sull'API di Threads
Cosa posso ottenere con l'API di Threads?
Imposta platform su threads. Il catalogo attuale elenca ricerca, profili, post dell'utente, dettagli del post, commenti e more. Questi nomi di azione identificano oggetti o viste diversi di Threads; non sono modalità di ricerca intercambiabili.
Threads ha un'API ufficiale?
Sì. La Threads API di Meta è pensata per pubblicare e gestire i post Threads dell'utente stesso. Per cercare post pubblici per parola chiave e leggere profili pubblici servono i permessi threads_keyword_search e threads_profile_discovery, che richiedono l'App Review di Meta e prevedono limiti per utente di 2.200 ricerche e 1.000 consultazioni di profili ogni 24 ore.
Fonti ufficiali: «Meta: Threads keyword search» · Meta: Threads API overview · Verificato
Mi serve un account sviluppatore o una chiave API di Threads?
No. Le richieste passano da EveryInfra con una chiave API EveryInfra: registrati, crea una chiave nella console e inviala come Authorization: Bearer <API_KEY>. Non devi registrare un'app nel portale per sviluppatori di Threads, richiedere l'accesso alle API di Threads né accedere con un account Threads; le azioni restituiscono solo dati pubblici di Threads.
Quanto costa l'API di Threads per 1.000 richieste?
$0.56 per 1.000 richieste, a seconda dell'azione; il prezzo di ogni azione è indicato nella tabella di questa pagina e nel catalogo pubblico. Non c'è alcun abbonamento: ricarichi un saldo in USD e paghi per chiamata, e le chiamate non riuscite e i risultati vuoti non vengono addebitati.
Quale input avvia la richiesta search di Threads?
Indica la query di ricerca per trovare post pubblici con search o profili di creator con discover_profiles. L'azione discover_profiles è asincrona: la risposta iniziale con lo stato del task non va interpretata come l'elenco finale dei creator. Invialo come keyword all'interno di params.
Quali campi può restituire search di Threads?
Il suo schema dichiarato include text, author_name, author_username e author_id. Un campo dichiarato può comunque mancare in un singolo record, e ogni altra azione ha il proprio elenco di campi.
Tutte le azioni di Threads rispondono subito?
Le azioni indicate come asincrone restituiscono un job ID da interrogare periodicamente. Tutte le altre azioni possono essere eseguite anche in modo asincrono: aggiungi "mode": "async" al corpo della richiesta per ricevere subito un job ID, utile per task lenti o limiti elevati. Il catalogo attuale contiene consegna sync e consegna async.