Synupv1
Crear clave
v1Recursos/Datos/getListar assets

Listar assets

Devuelve un fragmento paginado del catálogo unificado de assets, del más reciente al más antiguo — subidas, imágenes generadas por IA, assets de la biblioteca de medios sincronizada, fotos importadas de GBP y medios enviados por usuarios (UGC), combinados en un solo feed.

get/api/v1/assets
media:read
Parámetros de consulta
sourcestring (all | upload | gmb | generated | discovered | ugc)opcional
Limitar a una pestaña de origen: all (predeterminado), upload, gmb, generated, discovered o ugc.
typestringopcional
Limitar a un tipo de asset, p. ej. image o video.
folderIdstringopcional
Limitar a assets de esta carpeta.
tagstringopcional
Limitar a assets con esta etiqueta.
locationIdstringopcional
Limitar a assets asignados a esta ubicación. Búsquelo con GET /api/v1/locations.
clientIdstringopcional
El cliente al que limitar los resultados. Obligatorio si esta clave está restringida a clientes específicos y no se indica locationId. Búsquelo con GET /api/v1/clients.
qstringopcional
Buscar por título o nombre de archivo.
cursorstringopcional
Cursor de paginación del nextCursor de una respuesta anterior.
limitnumberopcional
Máximo de elementos a devolver. Predeterminado 60, máximo 200.
statusstring (needs_review | spam | ok | skipped)opcional
Filtro de estado de moderación — solo aplica cuando source es ugc: needs_review, spam, ok o skipped.
Respuesta
dataobjectopcional
itemsarray of objectopcional
La página de assets.
keystringopcional
Identificador compuesto del archivo, con el formato "<source>:<id>".
sourcestringopcional
Origen de este archivo (p. ej. una subida de OS frente a una fuente importada).
idstringopcional
El id del archivo dentro de su fuente.
titlestringopcional
El título del archivo.
filenamestringopcional
El nombre de archivo original del archivo.
mimestringopcional
El tipo MIME del archivo.
kindstringopcional
El tipo del archivo (foto o video).
sizeBytesnumberopcional
Tamaño del archivo en bytes, o null si se desconoce.
urlstringopcional
URL lista para usar con los bytes del archivo.
thumbnailUrlstringopcional
URL de una vista previa en miniatura, o null.
tagsarray of stringopcional
Etiquetas asociadas al archivo.
folderIdsarray of stringopcional
Carpetas de archivos a las que pertenece este archivo.
locationIdsarray of stringopcional
Todas las ubicaciones con las que está asociado este archivo.
nextCursorstringopcional
Páselo como cursor en la siguiente llamada para obtener la página siguiente. Null cuando no hay más.
countsobjectopcional
Totales por pestaña (all/upload/gmb/generated/discovered/ugc), independientes de los filtros activos.
Errores
401La clave de API falta, es inválida, expiró o fue revocada.
403A la clave le falta el permiso requerido, o no está autorizada para este cliente/ubicación.
429Demasiadas solicitudes. Reintente tras el número de segundos indicado en el encabezado Retry-After.
get/api/v1/assets
Su clave de API
source
type
folderId
tag
locationId
clientId
q
cursor
limit
status
{
  "data": {
    "items": [
      {
        "key": "upload:abc123",
        "source": "upload",
        "id": "abc123",
        "title": "Storefront photo",
        "filename": "storefront.jpg",
        "mime": "image/jpeg",
        "kind": "image",
        "sizeBytes": 482913,
        "url": "https://cdn.synup.com/media/abc123.jpg",
        "thumbnailUrl": "https://cdn.synup.com/media/abc123-thumb.jpg",
        "tags": [
          "VIP"
        ],
        "folderIds": [
          "folder_1"
        ],
        "locationIds": [
          "loc_456"
        ]
      }
    ],
    "nextCursor": null,
    "counts": {
      "all": 1,
      "upload": 1,
      "gmb": 0,
      "generated": 0,
      "discovered": 0,
      "ugc": 0
    }
  }
}