Get all assets

Overview

Use the Get All Assets API to retrieve rich media assets from your seller catalog. Rich media assets include videos and 360-spin images that 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 videos or 360-spin image 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.

2. Specify either:

   • VIDEO
   • IMAGES360

3. Submit the request to return only assets of the selected type.

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": []
}

For 360-spin image assets, the mediaTitle value in the response corresponds to the richMedia360SpinTitle submitted when the asset was created.

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