Content Feeds

The Content Management APIs allow you to upload an item, get the status of the item feed, get the item upload status, and upload rich media.

Item Upload Workflow

1. Upload item feed for your product. Use the Content Feed XSDs to build your XML request, then pass the payload using the Content Feed API, see POST /v3/feeds.
2. Check status of the item feed with Feed Status API, see GET /feeds.
3. Check status of the item upload with Feed Item Status API, see GET /feeds/{feedId}.
4. Upload rich media with Rich Media API, see  POST /v2/feeds.

Build your item XML request with the Content Feed XSD

You must use the relevant category XSD to build the XML payload. The ContentProduct XSD requires the use of a category-specific XSD for each ingested item. For example, if you were to take in a TV, the XML representing the TV would include the elements defined in the Electronics XSD as well as the ContentProduct XSD.

Extract the XSDs for the Content Feeds API from the directory below:

• Content Feed XSD files – Content_Feed_XSDs.zip
• Content Feed API XSD files – Content-API-XSDs.zip

Upload an item feed for your Product ID

You can upload an item feed for a specific Product ID.

Use the Feed Item Status API to get the feed status for a specific Product ID. You will need your Consumer ID and the Private Key to make this API call.

Upload rich media for your item

Rich media includes material such as videos, comparison tables, and view360 media which is item-specific.

After you ingest an item, you can update it to add Rich media via upload.

You can upload an item feed for a specific Product ID. Use the Feed Item Status API to get the feed status for a specific Product ID. You will need your Consumer ID and the Private Key to make this API call.

Call POST Content Feeds API

To upload your item feed, call the Content Feeds API.

For example, call POST /v3/feeds?feedType=Content_Product

API Response

Upon success, the API returns a Feed ID that you can use to track the feed status, and the item within that feed.

For details, including a sample response, see Content Feeds API.

What to do if you get data errors

In a data error occurs, resend the feed with the correct data. If a system error occurs, retry. If the issue persists, contact Walmart Partner Support.

Throttling Limits

While ingesting the feed, follow the throttling limits listed below. The limits reset every 60 minutes. You can process the feed at any interval within an hour. For example, you can take all 10 feeds within one minute or five minutes, or unequal gaps between the feeds. If you believe that you have fully optimized the throttling limits, contact Walmart and request a higher throttling threshold. Any violations in the thresholds may result in a 429 error – “Too Many Requests.”

Feed Type	Operation	Max Feeds per Hour	Max File Size per Feed	No. Items per Feed	uid
Items	Bulk Upload	10	25MB	5000	0.4655665442681509

To display the item status for a specific feed ID, call GET Feed status.

Specify values for the the feedId, offset, and limit parameters.

For example: https://marketplace.walmartapis.com/v3/feeds?feedId={feedId}&offset={offset}&limit={limit}

API Response

The API returns the status of the feed as well as the status of the items as part of the feed. A processed feed can have the following status:

• RECEIVED – The feed has been received.
• PROCESSED – The feed has been processed.
• INPROGRESS – The feed ingestion has not been completed.
• ERROR – The feed has resulted in error.

If a request returns a feed status INPROGRESS, continue to call until a different status is retrieved. The recommended calling intervals are as follows: Item Feeds – 15 minutes, 1 hour, 2 hours, and every 4 hours.

Since requests to get a feedItems status are throttled, the recommended intervals described above may have to be adjusted for your specific setup.

To display the status of all items for a specific feed ID, call GET Feed item status API.

Specify values for the feedId, includeDetails, limit, and offset parameters.

For example: https://marketplace.walmartapis.com/v3/feeds/{feedId}?includeDetails={includeDetails}&limit={limit}&offset={offset}

After you ingest an item, you can update it to add Rich media via upload.

Note: To avoid errors, do not upload new items with rich media, it will cause item ingestion to fail.

To upload rich media:

1. Extract the Rich Media API XSDs:
   Rich Media API XSDs
2. Make sure the item ingestion process completes successfully.
3. Call POST /v2/feeds?feedType=item with the rich media content for ingested items.

Payload Details

The payload contains a number of Modules available according to the nature of the Rich Content:

• Marketing Content
• Product Tour
• View 360
• Videos
• Customer Review Video
• Documents
• Comparison Table
• Expert Reviews
• Miscellaneous

Please see the descriptions of each module below and the sample xml for Rich Media API module attributes. Refer to the XSD’s linked above for more information about the payload construction.

Rich Media Module Details

Module URL/Link Guidelines

All URL Links are required to use HTTPS protocol. Links should not require user sign-in. Make sure the HTTPS response header has Content-Type as the asset’s MimeType. Examples are:

• pdf: application/pdf
• jpg: image/jpeg
• png: image/png
• mp4: video/mp4

Name	Description	Guidelines	Limitations
Marketing Content	An iframe HTML container for displaying manufacturer-provided style or interactive content	Put self-contained HTML, complete with required JavaScript and CSS. Do not put text as images. Do not escape the HTML (do not URL Encode)	One iframe container per item SKU
Product Tour	An iframe HTML container for displaying a product tour	Put self-contained HTML, complete with required JavaScript and CSS. Do not link to another page. Do not escape the HTML (do not URL Encode)	N/A
View 360	An HTML container for 360-degree product view	Put self-contained HTML, complete with required JavaScript and CSS. Do not link to another page. Do not escape the HTML (do not URL Encode)	N/A
Videos	This module ingests data for CDN-hosted product videos	Provide the URL link to the raw .mp4 or .pdf, using HTTPS protocol for content hosted through a CDN (no YouTube, DropBox, Google Drive, etc.)	The URL should follow the URL guidelines above. See individual property limitations below.
Title	Video Title		Max 56 characters
Description	Video Description		Max 256 characters
Language	Video Language		en-US
Video Format	Video File Format		mp4
Thumbnail Dimensions	Dimensions of the thumbnail image for the video		Min: 120 x 67, Max: 240 x 240
Customer Review Video	This module ingests data for customer review videos	The URL should follow the URL guidelines above. The video should not have click-through links or in-video advertising	Title length: 56 chars. Description Length: 256 chars. Tags: min 0, max 100
Documents	Product-related documents such as user manuals, FAQ, etc.	Link to the pdf document. Refer to the URL guidelines above. The documents should not auto-download. For the thumbnail, if no document-specific image is present, use a generic icon (such as PDF icon)	50 documents per SKU. See individual property details below
File Type	The document filetype (PDF only)		PDF
Title	The document title		max 56 characters
Thumbnail	The document thumbnail image	Use a generic icon (PDF icon) if item-specific thumbnail is not available	Min: 120 x 67, Max: 240 x 240
Poster	A poster-style document		Width range: 480 to 720
Comparison Table	A module for comparing the product to another item	Refer to the XSD’s for constructing the tables	There must be multiple product-info attributes to compare. 500 features and 50 product columns are permissible
Expert Reviews	An HTML container to hold expert reviews	Put self-contained HTML, complete with required JavaScript and CSS. Do not link to another page. Do not escape the HTML (do not URL Encode)	Maximum: 100 reviews
Miscellaneous	Used only with special instruction	Use this only when instructed to do so	Attribute name: 500 chars, Description: 50,000 chars