La piattaforma per sviluppatori di X ora applica prezzi all’API per richiesta invece che tramite un livello in abbonamento. La creazione dei post è addebitata per chiamata, e POST /2/tweets è limitato a 100 richieste per utente ogni 15 minuti e 10.000 per app ogni 24 ore. Se stai decidendo se costruire direttamente su questa API, questi due fatti definiscono gran parte della tua architettura.
Quanto costa davvero l’API X?
La pagina ufficiale dei prezzi descrive un modello a crediti, non piani con un nome. Acquisti crediti, imposti un limite di spesa, e ogni chiamata scala dal saldo.
| Operazione | Prezzo indicato |
|---|---|
| Creazione post | 0,015 $ per richiesta |
| Post contenente un URL | 0,200 $ per richiesta |
| Post (summoned) | 0,010 $ per richiesta |
| DM e interazioni utente | 0,015 $ per richiesta |
| Eliminazione interazioni | 0,010 $ per richiesta |
| Lettura: post | 0,005 $ per risorsa |
| Lettura: utenti, DM, following/follower | 0,010 $ per risorsa |
| Lettura: like, mute, blocchi | 0,001 $ per risorsa |
| Letture di dati propri | 0,001 $ per risorsa |
Due dettagli contano più dei prezzi unitari. Un post contenente un URL costa più di 13 volte un post semplice, il che è una voce di spesa rilevante se pubblichi link per lavoro. E i piani a consumo hanno un tetto di 3 milioni di letture di post per ciclo di fatturazione mensile, quindi i prodotti ad alto consumo di letture raggiungono un limite che nessun acquisto di crediti rimuove.
Le risorse vengono deduplicate all’interno di una finestra UTC di 24 ore, quindi richiedere la stessa risorsa due volte in un giorno viene addebitato una sola volta.
Nota: i dati qui riportati sono stati verificati rispetto a docs.x.com/x-api/getting-started/pricing a settembre 2026. Le piattaforme li modificano senza preavviso.
Cosa non siamo riusciti a verificare. I vecchi livelli Free, Basic e Pro con tetti mensili di post sono ampiamente citati in rete. Non siamo riusciti a trovare una pagina ufficiale che li elenchi: le pagine attuali su prezzi e introduzione descrivono un modello a consumo senza livelli con un nome, e l’URL dei livelli restituisce 404. Non stiamo ripetendo numeri di terze parti. Controlla la Developer Console per le tariffe applicate al tuo account.
Cosa può pubblicare l’API X, e cosa non può?
POST /2/tweets accetta text, opzionalmente media.media_ids, reply, poll, geo, reply_settings e alcuni flag come made_with_ai e paid_partnership.
I media non fanno parte di quella chiamata. Li carichi separatamente tramite gli endpoint di upload a blocchi e passi il media_id risultante. Un post accetta fino a 4 foto, 1 GIF animata o 1 video.
I limiti da conoscere prima di impegnarti:
quote_tweet_idè solo Enterprise. La citazione di post non è disponibile sull’endpoint generale.- I tetti video dipendono dall’account che pubblica, non dalla tua app. Gli account standard hanno un limite di 20 minuti e 8 GB; gli account X Premium e verificati di 125 minuti e 16 GB. Il tuo sistema di upload deve gestire entrambi i casi perché il limite appartiene all’utente per conto del quale stai pubblicando.
- I sondaggi sono vincolati. Da 2 a 4 opzioni, durata tra 5 e 10.080 minuti.
- Il riferimento alla creazione non indica un limite di caratteri. Non siamo riusciti a verificarne uno da quella pagina. Vedi il post sul limite di caratteri di X per ciò che il prodotto applica davvero.
Nota: i dati qui riportati sono stati verificati rispetto a docs.x.com/x-api/posts/creation-of-a-post a settembre 2026. Le piattaforme li modificano senza preavviso.
Qual è il modello di autenticazione in termini semplici?
Due modalità, e la pubblicazione funziona solo in una delle due.
Bearer token solo app. Una singola credenziale che rappresenta la tua applicazione. Legge dati pubblici. Non può pubblicare, perché non c’è un utente per conto di cui pubblicare.
OAuth 2.0 Authorization Code con PKCE, contesto utente. L’utente viene inviato alla finestra di autorizzazione di X, torna con un codice, e tu lo scambi con un token di accesso. La pubblicazione richiede lo scope tweet.write, insieme a tweet.read e users.read. Se vuoi continuare a pubblicare dopo la scadenza del token di accesso, devi richiedere offline.access al momento dell’autorizzazione, ed è questo che fa emettere un refresh token.
Quest’ultimo punto è quello che trae in inganno. offline.access è opzionale per ogni singola autorizzazione. Ometterlo significa che ogni utente deve riautorizzare in modo interattivo, il che è fatale per uno scheduler che pubblica alle 3 di notte. La documentazione non indica la durata del token di accesso, quindi trattala come breve e rinnova in modo proattivo.
Quali sono i limiti di frequenza sulla pubblicazione?
| Endpoint | Per utente | Per app |
|---|---|---|
POST /2/tweets | 100 ogni 15 minuti | 10.000 ogni 24 ore |
Ogni risposta contiene x-rate-limit-limit, x-rate-limit-remaining e x-rate-limit-reset (un timestamp Unix). Leggili invece di contare le tue chiamate, perché il tuo contatore e quello di X divergeranno nel momento in cui avviene un nuovo tentativo.
La documentazione è esplicita nel dire che i limiti di frequenza e la fatturazione sono questioni separate. Restare sotto il limite di frequenza non limita la tua spesa, e impostare un limite di spesa non impedisce di ricevere errori 429. Servono entrambi i controlli.
Nota: i dati qui riportati sono stati verificati rispetto a docs.x.com/x-api/fundamentals/rate-limits a settembre 2026. Le piattaforme li modificano senza preavviso.
Cosa ti costerà davvero tre settimane?
Non la chiamata di pubblicazione. Quella è questione di un pomeriggio.
Rinnovo del token. Richiedere offline.access, memorizzare i refresh token in modo cifrato, gestire la rotazione, e prevedere un percorso di riconnessione per gli utenti il cui rinnovo fallisce. È un processo in background con le sue modalità di fallimento, non una funzione.
Upload dei media a blocchi. INIT, APPEND, FINALIZE, poi controllo periodico dello stato di elaborazione prima che il media id sia utilizzabile in un post. I video falliscono nella transcodifica, e falliscono dopo che il tuo upload ha già restituito 200.
Tetti video per account. 20 minuti contro 125 minuti è un ramo di esecuzione basato su di chi è l’account su cui stai pubblicando, e non puoi saperlo dalle sole credenziali della tua app.
Contabilità dei costi. Un prezzo per richiesta significa che qualcuno deve attribuire la spesa ai clienti, altrimenti scoprirai il sovrapprezzo per gli URL da una fattura.
Gestione dei 429 che non sia un’attesa. La finestra per utente è di 15 minuti. Un ciclo di ritentativo ingenuo trasforma un post limitato in un worker bloccato.
La versione breve
- I prezzi sono crediti a consumo. La creazione di un post costa 0,015 $ per richiesta; un post con un URL costa 0,200 $.
- Le letture nel modello a consumo hanno un tetto di 3 milioni di post per ciclo di fatturazione mensile.
POST /2/tweetspermette 100 richieste per utente ogni 15 minuti, 10.000 per app ogni 24 ore.- La pubblicazione richiede il contesto utente OAuth 2.0 PKCE con
tweet.write, piùoffline.accessse vuoi i refresh token. - I media si caricano separatamente: 4 foto, 1 GIF o 1 video. La citazione di post è solo Enterprise.
- I livelli Free/Basic/Pro con nome non sono stati verificabili su una pagina ufficiale a settembre 2026.
Farlo una volta sola invece che una volta per piattaforma
Il lavoro descritto sopra è reale, ed è specifico di X. LinkedIn richiede due app separate con scope diversi. TikTok richiede il superamento di un audit della Content Posting API. Threads usa una sequenza container-poi-pubblica con un ciclo di rinnovo del token di 60 giorni. Niente di tutto questo si trasferisce da una piattaforma all’altra.
BulkPublish espone un’unica API REST su 15 piattaforme: Facebook, Instagram, TikTok, YouTube, X, Bluesky, Threads, Pinterest, LinkedIn, Google Business Profile, Mastodon, Discord, Telegram, Tumblr e Snapchat. Un solo modello di autenticazione, una sola pipeline media, un solo oggetto post, con il rinnovo dei token per piattaforma e il polling asincrono dello stato gestiti dietro le quinte. I documenti per sviluppatori e il riferimento dell’API REST coprono gli endpoint.