Skip to content

Walmart

Walmart marketplace product data, including third-party seller offers. Delivered via partner data feeds in kwery's standard normalized shape.

Rolling out. Walmart is onboarding now and is not yet enabled by default on new accounts. Contact us to be enabled as it goes live — the API shape documented on this page is final and will not change.

Supported countries

country accepts: us

Walmart is served from walmart.com (US marketplace). Prices are in USD.

Keys

KeyValuesDescription
termFree textKeyword search.
idWalmart item IDDirect product lookup.
gtinEAN / UPC / GTINResolved to the matching product, then fetched.

Topics

TopicDescription
search (default)Product page, including the current buy-box.
productProduct-only fetch for a known Walmart item ID — used with key: id to skip the search leg.

Response

Returns the standard normalized content object (see Sources overview): name, url, currency, price_min / price_avg / price_max, offers_count, offers[], rating / rating_count, plus buybox. offers[] lists each seller's name, price, currency, shipping, and total — the landed price (price + shipping), also on the buybox object.

Offer fieldValuesMeaning
conditionnew · usedFrom Walmart's condition group on the offer. Pre-owned / refurbished listings are used.
availabilityin_stock · limited · out_of_stock · preorderWalmart's own per-offer status, unified. Also on buybox and on the product (content.availability). Out-of-stock offers stay in offers[] and offers_count but are excluded from price aggregates and the buybox — see Availability.
is_directtrue · falsetrue = sold by Walmart itself (first-party); false = a marketplace seller.
seller_typestandalone-shop · marketplace-shopThe same distinction as is_direct, in the cross-source vocabulary.
fulfillmentFC · MARKETPLACE · …Walmart's fulfilment channel for the offer, as reported (FC = Walmart fulfilment centre).
seller_id / seller_namestringWalmart's seller identifier and display name.

buybox is the lowest-priced offer we gathered, across all conditions — not the offer walmart.com shows by default. A used offer can win it, and the object has no condition field yet. To compare like for like, filter offers[] on condition, is_direct and total yourself; see Buy box semantics.

A product with no purchasable offer is still a product. When the GTIN or item ID resolves but Walmart lists no offer at that moment (out of stock, delisted seller, in-store only), the result is success: true with the product's identity fields, offers: [], offers_count: 0, buybox: null, null prices and availability: "out_of_stock" on the product. reason: "not found" is reserved for a GTIN or item ID that Walmart's catalogue does not know at all.

When a GTIN comes back not found, the product may still be on walmart.com under a barcode Walmart does not index. Fall back to key: term with the product title: the result is a list of catalogue items, each with its Walmart item ID and GTIN, and a follow-up key: id lookup returns the full offer list.

Example request

curl -s https://api.kwery.co/job \
  -H "Authorization: Bearer $KWERY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"source":"walmart","country":"us","key":"gtin","values":["00074471017201"]}'

Example response

Results are fetched with GET /job/{id}/download once the job is finished. This is a real response, captured live on 2026-09-14 — the exact payload a self-serve account receives for the request above. To keep this page readable, images shows the first 1 of 10 entries the download contains. Everything else is unedited — all 15 offers, including the Walmart first-party row (seller_type: "standalone-shop", is_direct: true) next to 14 marketplace sellers.

