Synupv1
Create a key
v1Resources/Data/getList assets

List assets

Returns a paginated, newest-first slice of the unified asset catalog — uploads, AI-generated images, synced media-library assets, GBP-imported photos, and user-submitted (UGC) media, merged into one feed.

get/api/v1/assets
media:read
Query parameters
sourcestring (all | upload | gmb | generated | discovered | ugc)optional
Narrow to one source tab: all (default), upload, gmb, generated, discovered, or ugc.
typestringoptional
Narrow to one asset kind, e.g. image or video.
folderIdstringoptional
Narrow to assets in this folder.
tagstringoptional
Narrow to assets carrying this tag name.
locationIdstringoptional
Narrow to assets assigned to this location. Look it up with GET /api/v1/locations.
clientIdstringoptional
The client to scope results to. Required when this key is restricted to specific clients and no locationId is given. Look it up with GET /api/v1/clients.
qstringoptional
Search by title or filename.
cursorstringoptional
Pagination cursor from a previous response's nextCursor.
limitnumberoptional
Max items to return. Default 60, max 200.
statusstring (needs_review | spam | ok | skipped)optional
Moderation-status filter — only applies when source is ugc: needs_review, spam, ok, or skipped.
Response
dataobjectoptional
itemsarray of objectoptional
The page of assets.
keystringoptional
Composite identifier for the asset, formatted as "<source>:<id>".
sourcestringoptional
Where this asset originated (e.g. an OS upload vs. an imported source).
idstringoptional
The asset's id within its source.
titlestringoptional
The asset's title.
filenamestringoptional
The asset's original filename.
mimestringoptional
The asset's MIME type.
kindstringoptional
The asset's kind (photo or video).
sizeBytesnumberoptional
File size in bytes, or null when unknown.
urlstringoptional
Ready-to-use URL for the asset's bytes.
thumbnailUrlstringoptional
URL of a thumbnail preview, or null.
tagsarray of stringoptional
Tags attached to the asset.
folderIdsarray of stringoptional
Asset folders this asset belongs to.
locationIdsarray of stringoptional
Every location this asset is associated with.
nextCursorstringoptional
Pass as cursor on the next call to fetch the following page. Null when there are no more.
countsobjectoptional
Per-tab totals (all/upload/gmb/generated/discovered/ugc), independent of the active filters.
Errors
401Missing, invalid, expired, or revoked API key.
403The key lacks the required scope, or isn't authorized for this client/location.
429Too many requests. Retry after the number of seconds in the Retry-After header.
get/api/v1/assets
Your API key
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
    }
  }
}