media_library

Get media library assets for a business. Assets are reusable image or video creatives at the business level, not Pins. Use this to browse, search, and filter assets from Media library.

Results are paginated. The default page_size is 25 and the maximum is 250. When more assets remain, the response includes a pagination_token; pass it back unchanged to fetch the next page. A request whose filters match nothing returns HTTP 200 with an empty assets array, not a 404.

Access requires the token user to be the business owner or to have a Business Access role with media library read access: Admin, Campaign Manager, Analyst, Profile Publisher, or Restricted Owner.

get/media_library/businesses/{business_id}/assets

Request

  • Base URL
    https://api.pinterest.com/v5
  • Auth
    OAuth 2
    Authorization codehttps://www.pinterest.com/oauth/
    Token URLhttps://api.pinterest.com/v5/oauth/token
    Scopesads:read

Path parameters

business_idstring required

Identifier of the business that owns the media library.

Query parameters

namesstring[]

List of asset names to filter the assets by.

asset_idsPinterestLibIntegerFormatType[]

List of asset IDs to filter the assets by.

asset_typesMediaLibraryAssetType[]

Filter by type of media library asset: IMAGE and/or VIDEO.

has_been_promotedboolean

Filter by whether an asset has been promoted. true returns only assets used in a Pin promotion; false returns only those that have not.

from_datestring

Filter assets created on or after this date (inclusive). Format: YYYY-MM-DD.

to_datestring

Filter assets created on or before this date (inclusive, through the end of that day). Format: YYYY-MM-DD.

tagsstring[]

List of tags to filter the assets by.

sort_order'ASC' | 'DESC'

Sort order for results by creation date.

Sort results by creation date. Pass ASC for ascending or DESC for descending.

page_sizeinteger

Maximum number of items to return in the response. Additional items are paginated. Use the pagination_token returned in the response to fetch the next page of results.

pagination_tokenstring

Pagination token for fetching the next page of results.

Response

The request has succeeded.

pagination_tokenstring

Pagination token for fetching the next page of results. Pass back unchanged as the pagination_token request parameter to fetch the next page. Omitted when there are no more results.

Example response

{
  "assets": [
    {
      "asset_id": "93820395728",
      "business_id": "950259727533690363",
      "name": "Test-name",
      "has_been_promoted": true,
      "tags": [
        "tag1",
        "tag2"
      ],
      "created_at": 1767225600000,
      "updated_at": 1767225600000,
      "image": {
        "sizes": {
          "original": {
            "width": 1200,
            "height": 1200,
            "url": "https://i.pinimg.com/originals/97/b2/b2/97b2b23da2f0c22ca5fbf577620f335a.jpg"
          },
          "236x": {
            "width": 1200,
            "height": 1200,
            "url": "https://i.pinimg.com/originals/97/b2/b2/97b2b23da2f0c22ca5fbf577620f335a.jpg"
          },
          "345x": {
            "width": 1200,
            "height": 1200,
            "url": "https://i.pinimg.com/originals/97/b2/b2/97b2b23da2f0c22ca5fbf577620f335a.jpg"
          }
        }
      }
    }
  ]
}

Changes