Zum Inhalt springen
shareto

ShareTo API

Veröffentliche aus deinem eigenen Code

Eine REST-API, um Konten zu verbinden und Beiträge auf Instagram, Facebook, YouTube, LinkedIn und TikTok zu veröffentlichen oder zu planen. Erstelle so viele API-Schlüssel, wie du brauchst.

Basis-URLhttps://shareto.social/api/v1

  1. Authentifizieren

    Erstelle unter Einstellungen im Bereich API einen Schlüssel und sende ihn bei jeder Anfrage als Bearer-Token. Schlüssel sind unbegrenzt, werden nur einmal angezeigt und lassen sich jederzeit widerrufen.

    curl https://shareto.social/api/v1/accounts \
      -H "Authorization: Bearer st_live_..."
  2. Konto verbinden

    Fordere einen Verbindungslink an und öffne ihn im Browser oder schick ihn an die Person, der das Konto gehört. Sie stimmt auf der Plattform zu und landet wieder auf deiner redirectUrl. Der Link gilt 30 Minuten.

    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. Medien hochladen

    Hol dir eine Upload-Erlaubnis und lade die Datei per PUT an putUrl hoch. Große Videos können über tus fortgesetzt werden. Nutze die zurückgegebene url im Beitrag.

    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. Veröffentlichen oder planen

    Sende Text, Medien und Konto-IDs. Lass scheduledAt leer, um sofort zu veröffentlichen, oder gib eine ISO-Zeit zum Planen an. Jedes Konto bekommt einen eigenen Status.

    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"
      }'

Endpunkte

MethodePfadWas er macht
GET/accountsVerbundene Konten auflisten
GET/accounts/{id}Ein Konto abrufen
POST/accounts/connectEinen Verbindungslink für eine Plattform erstellen
DELETE/accounts/{id}Ein Konto trennen und seine geplanten Beiträge abbrechen
POST/uploadsEine einmalige Upload-Erlaubnis für eine Datei holen
POST/postsEinen Beitrag sofort veröffentlichen oder planen
GET/posts?ids=a,bDie letzten 50 Beiträge abrufen oder die in ids genannten
GET/posts/{id}Einen Beitrag mit dem Status jedes Kontos abrufen
DELETE/posts/{id}Einen Beitrag löschen, der noch nicht live ist

Verbindungswege

Ein Konto verbindet sich über Zernio, eine Partner-API zum Veröffentlichen, deren Apps die Plattformen für öffentliche Beiträge freigegeben haben, oder direkt über die eigenen Apps von ShareTo. Sende connection als auto, zernio oder direct; auto wählt den Weg je Plattform.

Fehler

Fehler kommen als JSON mit einer message: 401 bei fehlendem oder falschem Schlüssel, 404, wenn der Eintrag nicht in deinem Workspace liegt, 422, wenn die Anfrage gegen eine Plattformregel verstößt. Die Nachricht sagt, was zu ändern ist.

ShareTo ist in der privaten Beta. Frag nach Zugang, um einen Workspace zu eröffnen.