Core APIs
...
Results
Core Requests

Search

2min

Search Results

When making a request with the type parameter set to type=search BlueCart API will return search results from Walmart.

Search results are retrieved from the search results page on Walmart.

Search Results Page
Search Results Page


An example of the JSON object returned from a Search request is shown below:

JSON


BlueCart API returns the following properties for Search requests:

Property

Type

Description

search_results

array

An array of Search Result objects, containing each of the product results shown on the Search Results page. The Search Result object has the following properties:

  • position
  • number
  • The position of the result on the search results page.



Product Object The product object contains details about the product within the search result. The product object has the following properties:

  • title
  • string
  • The product title.



  • link
  • string
  • The URL to the product page.



  • description
  • string
  • The full-text description of the product.



  • brand
  • string
  • The brand name of the product, if shown.



  • item_id
  • string
  • The product item id. Pass the item_id into a type=product request to get product-level data about the product.



  • product_id
  • string
  • The product product id. This is a secondary ID for the product and isn't used when making type=product requests.



  • main_image
  • string
  • The primary image URL associated with the product.



  • images
  • array
  • An array of image URLs for the product.



  • department
  • string
  • The Walmart 'department' the product belongs to.



  • sponsored
  • boolean
  • Set to true when the search result is sponsored.



  • best_seller
  • boolean
  • Set to true when the search result is flagged as a Best Seller.



  • popular_pick
  • boolean
  • Set to true when the search result is flagged as a Popular Pick.



  • rollback
  • boolean
  • Set to true when the search result is flagged as a Rollback.



  • rating
  • number
  • The customer rating of this product, out of 5.



  • ratings_total
  • number
  • The total number of customer ratings this product has received.



  • variants
  • array
  • An array detailing the other variants of this product that are available. Contains an array of variant objects with the following properties: item_id , product_id , title , image and link .



Inventory Object The inventory object contains details about the product stock status and availability. The inventory object has the following properties:

  • in_stock
  • boolean
  • True/false determining whether the product is in stock, or not.



  • preorder
  • boolean
  • True/false determining whether the product is available for pre-order, or not.



Offers Object The offers object contains details about the product offers. The offers object has the following properties:

  • is_marketplace_item
  • boolean
  • True/false determining whether the primary offer is from a marketplace seller.



  • primary
  • object
  • Primary Offer Object The primary offer object contains details about the primary seller offer for the product and has the following properties:
    • 
      1. price
      2. number
      3. The price of the seller offer.
    • 
      1. is_minimum_price_for_variant
      2. boolean
      3. Set to true when the price shown is for the lowest priced variant of the product and not necessarily the price of the displayed variant. Indicated by Walmart showing a "From..." price.
    • 
      1. list_price
      2. number
      3. The un-discounted original list price of the product.
    • 
      1. savings_amount
      2. number
      3. The saving amount offered.
    • 
      1. max_price
      2. number
      3. The maximum price of the seller offer in the case of range pricing (min/max).
    • 
      1. min_price
      2. number
      3. The minimum price of the seller offer in the case of range pricing (min/max).
    • 
      1. currency_symbol
      2. string
      3. The currency symbol of the seller offer.
    • 
      1. id
      2. string
      3. The unique ID of the seller offer.
    • 
      1. seller
      2. object
      3. An object containing a name and id property being the name and ID of the seller.



Fulfillment Object The fulfillment object contains details about the product delivery and pickup options. The fulfillment object has the following properties: