ShareTo API
Pubblica dal tuo codice
Un’unica API REST per collegare gli account e pubblicare o programmare post su Instagram, Facebook, YouTube, LinkedIn e TikTok. Crea tutte le chiavi API che ti servono.
URL di basehttps://shareto.social/api/v1
Autenticazione
Crea una chiave in Impostazioni, sezione API, e inviala come token Bearer a ogni richiesta. Le chiavi sono illimitate, vengono mostrate una sola volta e puoi revocarle in qualsiasi momento.
curl https://shareto.social/api/v1/accounts \ -H "Authorization: Bearer st_live_..."Collega un account
Chiedi un link di collegamento e aprilo nel browser, oppure mandalo a chi possiede l’account. Questa persona dà il consenso sulla piattaforma e torna al tuo redirectUrl. Il link vale 30 minuti.
curl -X POST https://shareto.social/api/v1/accounts/connect \ -H "Authorization: Bearer st_live_..." \ -H "Content-Type: application/json" \ -d '{ "platform": "tiktok", "redirectUrl": "https://example.com/done" }' # 201 { "data": { "url": "https://shareto.social/api/connect/tiktok?t=...", "expiresAt": "2026-11-10T10:30:00.000Z" } }Carica i media
Ottieni un permesso di caricamento, poi invia il file con PUT a putUrl. I video grandi possono riprendere tramite tus. Usa l’url restituito nel post.
curl -X POST https://shareto.social/api/v1/uploads \ -H "Authorization: Bearer st_live_..." \ -H "Content-Type: application/json" \ -d '{ "filename": "launch.mp4", "contentType": "video/mp4" }' curl -X PUT "$PUT_URL" \ -H "Authorization: Bearer $UPLOAD_TOKEN" \ -H "Content-Type: video/mp4" \ --data-binary @launch.mp4Pubblica o programma
Invia testo, media e ID degli account. Lascia vuoto scheduledAt per pubblicare subito, oppure indica un orario ISO per programmare. Ogni account ha il suo stato.
curl -X POST https://shareto.social/api/v1/posts \ -H "Authorization: Bearer st_live_..." \ -H "Content-Type: application/json" \ -d '{ "kind": "reel", "caption": "Behind the scenes", "media": [{ "url": "$MEDIA_URL", "type": "video" }], "accountIds": ["$ACCOUNT_ID"], "scheduledAt": "2026-11-12T09:00:00Z" }'
Endpoint
| Metodo | Percorso | Cosa fa |
|---|---|---|
| GET | /accounts | Elenca gli account collegati |
| GET | /accounts/{id} | Recupera un account |
| POST | /accounts/connect | Crea un link di collegamento per una piattaforma |
| DELETE | /accounts/{id} | Scollega un account e annulla i suoi post programmati |
| POST | /uploads | Ottieni un permesso di caricamento monouso per un file |
| POST | /posts | Pubblica subito o programma un post |
| GET | /posts?ids=a,b | Recupera gli ultimi 50 post o quelli indicati in ids |
| GET | /posts/{id} | Recupera un post con lo stato di ogni account |
| DELETE | /posts/{id} | Elimina un post non ancora online |
Modalità di collegamento
Un account si collega tramite Zernio, un’API di pubblicazione partner le cui app sono approvate dalle piattaforme per i post pubblici, oppure direttamente con le app di ShareTo. Invia connection come auto, zernio o direct; auto sceglie la modalità per ogni piattaforma.
Errori
Gli errori arrivano in JSON con un message: 401 se la chiave manca o è sbagliata, 404 se l’elemento non è nel tuo workspace, 422 se la richiesta viola una regola della piattaforma. Il messaggio dice cosa cambiare.
ShareTo è in beta privata. Chiedi l’accesso per aprire un workspace.