OMomnisocials
Media

List media

Changed on
get/media

Request

  • Base URL
    https://api.omnisocials.com/v1
  • URL
    https://api.omnisocials.com/v1/media
  • Auth
    HTTP bearer

Query parameters

limitinteger
offsetinteger
searchstring
Example:autumn

Case-insensitive search across the media name and filename. Use this to find an existing asset by name instead of re-uploading it.

folder_idstring
Example:12

Return only media in this folder. Use "root" for unfiled items at the top level.

Response

List of media files

Example response

{
  "data": [
    {
      "id": "482913",
      "url": "https://cdn.omnisocials.com/file/library-omnisocials/312a658f-2b45-4289-b240-890807221a74/library/1792573200000-k3j9xq_0c9e6b1a-2f4d-4b8e-a7c3-9d1e5f6a2b70.jpg",
      "thumbnail_url": "https://cdn.omnisocials.com/file/library-omnisocials/312a658f-2b45-4289-b240-890807221a74/library/thumbnails/1792573200000-k3j9xq_0c9e6b1a-2f4d-4b8e-a7c3-9d1e5f6a2b70_thumbnail.webp",
      "name": "autumn-menu-hero",
      "folder_id": "12",
      "filename": "0c9e6b1a-2f4d-4b8e-a7c3-9d1e5f6a2b70.jpg",
      "size": "2.50 MB",
      "created_at": "2026-10-20T14:32:10.000Z",
      "pdf": {
        "id": "9a7e3c1f-5b2d-4e8a-b6c4-1f3d5e7a9b20",
        "name": "deck.pdf",
        "url": "https://cdn.omnisocials.com/file/library-omnisocials/312a658f-2b45-4289-b240-890807221a74/library/1792573200000-p7m2wd_9a7e3c1f-5b2d-4e8a-b6c4-1f3d5e7a9b20.pdf",
        "page": 1,
        "total_pages": 8,
        "rendered_pages": 8,
        "pages": [
          {
            "url": "https://cdn.omnisocials.com/file/library-omnisocials/312a658f-2b45-4289-b240-890807221a74/library/1792573200000-p7m2wd_4c2e8a6f-1d3b-4f5a-9e7c-0b2d4f6a8c13.png",
            "width": 1080,
            "height": 1350
          }
        ]
      }
    }
  ],
  "pagination": {
    "total": 42,
    "limit": 20,
    "has_more": true
  }
}

Changes

  • a2a4ef9be162Revision changes
    • warning

      added the new document enum value to the // response property for the response status

    • info

      added the optional property // to the response with the status