> ## Documentation Index
> Fetch the complete documentation index at: https://docs.so-me.studio/llms.txt
> Use this file to discover all available pages before exploring further.

# Início rápido da API de redes sociais

> Crie uma chave de API e agende sua primeira publicação no Instagram, LinkedIn, X, TikTok e mais com uma única chamada REST. Exemplos curl funcionais para publicações e mídia.

## Pré-requisitos

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

1. Uma conta do Social media studio com pelo menos uma conta social conectada
2. Uma chave de API (veja [Autenticação](/pt-BR/authentication.md))

## 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:

```bash theme={null}
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"
  }'
```

> [!NOTE]
>
> `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](/pt-BR/get-started/connecting-accounts.md) para a lista completa
> de plataformas compatíveis.

```json Resposta theme={null}
{
  "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:

```bash theme={null}
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:

```bash theme={null}
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:

```bash theme={null}
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:

```bash theme={null}
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:

```bash theme={null}
curl -X PUT "UPLOAD_URL_FROM_THE_RESPONSE" \
  -H "Content-Type: image/jpeg" \
  --data-binary @photo.jpg
```

> [!WARNING]
>
> 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.

## Próximos passos

> **[Referência da API](/pt-BR/api-reference)**
>
> Referência completa dos endpoints, com playground interativo

> **[Servidor MCP](/pt-BR/mcp/overview.md)**
>
> Conecte agentes de IA pelo Model Context Protocol


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.