- Documentación
- API · Versión 1.0
- Marcas y destinos
Marcas y destinos
En esta página
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
}
]
}
timezonees la zona horaria por defecto de las publicaciones de la marca.pausedvaletruecuando 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_limitymonthly_delivery_limitson las cuotas de la marca: las del plan del espacio, salvo excepción propia de la marca.nullsignifica «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 |
|---|---|---|---|---|---|---|
| 63 206 | sí | 1 | no | sí | no | |
| 2 200 | no | 1 | sí | sí | no | |
| 3 000 | sí | 1 | no | sí | no | |
| Threads | 500 | sí | 1 | no | sí | no |
| 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.