BAbannerbear

Browse the public library

Changed on

Returns publications with visibility=public_library from every team, which is the same set the dashboard's template library shows. Legacy V3 publications are included and their uid carries a v3_ prefix; they install as V5 image templates, converted on the way in. Publications are user-owned resources that span workspaces, so there's no workspace-scoped listing — if you need your own publication UIDs, grab them from the dashboard at publish time and hit /publications/{uid} or /publications/{uid}/install directly.

get/publications

Request

  • Base URL
    https://api.bannerbear.com/v5
  • Auth
    HTTP bearer

Query parameters

pageinteger
kind'image' | 'animation'

Only publications of this kind. Omit for all of them.

category'announcements & news' | 'beauty & fashion' | 'business & finance' | 'education & coaching' | 'employee highlights' | 'events & weddings' | 'film & movies' | 'food & drinks' | 'gaming & e-sports' | 'home & real estate' | 'marketing & sales' | 'motivational quotes' | 'podcasts & publishing' | 'product showcase' | 'reviews & testimonials' | 'social media' | 'tech & crypto' | 'travel & nature'

Only publications in this category, matched against their tags. Comma-separate to match any of several.

qstring

Only publications whose name contains this text, case-insensitive.

Response

Paginated list of public library publications

uidstring

A v3_ prefix marks a legacy V3 publication. Pass the uid back verbatim, prefix included.

namestring
descriptionstring nullable
tagsstring[]
categoriesstring[]

Library categories this publication falls into, derived from its tags. These are the values the index endpoint's category filter takes.

visibility'unpublished' | 'published' | 'public_library'

unpublished, published, or public_library

previewstring uri nullable

Preview image or gif URL

install_countinteger

Number of times this publication has been installed into a workspace

template_kind'image' | 'animation'

Which kind of template this publication creates when installed

widthinteger nullable

Canvas width in pixels. Null for a workflow, which has no canvas of its own.

heightinteger nullable

Canvas height in pixels. Null for a workflow, which has no canvas of its own.

published_atstring date-time nullable
created_atstring date-time

Changes

  • 24e6335e0a47Revision changes
    • breaking

      removed the enum value workflow from the query request parameter kind

    • info

      removed the workflow enum value from the / response property for the response status

  • c439420dbe16Revision changes
    • warning

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

    • warning

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

    • info

      added the new optional query request parameter category

    • info

      added the new optional query request parameter kind

    • info

      added the new optional query request parameter q

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status