Início rápido da API de redes sociais

Pré-requisitos

Antes de começar, confira se você tem:

Uma conta do Social media studio com pelo menos uma conta social conectada
Uma chave de API (veja Autenticação)

URL base

Todas as requisições da API devem ser feitas para:

https://api.so-me.studio/v1

Criar uma publicação

Envie uma requisição POST para criar uma nova publicação:

curl -X POST https://api.so-me.studio/v1/posts \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Hello from the API!",
    "socialMedia": "TWITTER",
    "postType": "TEXT"
  }'

socialMedia aceita qualquer um dos 16 destinos de publicação (como TWITTER, LINKEDIN, INSTAGRAM, FACEBOOK, TIKTOK, YOUTUBE, THREADS, PINTEREST, BLUESKY e outros), e não apenas os poucos mostrados nestes exemplos. WHATSAPP e TELEGRAM são apenas de mensagens e não aceitam publicações. Veja Conectar contas para a lista completa de plataformas compatíveis.

Resposta

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "text": "Hello from the API!",
  "socialMedia": "TWITTER",
  "postType": "TEXT",
  "postStatus": "SCHEDULED",
  "createdAt": "2025-01-15T09:00:00.000Z"
}

Agendar uma publicação

Para agendar uma publicação para o futuro, inclua scheduledAt ao criar:

curl -X POST https://api.so-me.studio/v1/posts \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Scheduled post!",
    "socialMedia": "LINKEDIN",
    "postType": "TEXT",
    "scheduledAt": "2025-02-01T12:00:00Z"
  }'

Ou agende uma publicação existente:

curl -X POST https://api.so-me.studio/v1/posts/{id}/schedule \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "scheduledAt": "2025-02-01T12:00:00Z"
  }'

Listar publicações

Consulte as publicações do seu espaço de trabalho com filtros opcionais. O filtro status corresponde ao campo postStatus retornado nas respostas, e socialMedia filtra por plataforma:

curl "https://api.so-me.studio/v1/posts?status=SCHEDULED&socialMedia=TWITTER&limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

Upload media

Para publicações com imagem e vídeo, primeiro obtenha uma URL de upload pré-assinada:

curl -X POST https://api.so-me.studio/v1/posts/presign-media \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "postType": "IMAGE",
    "socialMedia": "INSTAGRAM",
    "files": [{
      "filename": "photo.jpg",
      "mimetype": "image/jpeg",
      "size": 1024000
    }]
  }'

Depois, envie seu arquivo para o uploadUrl retornado com um PUT HTTP. Envie um cabeçalho Content-Type igual ao mimetype que você declarou:

curl -X PUT "UPLOAD_URL_FROM_THE_RESPONSE" \
  -H "Content-Type: image/jpeg" \
  --data-binary @photo.jpg

A URL de upload é assinada com o mimetype declarado. Um PUT sem o cabeçalho Content-Type (por exemplo curl -T ou requests.put(url, data=f) do Python), ou com um valor diferente, falha com 403 SignatureDoesNotMatch.

Depois, use s3Prefix e fileSrc na sua requisição de criação de publicação.

Primeiros passos

Publicação

AI Studio

Caixa de entrada e engajamento

Análises

Biolink

Equipe e colaboração

Configurações e cobrança

Início rápido da API de redes sociais

Pré-requisitos

URL base

Criar uma publicação

Agendar uma publicação

Listar publicações

Upload media

Próximos passos

Referência da API

Servidor MCP

​Pré-requisitos

​URL base

​Criar uma publicação

​Agendar uma publicação

​Listar publicações

​Upload media

​Próximos passos

Referência da API

Servidor MCP

Pré-requisitos

URL base

Criar uma publicação

Agendar uma publicação

Listar publicações

Upload media

Próximos passos