Get all assets

Overview

Use the Get all assets API to retrieve product video assets from your seller catalog. Assets may have been created through Seller Center Media Library or programmatically through the Rich Media APIs.

Use this API to search for existing assets, review linked items, and retrieve information about existing rich media assets, including the asset hash, a unique identifier for each rich media asset.

Keep a copy of the richMediaAsset object returned in the response. Reuse this object when associating additional catalog items with an existing rich media asset or delinking GTIN associations.

Asset sources

Assets returned by this API may originate from:

• Seller Center Media Library
• Rich Media APIs

The response includes the source of each asset to help identify how the asset was created.

Use cases

• Retrieve all rich media assets in your catalog
• Search for assets associated with specific GTINs
• Find video assets by title
• Review item associations and publication status for rich media assets

Reference guide

This guide explains how to retrieve rich media assets from your catalog and filter results using asset metadata and item associations.

For complete endpoint details, parameters, and response definitions, refer to the Rich Media API Reference.

Endpoint

GET /v3/items/assets

Request sample

curl --request GET \ --url 'https://marketplace.walmartapis.com/v3/items/assets?page=1&limit=25&richMediaType=VIDEO' \ --header 'WM_SEC.ACCESS_TOKEN: <ACCESS_TOKEN>' \ --header 'WM_QOS.CORRELATION_ID: <UUID>' \ --header 'WM_SVC.NAME: Walmart Marketplace' \ --header 'accept: application/json'

Modify your request

You can customize the response using one or more query parameters.

Filter by rich media type

1. Set the richMediaType parameter to VIDEO.
2. Submit the request to return video assets.

Filter by linked GTIN

1. Set the linkedGtins parameter.
2. Provide one or more GTINs as a comma-separated list.
3. Submit the request to return assets associated with the specified GTINs.

Example:

?linkedGtins=00716999676446,07815386164856

Filter by title

1. Set the richMediaTitle parameter.
2. Provide the title or partial title of the asset.
3. Submit the request to return matching assets.

Example:

?richMediaTitle=Product Demo

Control pagination

1. Set the page parameter to specify which page of results to retrieve.
2. Set the limit parameter to control the number of assets returned per page.
3. Continue adjusting these values to navigate through larger result sets.

Example:

?page=2&limit=25

Response sample

{ "status": "OK", "payload": [ { "hash": "8db4c830c098c4d5f7feefac7788ee23eb84c250", "mediaTitle": "test-06-03-02", "mediaType": "VIDEO", "source": "MARKETPLACE_PARTNER", "items": [ { "itemId": "5040004491", "gtin": "06703211947310", "mediaType": "VIDEO", "locale": "en_US", "status": "PUBLISHED" } ], "richMediaAsset": { "richMediaVideoAssetUrl": "https://i5.walmartimages.com/video/abc123.mp4", "richMediaVideoTitle": "test-06-03-02", "richMediaVideoCategory": "Product Overview" } } ], "totalRecords": 1, "headerAttributes": {}, "errors": []
}

Results

After a successful request, the response returns matching rich media assets, associated GTINs, publication status, source, and asset information, including the asset hash, a unique identifier for each rich media asset.

If no assets match the search criteria, the response returns an empty payload and a totalRecords value of 0.

Next steps

• Manage rich media assets
• Monitor feed processing
• Rich media management