media_library
Get an asset
Changed onGet 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 URLhttps://api.pinterest.com/v5
- AuthOAuth 2Authorization codehttps://www.pinterest.com/oauth/Token URLhttps://api.pinterest.com/v5/oauth/tokenScopesads: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.
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
- info
endpoint added
- info