Core APIs
...
Results
Customer Feedback

Reviews

2min

Reviews Results

When making a request with the type parameter set to type=reviews BlueCart API will return all Customer Reviews for the product specified in the item_id or url parameter.

Reviews are retrieved from the customer reviews page for a single product on Walmart USA or Walmart Canada.

Customer Reviews Page
Customer Reviews Page


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

JSON


BlueCart API returns the following properties for Reviews requests:

Property

Type

Description

reviews

array

An array of Review objects, containing each of the Customer Reviews shown on the Customer Reviews page. The Review object has the following properties:

  • id
  • string
  • The unique, Walmart-assigned, ID of the customer review. This can be used by your app to flag whether you have previously processed this review on a prior request.



  • title
  • string
  • The title of the review.



  • body
  • string
  • The body text of the review.



  • date
  • string
  • The date of the review.



  • rating
  • number
  • The rating, out of 5, given by the reviewer.



  • positive_feedback
  • number
  • The number of times this review has been given positive feedback.



  • negative_feedback
  • number
  • The number of times this review has been given negative feedback.



  • source
  • object
  • Review Source Object The source object contains details about the source and author of the review.
    • 
      1. is_external_source
      2. boolean
      3. True/false whether the review was sourced from an external third-party.
    • 
      1. external_source
      2. string
      3. The name of the external third-party, if the review was sourced from an external third-party.
    • 
      1. author_name
      2. string
      3. The username of the author of the review.
    • 
      1. author_id
      2. string
      3. The ID of the author of the review.
    • 
      1. syndication_source
      2. string
      3. The syndication source for this review, if the review is syndicated.
    • 
      1. verified_purchase
      2. boolean
      3. Whether this reviewer is an verified purchaser of the product.

most_helpful_positive_review

object

The most helpful positive customer review. Not returned on walmart.ca requests.

The properties of the most_helpful_positive_review object are identical to the Review object above.

most_helpful_negative_review

object

The most helpful negative customer review. Not returned on walmart.ca requests.

The properties of the most_helpful_negative_review object are identical to the Review object above.

product

object

An object containing details of the product (in so far as those details are shown on the Customer Reviews page). For full product details you should issue a request with type=product to retrieve details from the product page . Not returned on walmart.ca requests.

  • title
  • string
  • The product name.

summary

object

An object containing a summary of all reviews for the product, as shown at the top-left of the Customer Reviews page.

  • rating
  • number
  • The overall rating of the product, out of 5 (not returned on walmart.ca requests).



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



  • recommended_percentage
  • number
  • The percentage of reviews that recommend the product (not returned on walmart.ca requests).



  • rating_breakdown
  • object
  • Rating Breakdown Object Contains details how many of each star rating value the product has received (not returned on walmart.ca requests).
    • 
      1. one_star
      2. number
      3. The number of one-star ratings received.
    • 
      1. two_star
      2. number
      3. The number of two-star ratings received.
    • 
      1. three_star
      2. number
      3. The number of three-star ratings received.
    • 
      1. four_star
      2. number
      3. The number of four-star ratings received.
    • 
      1. five_star
      2. number
      3. The number of five-star ratings received.

pagination

object

Pagination Object An object containing details of the current search results page and the total number of pages that are available. To paginate you should specify the page number in your request's page parameter .

  • current
  • object
  • Current Page Object Contains details of the current page
    • 
      1. page
      2. number
      3. The current page number.
    • 
      1. link
      2. string
      3. The current page URL (not returned on walmart.ca requests as Walmart.ca does not allow directly addressing a page of reviews).



  • next
  • object
  • Next Page Object Contains details of the next page
    • 
      1. page
      2. number
      3. The next page number.
    • 
      1. link
      2. string
      3. The next page URL (not returned on walmart.ca requests as Walmart.ca does not allow directly addressing a page of reviews).



  • other_pages
  • array
  • Other Pages Array Contains details of other availale pages, each object in the array contains the following properties:
    • 
      1. page
      2. number
      3. The page number.
    • 
      1. link
      2. string
      3. The URL to the page (not returned on walmart.ca requests as Walmart.ca does not allow directly addressing a page of reviews).



  • last_page
  • object
  • Last Page Object Contains details of the last page
    • 
      1. page
      2. number
      3. The last page number.
    • 
      1. link
      2. string
      3. The last page URL (not returned on walmart.ca requests as Walmart.ca does not allow directly addressing a page of reviews).



  • total_pages
  • number
  • The total number of pages available


Next Steps      Reviews Parameters

Updated 06 Aug 2024
Did this page help you?