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

# Guía de inicio rápido de la API de redes sociales

> Crea una clave de API y programa tu primera publicación en Instagram, LinkedIn, X, TikTok y más con una sola llamada REST. Ejemplos curl funcionales para publicaciones y medios.

## Requisitos previos

Antes de empezar, asegúrate de tener:

1. Una cuenta de Social media studio con al menos una cuenta social conectada
2. Una clave de API (consulta [Autenticación](/es/authentication.md))

## URL base

Todas las solicitudes a la API deben hacerse a:

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

## Crear una publicación

Envía una solicitud `POST` para crear una publicación nueva:

```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` acepta cualquiera de los 16 destinos de publicación (como `TWITTER`,
> `LINKEDIN`, `INSTAGRAM`, `FACEBOOK`, `TIKTOK`, `YOUTUBE`, `THREADS`,
> `PINTEREST`, `BLUESKY` y más), no solo los que aparecen en estos ejemplos.
> `WHATSAPP` y `TELEGRAM` son solo de mensajería y no admiten publicaciones. Consulta
> [Conectar cuentas](/es/get-started/connecting-accounts.md) para ver la lista completa de
> plataformas compatibles.

```json Respuesta 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"
}
```

## Programar una publicación

Para programar una publicación a futuro, incluye `scheduledAt` al crearla:

```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"
  }'
```

O programa una publicación 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 publicaciones

Obtén las publicaciones de tu espacio de trabajo con filtros opcionales. El filtro `status` se
corresponde con el campo `postStatus` que devuelven las respuestas, y `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"
```

## Subir medios

Para publicaciones de imagen y vídeo, primero obtén una URL de subida prefirmada:

```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
    }]
  }'
```

Después sube tu archivo a la `uploadUrl` devuelta con un `PUT` HTTP. Envía una
cabecera `Content-Type` igual al `mimetype` que declaraste:

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

> [!WARNING]
>
> La URL de subida está firmada con el `mimetype` declarado. Un `PUT` sin la
> cabecera `Content-Type` (por ejemplo con `curl -T` o con Python
> `requests.put(url, data=f)`), o con un valor distinto, falla con
> `403 SignatureDoesNotMatch`.

Después usa `s3Prefix` y `fileSrc` en tu solicitud de creación de la publicación.

## Siguientes pasos

> **[Referencia de la API](/es/api-reference)**
>
> Referencia completa de endpoints con playground interactivo

> **[Servidor MCP](/es/mcp/overview.md)**
>
> Conecta agentes de IA mediante el Model Context Protocol


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