{
  "job_id": "6aa7b6bf7bc05d64edcd0950",
  "status": "finished",
  "results": [
    {
      "query": {
        "source": "walmart",
        "country": "us",
        "key": "gtin",
        "value": "00074471017201",
        "topic": "search",
        "max_pages": 1,
        "max_age": 1200
      },
      "content": {
        "product_id": "10543909",
        "name": "Cafe Bustelo, Espresso Style Dark Roast Ground Coffee, Vacuum Packed 10 oz Brick",
        "url": "https://www.walmart.com/ip/Cafe-Bustelo-Espresso-Style-Dark-Roast-Ground-Coffee-Vacuum-Packed-10-oz-Brick/10543909",
        "gtin": "00074471017201",
        "brand_name": "Café Bustelo",
        "currency": "USD",
        "images": [
          "https://i5.walmartimages.com/seo/Cafe-Bustelo-Espresso-Style-Dark-Roast-Ground-Coffee-Vacuum-Packed-10-oz-Brick_4c3fb1f7-6418-4a7f-a5d1-fe1f4f4731b0.eba0f86bcfee48952cc30ca52f971e30.jpeg"
        ],
        "image_url": "https://i5.walmartimages.com/seo/Cafe-Bustelo-Espresso-Style-Dark-Roast-Ground-Coffee-Vacuum-Packed-10-oz-Brick_4c3fb1f7-6418-4a7f-a5d1-fe1f4f4731b0.eba0f86bcfee48952cc30ca52f971e30.jpeg",
        "rating_count": 17148,
        "rating": 4.8,
        "buybox": {
          "price": 5.96,
          "currency": "USD",
          "seller_name": "Walmart.com",
          "seller_url": null,
          "seller_id": "F55CDC31AB754BB68FE0B39041159D63",
          "is_direct": true,
          "shipping": 0,
          "total": 5.96,
          "url": "https://www.walmart.com/ip/10543909"
        },
        "offers": [
          {
            "price": 5.96,
            "currency": "USD",
            "shipping": 0,
            "total": 5.96,
            "position": 1,
            "condition": "new",
            "seller_id": "F55CDC31AB754BB68FE0B39041159D63",
            "seller_name": "Walmart.com",
            "seller_url": null,
            "seller_type": "standalone-shop",
            "marketplace_name": "walmart",
            "is_direct": true,
            "fulfillment": "FC"
          },
          {
            "price": 6.37,
            "currency": "USD",
            "shipping": 5.97,
            "total": 12.34,
            "position": 2,
            "condition": "new",
            "seller_id": "D619AD04BB13441D9F8B8CF25E16B25F",
            "seller_name": "ElimsWell",
            "seller_url": null,
            "seller_type": "marketplace-shop",
            "marketplace_name": "walmart",
            "is_direct": false,
            "fulfillment": "MARKETPLACE"
          },
          {
            "price": 13,
            "currency": "USD",
            "shipping": 0,
            "total": 13,
            "position": 3,
            "condition": "new",
            "seller_id": "CEDBCFA6C88F4976BF2FB7E7ABAFE20F",
            "seller_name": "MAGO Retail",
            "seller_url": null,
            "seller_type": "marketplace-shop",
            "marketplace_name": "walmart",
            "is_direct": false,
            "fulfillment": "MARKETPLACE"
          },
          {
            "price": 13.52,
            "currency": "USD",
            "shipping": 0,
            "total": 13.52,
            "position": 4,
            "condition": "new",
            "seller_id": "4533EB7A388848738117FE5E4DE197A2",
            "seller_name": "The Factory Depot",
            "seller_url": null,
            "seller_type": "marketplace-shop",
            "marketplace_name": "walmart",
            "is_direct": false,
            "fulfillment": "MARKETPLACE"
          },
          {
            "price": 14.54,
            "currency": "USD",
            "shipping": 0,
            "total": 14.54,
            "position": 5,
            "condition": "new",
            "seller_id": "C93090C25EC84BC68527A802D0AAA11F",
            "seller_name": "Staples Business",
            "seller_url": null,
            "seller_type": "marketplace-shop",
            "marketplace_name": "walmart",
            "is_direct": false,
            "fulfillment": "MARKETPLACE"
          },
          {
            "price": 6.39,
            "currency": "USD",
            "shipping": 6.99,
            "total": 13.38,
            "position": 6,
            "condition": "new",
            "seller_id": "3C6DC802DA9C41D0ABBAB65C6B57D972",
            "seller_name": "Wise Advice 24/7",
            "seller_url": null,
            "seller_type": "marketplace-shop",
            "marketplace_name": "walmart",
            "is_direct": false,
            "fulfillment": "MARKETPLACE"
          },
          {
            "price": 14.85,
            "currency": "USD",
            "shipping": 0,
            "total": 14.85,
            "position": 7,
            "condition": "new",
            "seller_id": "E1ADDFF14BF24AB1BFA92414F725CA83",
            "seller_name": "EPS HOME Distributors",
            "seller_url": null,
            "seller_type": "marketplace-shop",
            "marketplace_name": "walmart",
            "is_direct": false,
            "fulfillment": "MARKETPLACE"
          },
          {
            "price": 15.5,
            "currency": "USD",
            "shipping": 0,
            "total": 15.5,
            "position": 8,
            "condition": "new",
            "seller_id": "F9A70C726B034D5AA570F9A74D90081C",
            "seller_name": "Top Shelf Goods.",
            "seller_url": null,
            "seller_type": "marketplace-shop",
            "marketplace_name": "walmart",
            "is_direct": false,
            "fulfillment": "MARKETPLACE"
          },
          {
            "price": 11.09,
            "currency": "USD",
            "shipping": 4.99,
            "total": 16.08,
            "position": 9,
            "condition": "new",
            "seller_id": "852C423FD4CE4C788117DF6541756F0D",
            "seller_name": "iHerb",
            "seller_url": null,
            "seller_type": "marketplace-shop",
            "marketplace_name": "walmart",
            "is_direct": false,
            "fulfillment": "MARKETPLACE"
          },
          {
            "price": 18.82,
            "currency": "USD",
            "shipping": 0,
            "total": 18.82,
            "position": 10,
            "condition": "new",
            "seller_id": "88618E696CD4480AA8659CF3C6A474E5",
            "seller_name": "Elta beauty supply ",
            "seller_url": null,
            "seller_type": "marketplace-shop",
            "marketplace_name": "walmart",
            "is_direct": false,
            "fulfillment": "FC"
          },
          {
            "price": 16.57,
            "currency": "USD",
            "shipping": 0,
            "total": 16.57,
            "position": 11,
            "condition": "new",
            "seller_id": "DA263BA5E28B4E6684EF4E635AF129AA",
            "seller_name": "CPO Commerce",
            "seller_url": null,
            "seller_type": "marketplace-shop",
            "marketplace_name": "walmart",
            "is_direct": false,
            "fulfillment": "MARKETPLACE"
          },
          {
            "price": 10.42,
            "currency": "USD",
            "shipping": 5.5,
            "total": 15.92,
            "position": 12,
            "condition": "new",
            "seller_id": "3476815470A04DED9A573BCB48BC8DF1",
            "seller_name": "Krrisak ",
            "seller_url": null,
            "seller_type": "marketplace-shop",
            "marketplace_name": "walmart",
            "is_direct": false,
            "fulfillment": "MARKETPLACE"
          },
          {
            "price": 14.97,
            "currency": "USD",
            "shipping": 2.99,
            "total": 17.96,
            "position": 13,
            "condition": "new",
            "seller_id": "D1C8BC5FF5A241428123BFA21BBEFBB6",
            "seller_name": "Best Kitchen Finds",
            "seller_url": null,
            "seller_type": "marketplace-shop",
            "marketplace_name": "walmart",
            "is_direct": false,
            "fulfillment": "MARKETPLACE"
          },
          {
            "price": 19.66,
            "currency": "USD",
            "shipping": 0,
            "total": 19.66,
            "position": 14,
            "condition": "new",
            "seller_id": "046DE69C531141428DDCE4BDFF75C914",
            "seller_name": "Office Depot LLC",
            "seller_url": null,
            "seller_type": "marketplace-shop",
            "marketplace_name": "walmart",
            "is_direct": false,
            "fulfillment": "MARKETPLACE"
          },
          {
            "price": 19.6,
            "currency": "USD",
            "shipping": 0,
            "total": 19.6,
            "position": 15,
            "condition": "new",
            "seller_id": "F8836612004C4C1AAF8072BC703EC387",
            "seller_name": "Jean Motivation LLC",
            "seller_url": null,
            "seller_type": "marketplace-shop",
            "marketplace_name": "walmart",
            "is_direct": false,
            "fulfillment": "MARKETPLACE"
          }
        ],
        "offers_count": 15,
        "price_min": 5.96,
        "price_max": 19.66,
        "price_avg": 13.42,
        "categories": [
          "Home Page/Food/Coffee/Ground Coffee"
        ]
      },
      "success": true,
      "updated_at": "2026-09-14T08:56:51.670Z",
      "trust": {
        "score": 0.83,
        "components": {
          "identity": 0.7,
          "completeness": 0.5,
          "price_integrity": 1,
          "offer_contamination": 1,
          "freshness": 1
        },
        "flagged_offers": []
      },
      "served_from": "live",
      "observed_at": "2026-09-14T08:56:51.666Z"
    }
  ]
}

The trust block is explained in Confidence score; served_from and observed_at in Audit & provenance.