media_library

Get a single media library asset for a business. Assets are reusable image or video creatives at the business level, not Pins. Use this to retrieve one asset from Media library.

The asset must belong to the owner business in the path. The response is an IMAGE or VIDEO asset.

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/{asset_id}

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.

asset_idstring required

Identifier of the asset to retrieve.

Response

The request has succeeded.

OR

Example response

{
  "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