BizKitHub
DocsAPI ReferencePost/bff/post/media-library-list
getPostAdmin BFF

/bff/post/media-library-list

Returns org-wide library images, newest first, with live usage counters derived from post galleries. Blobs that were deleted or moved to Drive trash are hidden.

PostgetBffPostMedia-library-list

Parameters

5 query

Query parameters

· 5
querystringOptional

Full-text filter over the image title and filename.

Exampleexample_query
usage"all" | "unused" | "used"Optional

unused = not in any live post gallery yet; used = in at least one.

postIdstringOptional

Post external ID. When set, each item reports inCurrentPost.

Exampleexample_postId
limitstring | numberOptional

Page size (default 60).

Range: 1–500
offsetstring | numberOptional

Rows to skip.

Range: 0–∞

Response schema

1 status code documented

200Success
itemsobject[]Required
Each array item:
idstringRequired

Library item id.

titlestringRequired

Default alt text. Empty when not set.

insertedDatestringRequired
blobTokenstringRequired
downloadUrlstringRequired
filenamestringRequired
sizenumberRequired
contentTypestringRequired
usageCountnumberRequired

Live posts whose gallery contains the image.

mainUsageCountnumberRequired

Live posts that use the image as their main image.

inCurrentPostbooleanRequired

Already in the gallery of postId (false when not given).

itemCountnumberRequired

Total items matching the filter.

Response example

application/json
{
  "items": [
    {
      "id": "example_id",
      "title": "example_title",
      "insertedDate": "example_insertedDate",
      "blobToken": "example_blobToken",
      "downloadUrl": "example_downloadUrl",
      "filename": "example_filename",
      "size": 0,
      "contentType": "example_contentType",
      "usageCount": 0,
      "mainUsageCount": 0,
      "inCurrentPost": false
    }
  ],
  "itemCount": 0
}

Request example

GET /bff/post/media-library-list

get
curl -X GET "https://api.bizkithub.com/bff/post/media-library-list?query=example_query&postId=example_postId" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY"

Need an API key?

All BizKitHub public API endpoints require authentication via API key.

Get API Key