Publique posts de texto, imagem, várias imagens e vídeo em um perfil do LinkedIn ou em uma Página de empresa que você administra, de forma agendada, a partir de um único endpoint REST. Sem precisar registrar um app de desenvolvedor do LinkedIn.
URL base https://api.so-me.studio/v1 · Autenticação X-API-Key · socialMedia: LINKEDIN_PAGE | LINKEDIN
Envie um destes valores em postType. Todo post precisa de texto, e fotos ou vídeos são anexados por fileId a partir da sua biblioteca de mídia.
TEXT
Uma atualização só com texto.
IMAGE
Uma imagem com o seu texto.
CAROUSEL
De 2 a 20 imagens em um único post com várias imagens.
VIDEO
Um vídeo nativo.
Envie a mídia e depois crie o post. Omita scheduledAt para publicar na hora.
POST /v1/media/presign-upload adiciona o arquivo à sua biblioteca de mídia e devolve um fileId e um uploadUrl pré-assinado.
curl -X POST https://api.so-me.studio/v1/media/presign-upload \
-H "X-API-Key: $SOME_API_KEY" \
-H "Content-Type: application/json" \
-d '{"files":[{"filename":"release-chart.png","mimetype":"image/png","size":734003}]}'
# → [{ "fileId": "…", "uploadUrl": "https://…", "fileSrc": "…", "s3Key": "…" }]Faça um PUT dos bytes em uploadUrl com exatamente o Content-Type que você declarou. A URL é válida por uma hora.
curl -X PUT "$UPLOAD_URL" \
-H "Content-Type: image/png" \
--upload-file ./release-chart.pngPOST /v1/posts com o fileId. A resposta é o post com status SCHEDULED, e ele é publicado em scheduledAt por uma fila que tenta de novo em caso de falha.
curl -X POST https://api.so-me.studio/v1/posts \
-H "X-API-Key: $SOME_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"socialMedia": "LINKEDIN_PAGE",
"accountId": "<account id from GET /v1/accounts>",
"postType": "IMAGE",
"text": "Acabamos de lançar os relatórios agendados. Três gráficos mostram o que mudou.",
"fileIds": ["<fileId>"],
"scheduledAt": "2026-11-04T08:30:00Z",
"firstComment": "Notas da versão: https://example.com/changelog"
}'accountId é opcional quando o workspace tem uma conta de LinkedIn. Caso contrário, passe um id de GET /v1/accounts.
Os arquivos anexados com fileIds são verificados contra os limites de LinkedIn abaixo antes de qualquer coisa entrar na fila. Um arquivo que viola uma regra retorna 400 com um relatório por arquivo.
Os campos que mudam a forma como um post é publicado em LinkedIn.
| Campo | O que faz |
|---|---|
| socialMedia | LINKEDIN publica em um perfil pessoal, LINKEDIN_PAGE em uma Página de empresa. |
| accountId | O perfil ou a Página de onde publicar, conforme listado por GET /v1/accounts. Necessário quando há mais de um conectado. |
| firstComment | Um comentário adicionado abaixo do post assim que ele vai ao ar, com até 1.250 caracteres. Útil para um link ou hashtags. |
O Social media studio verifica cada arquivo contra estes limites antes de publicar. São os limites que configuramos, não uma promessa de LinkedIn: GET /v1/media/rules devolve a tabela atual, e POST /v1/media/validate verifica um arquivo sem publicá-lo.
Tipo de post TEXT
Somente texto, sem mídia
Tipo de post IMAGE
Tipo de post CAROUSEL
Tipo de post VIDEO
A publicação é assíncrona. Assine post.published e post.failed, ou consulte GET /v1/posts/:id até que postStatus seja POSTED ou FAILED.
curl -X POST https://api.so-me.studio/v1/webhooks/subscriptions \
-H "X-API-Key: $SOME_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"url": "https://example.com/hooks/social",
"categories": ["post"],
"events": ["post.published", "post.failed"]
}'
# The response includes the secret that signs every delivery.POST /hooks/social
X-Webhook-Event: post.published
X-Webhook-Signature: <hex HMAC-SHA256 of the raw body>
{
"event": "post.published",
"category": "post",
"timestamp": "2026-11-03T15:00:07.412Z",
"data": { "postId": "…", "platform": "LINKEDIN_PAGE" }
}Toda entrega é assinada com HMAC-SHA256 em X-Webhook-Signature. post.failed é disparado após a última nova tentativa; corrija a causa e chame POST /v1/posts/:id/retry. Um primeiro comentário é reportado por conta própria, com post.first_comment_posted ou post.first_comment_failed.
A mesma chave de API aciona um servidor MCP com mais de 200 ferramentas e uma CLI, para que um agente possa publicar em LinkedIn sem chamadas HTTP escritas à mão.
Adicione o servidor ao Claude, ao Cursor ou a qualquer cliente MCP com a sua chave de API. OAuth também funciona. Para LinkedIn, o agente chama estas ferramentas com os mesmos campos da requisição REST:
{
"mcpServers": {
"so-me-studio": {
"url": "https://api.so-me.studio/mcp",
"headers": { "X-API-Key": "sk_live_…" }
}
}
}Instale com npm i -g @social-media-scheduler/cli. Ela envia os arquivos locais por você e imprime JSON, então um script ou um job de CI pode agendar um post em LinkedIn com um único comando.
so-me posts:create --platform LINKEDIN_PAGE -a <account-id> \
--post-type IMAGE -m ./release-chart.png \
-c "Acabamos de lançar os relatórios agendados." \
-s 2026-11-04T08:30:00ZO acesso à API, à CLI e ao MCP está incluído em todos os planos pagos: Lite, Creator, Standard, Advanced e Lifetime. Veja os planos e limites
Sim. Conecte a Página no painel como um dos administradores dela e envie socialMedia LINKEDIN_PAGE com essa Página como accountId.
Sim. Envie socialMedia LINKEDIN para publicar no perfil de membro que foi conectado.
De 2 a 20 em um post com várias imagens: envie postType CAROUSEL com os fileIds delas. Cada imagem pode ter até 5 MB.
Não. Você conecta a conta de LinkedIn uma única vez no painel do Social media studio, pelo login de LinkedIn. Os tokens ficam armazenados criptografados e são renovados do nosso lado, e o seu código envia apenas a sua chave de API do Social media studio no cabeçalho X-API-Key.
Não. Ele retorna assim que o post entra na fila. A publicação roda em um worker que tenta de novo em caso de falha, então escute post.published e post.failed, ou consulte GET /v1/posts/:id.
A API REST, a CLI e o servidor MCP estão incluídos em todos os planos pagos: Lite, Creator, Standard, Advanced e Lifetime. Lite, Creator, Standard e Advanced começam com um teste de 7 dias (cartão obrigatório), e o Lifetime é um pagamento único.
Pare de malabarismo com abas, escreva, adapte e publique em 20 plataformas a partir de um único calendário.