Ir al contenido
Quiet Social

Marcas y destinos

Esta documentación está traducida del francés. Si ambas versiones difieren, prevalece la versión francesa.

Una marca es aquello para lo que publicas: una empresa, un cliente, un producto. Un destino es una cuenta concreta en la que publica una marca: una Página de Facebook, una cuenta profesional de Instagram, una Página de LinkedIn, una cuenta de Threads o un tablero de Pinterest.

Las conexiones a las redes y la vinculación de los destinos a una marca se hacen en el panel (consulta la guía). La API las lee; no las crea.

GET /brands

Las marcas que el cliente puede ver, ordenadas por nombre. Un cliente vinculado a una marca solo ve una.

Permiso requerido: brands:read.

curl https://quietsocial.dev/api/v1/brands \
  -u "$QUIET_CLIENT_ID:$QUIET_CLIENT_SECRET"
{
  "data": [
    {
      "id": "brd_01k4b8x2q9r7f3m5t6v8w0y2z4",
      "name": "Fabrique du Nord",
      "timezone": "Europe/Paris",
      "locale": "fr",
      "status": "active",
      "paused": false,
      "monthly_publication_limit": 1000,
      "monthly_delivery_limit": 5000
    }
  ]
}
  • timezone es la zona horaria por defecto de las publicaciones de la marca.
  • paused vale true cuando un administrador ha pausado los envíos de la marca: una publicación creada o programada durante la pausa se acepta, pero solo sale al reanudarse.
  • monthly_publication_limit y monthly_delivery_limit son las cuotas de la marca: las del plan del espacio, salvo excepción propia de la marca. null significa «sin límite».
  • La lista no está paginada.

Códigos: 200, 401, 403, 429.

GET /destinations

Los destinos visibles para el cliente, ordenados por nombre.

Permiso requerido: destinations:read.

Parámetro Tipo Por defecto Nota
brand_id brd_… Solo devuelve los destinos de esta marca. Una marca fuera de alcance devuelve una lista vacía.
per_page entero 25 Entre 1 y 100.
page entero 1
curl "https://quietsocial.dev/api/v1/destinations?per_page=50" \
  -u "$QUIET_CLIENT_ID:$QUIET_CLIENT_SECRET"
{
  "data": [
    {
      "id": "dst_01k4b8x2q9r7f3m5t6v8w0y2z4",
      "brand_id": "brd_01k4b8x2q9r7f3m5t6v8w0y2z4",
      "network": "facebook",
      "name": "Fabrique du Nord",
      "username": "fabriquedunord",
      "avatar_url": "https://scontent.example/avatar.jpg",
      "status": "active",
      "can_publish": true,
      "capabilities": {
        "text": true,
        "link": true,
        "image": true,
        "maximum_text_length": 63206,
        "maximum_media_count": 1,
        "requires_media": false,
        "alt_text": true,
        "first_comment": false,
        "title": false
      },
      "synchronized_at": "2026-09-30T04:40:12+00:00"
    }
  ],
  "links": { "first": "…", "last": "…", "prev": null, "next": null },
  "meta": { "current_page": 1, "from": 1, "last_page": 1, "path": "…", "per_page": 50, "to": 1, "total": 1, "links": ["…"] }
}

La paginación se describe en Límites y convenciones.

Códigos: 200, 401, 403, 429.

GET /destinations/{id}

Permiso requerido: destinations:read.

La respuesta es el mismo objeto, envuelto en data. Un destino de otra marca responde 404.

Códigos: 200, 401, 403, 404, 429.

Leer un destino

network

El nombre corto de la red. Es el valor que espera overrides al crear una publicación, y el que devuelven los objetivos de una publicación.

network Destino
facebook Página de Facebook
instagram Cuenta profesional de Instagram
linkedin Página de LinkedIn
threads Cuenta de Threads
pinterest Tablero de Pinterest

status y can_publish

status vale active, disabled (desactivado por un miembro del equipo) o unavailable (la red ya no lo proporciona, o la conexión ha sido revocada).

can_publish solo es verdadero si el destino está activo, su propio token no ha caducado y la conexión que lo sostiene está activa. Una Página activa vinculada a una conexión revocada no es publicable. Una publicación hacia un destino cuyo can_publish es falso se rechaza al crearla.

capabilities

Lo que acepta el destino, para componer sin que te lo rechacen:

Campo Significado
text Acepta un texto.
link Acepta un enlace (link_url).
image Acepta una imagen.
maximum_text_length Longitud máxima del texto, en caracteres.
maximum_media_count Número máximo de imágenes.
requires_media Una imagen es obligatoria.
alt_text El texto alternativo de una imagen se transmite a la red.
first_comment Se puede publicar un primer comentario bajo el post. Hoy es falso en todas partes.
title El post lleva un título visible, distinto del texto (el título de un Pin).

Las capacidades se recalculan en cada sincronización del destino: léelas en lugar de copiarlas. Valores actuales:

Red Texto máx. Enlace Imágenes máx. Imagen obligatoria Texto alternativo Título
Facebook 63 206 sí 1 no sí no
Instagram 2 200 no 1 sí sí no
LinkedIn 3 000 sí 1 no sí no
Threads 500 sí 1 no sí no
Pinterest 800 sí 1 sí sí sí

La longitud del texto se cuenta como la cuenta la red: hashtags añadidos incluidos (salvo en Threads), tras el escapado de los caracteres reservados en LinkedIn, y en Threads cada emoji cuenta por su número de bytes UTF-8 (😀 cuenta 4).

Cada red impone además sus propias reglas sobre la propia imagen; se comprueban antes del envío y se detallan en la guía.