Pular para o conteúdo
shareto

ShareTo API

Publique a partir do seu código

Uma única API REST para conectar contas e publicar ou agendar posts no Instagram, Facebook, YouTube, LinkedIn e TikTok. Crie quantas chaves de API precisar.

URL basehttps://shareto.social/api/v1

  1. Autenticação

    Crie uma chave em Configurações, seção API, e envie como token Bearer em cada requisição. As chaves são ilimitadas, aparecem uma única vez e podem ser revogadas a qualquer momento.

    curl https://shareto.social/api/v1/accounts \
      -H "Authorization: Bearer st_live_..."
  2. Conectar uma conta

    Peça um link de conexão e abra no navegador, ou envie para quem é dono da conta. A pessoa autoriza na plataforma e volta para o seu redirectUrl. O link vale por 30 minutos.

    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. Enviar mídia

    Obtenha uma permissão de envio e mande o arquivo com PUT para putUrl. Vídeos grandes podem continuar de onde pararam via tus. Use a url retornada no 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. Publicar ou agendar

    Envie o texto, a mídia e os IDs das contas. Deixe scheduledAt vazio para publicar na hora, ou informe um horário ISO para agendar. Cada conta tem seu próprio 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"
      }'

Endpoints

MétodoCaminhoO que faz
GET/accountsLista as contas conectadas
GET/accounts/{id}Busca uma conta
POST/accounts/connectCria um link de conexão para uma plataforma
DELETE/accounts/{id}Desconecta uma conta e cancela os posts agendados dela
POST/uploadsGera uma permissão de envio única para um arquivo
POST/postsPublica na hora ou agenda um post
GET/posts?ids=a,bBusca os últimos 50 posts ou os indicados em ids
GET/posts/{id}Busca um post com o status de cada conta
DELETE/posts/{id}Exclui um post que ainda não está no ar

Formas de conexão

Uma conta se conecta pelo Zernio, uma API de publicação parceira cujos apps as plataformas aprovaram para posts públicos, ou diretamente pelos apps do próprio ShareTo. Envie connection como auto, zernio ou direct; auto escolhe a forma para cada plataforma.

Erros

Os erros chegam em JSON com um message: 401 quando a chave falta ou está errada, 404 quando o item não está no seu workspace, 422 quando a requisição quebra uma regra da plataforma. A mensagem diz o que mudar.

O ShareTo está em beta fechado. Peça acesso para abrir um workspace.