Cos'è l'API di SNSSupporter?
SNSSupporter è un pannello SMM dove puoi acquistare follower, like, visualizzazioni e commenti per Instagram, YouTube, TikTok, Facebook, Telegram, Threads e X da un saldo prepagato in USD, e ogni ordine parte automaticamente. L'API dà al tuo pannello, bot o script lo stesso accesso ai 148 servizi che ha il modulo d'ordine del sito web.
Segue il formato standard dell'API v2 dei pannelli SMM, quindi il software già costruito per quel formato si connette cambiando solo l'URL e la chiave. Ogni chiamata è un HTTP POST a https://snssupporter.site/api/v2 con due campi in ogni richiesta: key e action.
Gli ordini effettuati tramite l'API vengono addebitati allo stesso saldo degli ordini sul sito web e appaiono nella stessa pagina Ordini. Il riferimento completo dei parametri è nella pagina Documentazione API.
Come si ottiene una chiave API?
Accedi con il tuo token di accesso, apri la pagina Sviluppatore del tuo account e crea una chiave API. La chiave viene mostrata una volta sola, quindi copiala nella configurazione del tuo server o in un gestore di password subito.
Mantieni la chiave solo sul tuo server. Le chiamate da un browser o un'app mobile la esporrebbero, quindi instrada gli ordini dei clienti attraverso il tuo back end e chiama l'API da lì.
Una buona integrazione controlla tre cose prima di chiamare add: il formato del link corrisponde al servizio (username, link del post, link del video o link del canale), la quantità è compresa tra il minimo e il massimo di services, e il saldo copre l'addebito. Rifiutare un ordine errato dal tuo lato è più veloce per il tuo cliente che aspettare un errore.
Se una chiave viene compromessa, creane una nuova nella pagina Sviluppatore e sostituiscila nella tua configurazione. La nuova chiave prende il controllo di tutto l'accesso API per l'account. Quando una chiamata fallisce, la risposta contiene un campo error con un breve messaggio, ad esempio una chiave non valida, un ID servizio sconosciuto o un saldo troppo basso per l'addebito; registralo con la richiesta in modo da poter risolvere la causa.
- Endpoint: https://snssupporter.site/api/v2
- Metodo: POST
- Corpo: campi del modulo (key, action e i campi di quell'azione)
- Risposta: JSON
- Valuta: USD, prezzi aggiornati al 2026-11-06
Quali azioni supporta l'API?
L'API ha cinque azioni. Ogni azione viene inviata come campo action insieme alla tua key, più i campi elencati nella tabella.
Inizia ogni integrazione con services per caricare il catalogo, quindi usa add per effettuare ordini, status per tracciarli, balance per monitorare i fondi e refill sugli ordini completati idonei.
| Azione | Campi aggiuntivi | Cosa restituisce |
|---|---|---|
| services | Nessuno | L'elenco dei servizi con ID, nome, categoria, tariffa, min, max e refill |
| add | service, link, quantity (o comments) | Il nuovo ID dell'ordine |
| status | order | Charge, start count, status, remains e currency |
| balance | Nessuno | Saldo corrente e valuta |
| refill | order | Un ID di richiesta refill per un ordine completato idoneo |
Cosa restituisce l'azione services?
L'azione services restituisce una voce per ogni servizio. Memorizza l'ID del servizio, la tariffa, min e max nel tuo database e aggiornali quotidianamente, in modo che il tuo panel mostri sempre i limiti attuali.
La tariffa è il prezzo in USD per 1.000 unità. Per gli articoli in pacchetto, come Instagram Auto Likes, 50 per Post, 30 Giorni (#1020), la tariffa è il prezzo di un pacchetto, e min e max sono entrambi 1.
Ecco una voce, scritta campo per campo, per Instagram Followers, Real, International.
| Campo | Valore di esempio | Significato |
|---|---|---|
| service | 1001 | ID del servizio utilizzato nell'azione add |
| name | Instagram Followers, Real, International | Nome del servizio |
| category | Gruppo di servizi | |
| rate | 0.7059 | USD per 1.000 |
| min | 100 | Quantità minima per ordine |
| max | 1000000 | Quantità massima per ordine |
| refill | true | Il refill è disponibile per ordini completati |
Come si effettua un ordine con l'azione add?
Invia action=add con l'ID del servizio, il link e la quantità. Il link segue lo stesso formato del sito web: un username per i follower di Instagram, un link di un post o Reel per i like, un link di un video per le visualizzazioni di YouTube, un link di un canale per gli iscritti di YouTube.
Per servizi di commenti personalizzati come YouTube Comments, Custom Text, International (#1115), invia un campo comments invece della quantità. Inserisci un commento per riga, separati da interruzioni di riga; il numero di righe diventa la quantità.
Una chiamata riuscita restituisce il nuovo ID dell'ordine, ad esempio order: 84172630. Salvalo con il tuo ordine cliente, perché status e refill lo utilizzano.
| Campo | Valore di esempio |
|---|---|
| key | la tua API key |
| action | add |
| service | 1004 |
| link | https://www.instagram.com/p/C8xYz12AbCd/ |
| quantity | 5000 |
| Risposta | order: 84172630 |
Come si monitorano gli ordini e il saldo?
Invia action=status con order impostato sull'ID di add. La risposta ha cinque campi: charge (il costo in USD), start_count (il contatore quando è iniziata la consegna), status, remains (la quantità ancora da consegnare) e currency.
Il campo status utilizza le stesse parole della pagina Ordini: Pending, In progress, Completed, Partial e Canceled. Per Partial, il rimborso della quantità rimanente è già tornato sul tuo saldo; per Canceled, l'intero costo è tornato.
Invia action=balance per leggere il saldo corrente, ad esempio balance: 110.0000 e currency: USD. Controllalo prima di grandi batch in modo che il tuo panel possa sospendere nuovi ordini quando i fondi sono bassi.
Per il polling, un controllo dello stato ogni 10-30 minuti per ordine aperto è sufficiente per la maggior parte dei servizi. Interrompi il polling una volta che lo stato è Completed, Partial o Canceled, poiché sono finali, e memorizza il costo finale e la quantità rimanente con il tuo ordine cliente in modo che i tuoi record corrispondano alla pagina Ordini.
| Campo | Valore di esempio | Significato |
|---|---|---|
| charge | 3.3575 | Costo dell'ordine in USD |
| start_count | 1240 | Like sul post quando è iniziata la consegna |
| status | In progress | Stato attuale dell'ordine |
| remains | 1800 | Quantità ancora da consegnare |
| currency | USD | Valuta del costo |
Come funziona l'azione refill?
I servizi con un periodo di refill accettano una richiesta di refill dopo il completamento: 90 giorni per i follower internazionali di Instagram, 60 giorni per i membri di Telegram e 30 giorni per gli iscritti di YouTube, i follower di X e i like di X. L'azione services mostra refill: true per questi elementi.
Invia action=refill con l'ID dell'ordine. La risposta restituisce un ID della richiesta di refill e la quantità mancante viene inviata nuovamente allo stesso link. Sul sito web, la stessa richiesta è il pulsante Refill nella pagina Ordini.
I follower internazionali di Instagram diventano idonei 24 ore dopo il completamento della consegna. Una configurazione comune per i rivenditori è un lavoro notturno che controlla i conteggi sugli ordini recenti di follower e invia il refill quando il conteggio scende al di sotto dello start count più la quantità.
Come si calcola il costo e il margine dal tasso per 1.000?
Il costo di un ordine è il tasso moltiplicato per la quantità divisa per 1.000. Le eccezioni sono i pacchetti: il loro tasso è il prezzo di un pacchetto.
Esempio pratico: Telegram Members (#1134) ha un tasso di $0.4440. Un cliente ordina 10.000 membri, quindi il costo è 10.000 / 1.000 x 0.4440 = $4.44. Se il tuo panel vende questo servizio a $1.00 per 1.000, il cliente paga $10.00 e il tuo margine è $5.56.
Secondo esempio: Instagram Likes, Real, International (#1004) ha un tasso di $0.0462. Un ordine di 5.000 like costa 5 x 0.0462 = $0.2310. Venduto a $0.15 per 1.000, il cliente paga $0.75 e il margine è $0.5190 su un ordine.
| Servizio | Tariffa per 1.000 | Quantità | Addebito | Vendi a per 1.000 | Margine |
|---|---|---|---|---|---|
| #1134 Membri Telegram | $0.4440 | 10,000 | $4.4400 | $1.00 | $5.5600 |
| #1004 Mi piace Instagram | $0.0462 | 5,000 | $0.2310 | $0.15 | $0.5190 |
| #1121 Visualizzazioni TikTok | $0.0938 | 50,000 | $4.6900 | $0.20 | $5.3100 |
| #1001 Follower Instagram | $0.7059 | 2,000 | $1.4118 | $2.00 | $2.5882 |
Come finanzi un account API?
Gli ordini API attingono dallo stesso saldo USD prepagato del sito web. Aggiungi fondi dal tuo account tramite il checkout crypto PayGate con 12 metodi, inclusi USDT, USDC, Bitcoin, Ethereum, BNB e Solana, da $30 a $5.000 per pagamento.
Il primo ricarica riceve un bonus una tantum: +10% da $100, +15% da $300, +20% da $500 e +25% da $1.000. Un rivenditore che inizia con $1.000 riceve $1.250 di saldo, che copre circa 1.770.000 follower Instagram su #1001 a $0.7059 per 1.000.
Il saldo viene utilizzato per gli ordini su SNSSupporter e i rimborsi degli ordini Parziali e Annullati vi ritornano automaticamente, quindi il denaro rimane pronto per la prossima chiamata API.