Content Bank · Content Studio · Referência da API

GET/v1/social-content-studio/bank

List Content Library entries

social_content_studio.bank.list

LeituraIdempotenteDesde 2026-11-01

Lists the Content Library of Content Studio (the captions and video scripts the team saved), newest first, paginated by cursor (limit up to 200). Each entry carries its format (caption or video_script), status (draft, used, archived), title, network, the caption and hashtags or the script versions with their sections and duration, the series it belongs to (series_id, series_order), its folder and labels, and the Social Planner post it was sent to. Filter by format, status, folder_id or label_id; without status, archived entries are left out unless include_archived=true. Filters are applied reading on until the page is full (up to 400 read per call), so a page brings fewer than limit only with has_more true at that limit: keep following next_cursor. Requires view access to Content Studio.

Escopo: social_content_studio:read
Permissão: Ver o módulo
Tool do MCP: social_content_studio_bank_listNa superfície completa; na compacta, mb_execute_operation com id: "social_content_studio.bank.list".

Custo declarado: até 401 leituras e 0 escritas por chamada (contam na cota diária).

Parâmetros

limitintegerqueryopcional

How many items this page brings at most (see the maximum and the default in the schema).

Padrão: 50

cursorstringqueryopcional

The next_cursor of the previous page, exactly as it came (only for the same list and filters); without it, the first page.

formatenumqueryopcional

Only caption or video_script entries.

Valores: caption, video_script

statusenumqueryopcional

Only entries in this status: draft, used or archived.

Valores: draft, used, archived

include_archivedbooleanqueryopcional

Without status: also archived entries. Default false.

Padrão: false

folder_idstringqueryopcional

Only entries in this Content Library folder (folder_id of an entry).

label_idstringqueryopcional

Only entries with this Content Library label (label_ids of an entry).

Resposta

dataarray<object>

has_moreboolean

next_cursorstring

Erros

invalid_input unknown_field authentication_required scope_insufficient module_access_denied operation_not_found rate_limited quota_exceeded

Exemplo

curl "https://api.mb-suite.com/v1/social-content-studio/bank" \
  -H "Authorization: Bearer $MB_API_KEY"

Testar com a sua API key de teste

Com uma API key de teste o pedido vai sempre para a sua organização de prática: dados de exemplo que você pode reiniciar.

curl "https://api.mb-suite.com/v1/social-content-studio/bank" \
  -H "Authorization: Bearer $MB_TEST_KEY"