Get all assets
Changed onGet 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.
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
Identifier of the business that owns the media library.
Query parameters
List of asset names to filter the assets by.
List of asset IDs to filter the assets by.
Filter by type of media library asset: IMAGE and/or VIDEO.
Filter by whether an asset has been promoted. true returns only assets used in a Pin promotion; false returns only those that have not.
Filter assets created on or after this date (inclusive). Format: YYYY-MM-DD.
Filter assets created on or before this date (inclusive, through the end of that day). Format: YYYY-MM-DD.
List of tags to filter the assets by.
Sort order for results by creation date.
Sort results by creation date. Pass ASC for ascending or DESC for descending.
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 token for fetching the next page of results.
Response
The request has succeeded.
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
- info
endpoint added
- info