Walmart source guide

Walmart product data: items, offers, and availability

Map Walmart item identifiers, Marketplace sellers and fulfillment; compare condition, variants, price and destination availability with current terms and API boundaries.

A Walmart item and a Walmart offer answer different questions

A Walmart item page can connect product details with one or more seller offers and buyer-facing fulfillment choices. Keep catalog identity, the selected seller and condition, who fulfills the order, and the buyer context as linked fields. Walmart's seller labels help distinguish the seller from the fulfillment provider.

Scroll to compare →

A Walmart item and a Walmart offer answer different questions
Record layerFields to preserveComparison decision
Catalog itemPage URL and path identifier; title; brand; GTIN/UPC when shownMatch model, pack size, edition, and other item attributes before comparing offers.
Seller offerDisplayed seller; condition; offer price and currency; comparison price when shownA seller or condition change is an offer change, not automatically a product change.
FulfillmentSold-by and shipped-by labels; shipping, pickup, or delivery choiceKeep seller identity separate from the party that stores or ships the item.
ObservationSelected offer; destination or store; fulfillment choice; capture time and source URLInterpret price and availability only in the captured buyer context.

Keep Walmart and seller identifiers typed

Walmart public pages and Marketplace seller-catalog responses may expose different identifiers. Preserve each raw value with its field name and source. Do not assume the numeric portion of a page URL, Marketplace itemId, WPID, seller SKU, and GTIN/UPC are interchangeable.

Scroll to compare →

Keep Walmart and seller identifiers typed
IdentifierWhere it belongsMatching guidance
Public page path IDThe value embedded in a Walmart.com item URLKeep the complete URL and label the value as page-path context; do not silently map it to an API field.
Marketplace itemIdWalmart item data in an authorized Marketplace workflowPreserve the API field name, seller context, and source response.
WPIDA distinct Walmart product identifier documented in seller-catalog responsesKeep separate from itemId, GTIN, and seller SKU unless source documentation defines a relationship.
Seller SKUA seller's own catalog and inventory referenceScope it to the seller; another seller may use a different SKU for the same trade item.
GTIN or UPCA trade-item identifier when presentCheck pack quantity, model, edition, and condition before treating records as equivalent.

Variants and condition change what counts as a match

Walmart documents variants as separate items connected by variantGroupId and variant attributes. A shared group expresses a relationship; it does not make sizes, colors, pack counts, or seller offers interchangeable. Marketplace condition choices can depend on category and seller eligibility.

Scroll to compare →

Variants and condition change what counts as a match
Observed relationshipExample interpretationSafe comparison rule
Shared variantGroupIdTwo item records in one group have different size or color valuesCompare the same variant attributes; retain each variant's item ID and seller SKU.
Same base item, different conditionA New offer and a Pre-Owned or Restored offer appear for related merchandiseKeep condition at offer level and analyze the conditions separately.
Same item, different sellerA Walmart-sold offer and a Marketplace-seller offer refer to the same catalog itemPreserve each seller and fulfillment label as its own offer record.
Similar title, different pack or modelTwo descriptions look alike but quantities or model details differValidate GTIN/UPC and source attributes; title similarity alone is not a match.

Price and availability belong to a buyer context

Shipping, pickup, and delivery options can depend on the item and selected destination or store. Walmart's terms say price and availability are not confirmed until an order is placed. Treat a page as a time-bound observation, not a final checkout amount or exact inventory count.

Scroll to compare →

Price and availability belong to a buyer context
Context fieldWhy it mattersHow to compare
Destination or storeEligibility and availability can differ across addresses and storesCompare observations only when the location context is known.
Fulfillment methodShipping, pickup, and delivery are different buyer choicesRetain the selected method and avoid merging delivery estimates into item attributes.
Seller, condition, and currencyDifferent offers can have different prices and termsMatch the same seller and condition, or explicitly compare offers as a group.
Displayed price and capture timePrices and availability can change before checkoutRecord the display time and source URL, then verify again before a purchase decision.

A public page and a seller API serve different jobs

A public Walmart.com page presents buyer-facing item and selected-offer information. Marketplace APIs support authorized seller or approved solution-provider workflows for seller catalog and operations data, using OAuth and seller authorization. They are not anonymous access to a seller's private catalog.

Scroll to compare →

A public page and a seller API serve different jobs
SourceUseful forBoundary
Walmart.com item pageVisible item details, seller labels, condition, and buyer-facing fulfillment choicesIt does not establish the seller's complete catalog or exact inventory by itself.
Marketplace seller APIsAn authorized seller's catalog, prices, offers, and inventory operationsUse the documented seller authorization and keep seller SKU and any ship-node context.
Approved solution-provider workflowA seller-authorized integration acting for its Marketplace customersApproval and seller permission are part of the access model; do not infer access from a public page.

Read robots.txt together with the posted terms

The Walmart robots.txt copy reviewed October 8, 2026 has a wildcard group that disallows paths including /search and /api/. Walmart’s Terms of Use prohibit commercial use and systematic downloading or storage of Materials. They also prohibit specified automated or manual retrieval, scraping, data mining or gathering without express prior written consent. A robots rule does not grant access or reuse rights under the terms.

Scroll to compare →

Read robots.txt together with the posted terms
EvidenceWhat it saysWhat not to infer
robots.txtThe reviewed file lists crawler directives, including disallowed search and API pathsDo not infer permission for an unlisted path such as an item page.
Terms of Use section 2(b)The posted terms describe restrictions on commercial use, systematic downloads, and automated retrieval or data gatheringDo not treat visible page content as permission to collect, store, or redistribute it.
Authorized accessThe terms identify express prior written consent for the covered restricted usesA public URL, seller API documentation, or robots directive is not itself that consent.

Build a comparison record only for an authorized use

The right fields depend on the question. A cross-retailer price comparison needs item equivalence and buyer context; a Marketplace offer comparison needs seller and condition; variant analysis needs item-level attributes; seller operations use the seller's authorized catalog and inventory context. Keep the intended use and source rights with the record.

Scroll to compare →

Build a comparison record only for an authorized use
Research questionFields to retainUseful next step
Is this the same product elsewhere?GTIN/UPC when present; model and pack attributes; Walmart page URL; match confidenceValidate identity before interpreting a price difference.
How do offers differ?Item ID; seller; condition; fulfillment label; displayed price and currencyCompare offers separately from the catalog item.
How do variants relate?variantGroupId; item ID; option names and values; seller SKU when authorizedKeep each variant record distinct within the group.
What did a buyer see?Destination or store; fulfillment choice; timestamp; displayed values; source URLKeep the observation context and authorization basis attached.

Content reviewed 2026-10-07.