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

Requisitos previos

Antes de empezar, asegúrate de tener:

Una cuenta de Social media studio con al menos una cuenta social conectada
Una clave de API (consulta Autenticación)

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:

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 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 para ver la lista completa de plataformas compatibles.

Respuesta

{
  "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:

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:

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:

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:

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:

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

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.

Primeros pasos

Publicación

AI Studio

Bandeja de entrada e interacción

Analíticas

Biolink

Equipo y colaboración

Configuración y facturación

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

Requisitos previos

URL base

Crear una publicación

Programar una publicación

Listar publicaciones

Subir medios

Siguientes pasos

Referencia de la API

Servidor MCP

​Requisitos previos

​URL base

​Crear una publicación

​Programar una publicación

​Listar publicaciones

​Subir medios

​Siguientes pasos

Referencia de la API

Servidor MCP

Requisitos previos

URL base

Crear una publicación

Programar una publicación

Listar publicaciones

Subir medios

Siguientes pasos