Overview
This endpoint retrieves Walmart listings managed through Feedvisor.
Common API behavior such as authentication, pagination, response envelope, and query operators is documented in:
JSON API – Listings (Overview & Common Concepts)
This article documents the Walmart-supported fields and indicates whether each field is:
writable – supported as persistable
read-only – returned by the API but not persistable
Endpoint
GET /external/{accountId}/v2/listingsExample
https://api-gateway.feedvisor.com/external/1234/v2/listings
Walmart Field Support
Writable Fields
These fields are persistable.
| Field | Access | Description |
|---|---|---|
| brand | writable | Product brand |
| repricerStrategy | writable | Repricing strategy |
| repriced | writable | Indicates whether the item is repriced |
| floorPrice | writable | Repricing floor price |
| ceilingPrice | writable | Repricing ceiling price |
| repricingTargetOosd | writable | Repricing target OOSD setting |
| repricingTargetVelocity | writable | Repricing target velocity |
| repricerMethod | writable | Repricing method |
| fixedPrice | writable | Fixed listing price |
| referenceAccountId | writable | Reference account ID |
| referenceSKU | writable | Reference SKU |
| referenceASIN | writable | Reference ASIN |
| referenceFulfillmentChannel | writable | Reference fulfillment channel |
| referencePriceChange | writable | Reference price change |
| cohort | writable | Cohort |
| vat | writable | VAT |
| shippingCost | writable | Shipping cost |
| markup | writable | Markup |
| additionalSellingCosts | writable | Additional selling costs |
| comment | writable | Listing comment |
| cost | writable | Product cost |
| isbn | writable | ISBN |
| ean | writable | EAN |
| mpn | writable | Manufacturer part number |
| vendorName | writable | Vendor name |
| vendorPartNumber | writable | Vendor part number |
| leadTime | writable | Lead time |
| unitsInPacks | writable | Units in pack |
| minQuantityForOrder | writable | Minimum quantity for order |
| parentSKU | writable | Parent SKU |
| daysOfCoverage | writable | Days of coverage |
| isReplenishable | writable | Replenishable flag |
| warehouseInventory | writable | Warehouse inventory |
Read-Only Fields
These fields are returned by the API but are not persistable.
| Field | Access | Description |
|---|---|---|
| buyBoxEligible | read-only | Whether the item is Buy Box eligible |
| buyBoxItemPrice | read-only | Buy Box item price |
| buyBoxShippingPrice | read-only | Buy Box shipping price |
| currency | read-only | Currency code |
| fulfillmentType | read-only | Fulfillment type |
| gtin | read-only | Global trade item number |
| itemId | read-only | Walmart item ID |
| itemPageUrl | read-only | Walmart item page URL |
| lifecycleStatus | read-only | Listing lifecycle status |
| maximumSellerAllowedPrice | read-only | Maximum seller allowed price |
| minimumSellerAllowedPrice | read-only | Minimum seller allowed price |
| msrp | read-only | MSRP |
| offerEndDate | read-only | Offer end date |
| offerStartDate | read-only | Offer start date |
| price | read-only | Current listing price |
| primaryCategoryPath | read-only | Primary category path |
| primaryImageUrl | read-only | Primary image URL |
| primaryVariant | read-only | Indicates primary variant |
| productCategory | read-only | Product category |
| productName | read-only | Product name |
| productTaxCode | read-only | Product tax code |
| publishStatus | read-only | Publish status |
| reviewsCount | read-only | Review count |
| searchable | read-only | Searchable indicator |
| shelfName | read-only | Shelf name |
| shipMethods | read-only | Shipping methods |
| shippingWeight | read-only | Shipping weight |
| shippingWeightUnit | read-only | Shipping weight unit |
| sku | read-only | Seller SKU |
| statusChangeReason | read-only | Status change reason |
| upc | read-only | UPC |
| variantGroupId | read-only | Variant group ID |
| variantGroupingAttributes | read-only | Variant grouping attributes |
| variantGroupingValues | read-only | Variant grouping values |
| wfsSalesRestriction | read-only | Walmart Fulfillment Services sales restriction |
| wpid | read-only | Walmart product ID |
| inventoryAvailToSellQuantity | read-only | Inventory available to sell quantity |
| wfsAvailableUnits | read-only | Walmart Fulfillment Services available units |
| condition | read-only | Item condition |
| dependentPriceCalculationType | read-only | Dependent price calculation type |
| fulfillmentChannel | read-only | Fulfillment channel |
| quantity | read-only | Quantity |
Example Request
GET /external/1234/v2/listings?sku=[BW:WM]&brand=[EQCS:Acme]&price=[GTE:20]
Authorization: Bearer YOUR_TOKEN
Example Response
{
"totalItemsCount": 2,
"totalPagesCount": 1,
"page": 0,
"items": [
{
"sku": "WM-4321",
"itemId": "123456789",
"productName": "Acme Blender",
"brand": "Acme",
"price": 29.99,
"currency": "USD",
"publishStatus": "PUBLISHED",
"inventoryAvailToSellQuantity": 12,
"condition": "NEW",
"floorPrice": 25.00,
"ceilingPrice": 35.00,
"cost": 14.20
},
{
"sku": "WM-1234",
"itemId": "987654321",
"productName": "Acme Toaster",
"brand": "Acme",
"price": 24.99,
"currency": "USD",
"publishStatus": "PUBLISHED",
"inventoryAvailToSellQuantity": 6,
"condition": "NEW",
"floorPrice": 20.00,
"ceilingPrice": 30.00,
"cost": 11.75
}
]
}Notes
Access semantics
writable means the field is persistable
read-only means the field may be returned by the API but is not persistable
Filtering
Walmart listings use the same filtering syntax and query operators described in the common Listings API article.
Response shape
The response envelope is the same as other listings endpoints:
totalItemsCounttotalPagesCountpageitems
Comments
0 comments
Please sign in to leave a comment.