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
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_..."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" } }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.mp4Publicar 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étodo | Caminho | O que faz |
|---|---|---|
| GET | /accounts | Lista as contas conectadas |
| GET | /accounts/{id} | Busca uma conta |
| POST | /accounts/connect | Cria um link de conexão para uma plataforma |
| DELETE | /accounts/{id} | Desconecta uma conta e cancela os posts agendados dela |
| POST | /uploads | Gera uma permissão de envio única para um arquivo |
| POST | /posts | Publica na hora ou agenda um post |
| GET | /posts?ids=a,b | Busca 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.