Vai al contenuto
shareto

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

  1. 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_..."
  2. 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" } }
  3. 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.mp4
  4. Pubblica 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

MetodoPercorsoCosa fa
GET/accountsElenca gli account collegati
GET/accounts/{id}Recupera un account
POST/accounts/connectCrea un link di collegamento per una piattaforma
DELETE/accounts/{id}Scollega un account e annulla i suoi post programmati
POST/uploadsOttieni un permesso di caricamento monouso per un file
POST/postsPubblica subito o programma un post
GET/posts?ids=a,bRecupera 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.