Logo SearchApi

Walmart Reviews API Documentation

GET   /api/v1/search?engine=walmart_reviews

The Walmart Reviews API provides developers with access to all reviews for a given Walmart product. You can search for reviews, filter by various criteria, and retrieve detailed review information including rating, summary, and more.

API Parameters

Search Query

  • Name
    product_id
    Required
    Required
    Description

    Parameter defines the Walmart product ID you want to get reviews for.

Review Filters

  • Name
    rating
    Required
    Optional
    Description

    Filter reviews by rating. Supported values: 1, 2, 3, 4, 5.

  • Name
    verified_purchases_only
    Required
    Optional
    Description

    Filter to show only verified purchase reviews. Supported values: true, false.

  • Name
    aspect_id
    Required
    Optional
    Description

    Filter reviews by aspect. You can find the list of aspects in the aspects array in the response. The aspect ID is the id field in the aspects array.

  • Name
    sort_by
    Required
    Optional
    Description

    Sort reviews by different criteria. Supported values:

    • relevance Default
    • newest
    • helpful
    • highest_rating
    • lowest_rating

Pagination

  • Name
    page
    Required
    Optional
    Description

    Parameter defines the page number of results. Must be an integer starting from 1.

Engine

  • Name
    engine
    Required
    Required
    Description

    Parameter defines an engine that will be used to retrieve real-time data. It must be set to walmart_reviews.

API key

  • Name
    api_key
    Required
    Required
    Description

    The api_key authenticates your requests. Use it as a query parameter (https://www.searchapi.io/api/v1/search?api_key=YOUR_API_KEY) or in the Authorization header (Bearer YOUR_API_KEY).

Zero Data Retention

  • Name
    zero_retention
    Enterprise Only
    Enterprise Only
    Required
    Optional
    Description

    Set this parameter to true to disable all logging and persistent storage. No request parameters, HTML, or JSON responses are stored or logged. Suitable for high-compliance use cases. Debugging and support may be limited while enabled.

API Examples

Full Response

Full Response
GET
https://www.searchapi.io/api/v1/search?engine=walmart_reviews&product_id=2068427086
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "walmart_reviews",
  "product_id": "2068427086"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "search_metadata": {
    "id": "search_lLDb6vP7p7aJuMPoA5jqWZw2",
    "status": "Success",
    "created_at": "2025-12-11T02:29:45Z",
    "request_time_taken": 2.6,
    "parsing_time_taken": 0.02,
    "total_time_taken": 5.22,
    "request_url": "https://www.walmart.com/reviews/product/2068427086",
    "html_url": "https://www.searchapi.io/api/v1/searches/search_lLDb6vP7p7aJuMPoA5jqWZw2.html",
    "json_url": "https://www.searchapi.io/api/v1/searches/search_lLDb6vP7p7aJuMPoA5jqWZw2"
  },
  "search_parameters": {
    "engine": "walmart_reviews",
    "product_id": "2068427086"
  },
  "search_information": {
    "sorting_by": "relevancy"
  },
  "product": {
    "title": "Restored Apple iPhone 14 Pro Max - Carrier Unlocked - 128GB Space Black (Refurbished)",
    "link": "https://www.walmart.com/ip/Restored-Apple-iPhone-14-Pro-Max-Carrier-Unlocked-128GB-Space-Black-MQ8N3LL-A-Refurbished/2068427086?conditionGroupCode=2",
    "rating": 3.9,
    "reviews_count": 2609,
    "reviews_with_text_count": 1103,
    "reviews_histogram": {
      "1": {
        "count": 441,
        "percentage": 17,
        "with_text_count": 197
      },
     ...
    },
    "recommended_percentage": 78,
    "media_count": 48
  },
  "aspect_stats": [
    {
      "id": "16040",
      "name": "Scratch Condition",
      "count": 46
    }
  ],
  "reviews": {
    "customer_reviews": [
      {
        "id": "254171236",
        "reference_id": "533f1cd2-f17f-5964-9351-b4b26b8496e0",
        "title": "Perfect phone, looks brand new",
        "text": "Bought this for my daughter birthday and it was in perfect condition not a scratch or dent on it, looks brand new. Came with an apple charger too. I bought a second one from a different vendor on walmart for my other daughter and it came with a cheap charger and had significant scratches. If your looking for a iphone 8 Definitely use this vendor!",
        "rating": 5,
        "date": "3/1/2021",
        "iso_date": "2021-03-01",
        "user_id": "eeb6bb92f153a9a85ee59ecc40414169c8b7178f7e6baa1b060b84f0dcc43b8731f2d857e8ade0304fe3c5a96af88439",
        "user_name": "Kenneth",
        "positive_feedback": 3,
        "negative_feedback": 0,
        "badges": [
          "Verified Purchase"
        ],
        "item_id": "911939854",
        "item_name": "Restored Apple iPhone 8 - Fully Unlocked - 128 GB Gold (Refurbished)"
      }
    ],
    "top_positive_review": {
      "id": "254171236",
      "reference_id": "533f1cd2-f17f-5964-9351-b4b26b8496e0",
      "title": "Perfect phone, looks brand new",
      "text": "Bought this for my daughter birthday and it was in perfect condition not a scratch or dent on it, looks brand new. Came with an apple charger too. I bought a second one from a different vendor on walmart for my other daughter and it came with a cheap charger and had significant scratches. If your looking for a iphone 8 Definitely use this vendor!",
      "rating": 5,
      "date": "3/1/2021",
      "iso_date": "2021-03-01",
      "user_id": "eeb6bb92f153a9a85ee59ecc40414169c8b7178f7e6baa1b060b84f0dcc43b8731f2d857e8ade0304fe3c5a96af88439",
      "user_name": "Kenneth",
      "positive_feedback": 3,
      "negative_feedback": 0,
      "badges": [
        "Verified Purchase"
      ],
      "item_id": "911939854",
      "item_name": "Restored Apple iPhone 8 - Fully Unlocked - 128 GB Gold (Refurbished)"
    },
    "top_negative_review": {
      "id": "401071628",
      "reference_id": "f2948282-e15c-53ab-b876-4bed94b9343c",
      "text": "Phone would not work took it to multiple stores in town to find out if they could help me, I've reached out to seller with no response, I am reaching out one more time before\nI contact Walmart to get refund",
      "rating": 1,
      "date": "10/13/2025",
      "iso_date": "2025-10-13",
      "user_id": "4b745aecbd08e0ede8167b574cf94018b43e9554e09e082d3fdd1d2fe734d13abff27bf9e6de41a1131d47cf01a241ae",
      "user_name": "Cynthia",
      "positive_feedback": 0,
      "negative_feedback": 0,
      "badges": [
        "Verified Purchase"
      ],
      "seller_name": "Supplytronics",
      "item_id": "1467527398",
      "item_name": "Restored Apple iPhone 14 Pro Max - Carrier Unlocked - 256GB Deep Purple (Refurbished)",
      "item_details": [
        {
          "name": "hard_drive_capacity",
          "value": "1 TB"
        },
        ...
      ],
      "fulfilled_by": "Seller"
    }
  },
  "ai_summary": {
    "title": "Mixed reviews for phone's design, battery, and performance",
    "summary": "Customers praise the phone's appearance, describing it as new and beautiful, and consider it an ideal option for kids. However, they express disappointment with the battery, citing low capacity, rapid drainage, and short lifespan. The screen quality receives mixed reviews, while the price is generally considered affordable and reasonable. Unfortunately, charging issues, such as slow charging and faulty chargers, contribute to overall dissatisfaction.",
    "aspect_spans": [
      {
        "id": 6049,
        "name": "battery",
        "start": 165,
        "end": 171,
        "sentiment": "negative"
      },
      ...
    ]
  },
  "bullet_review_summary": {
    "pros": [
      {
        "id": "582",
        "name": "appearance",
        "text": "Minimal scratches appearance",
        "polarity": "Positive",
        "summary": "Phone looks like it's in new condition with these."
      },
      ...
    ],
    "neutral": [
      {
        "id": "16040",
        "name": "scratches",
        "text": "Surface integrity",
        "polarity": "Neutral",
        "summary": "Can be scratch-resistant, but may also show noticeable scratches."
      }
    ],
    "cons": [
      {
        "id": "6051",
        "name": "charging",
        "text": "Short battery life",
        "polarity": "Negative",
        "summary": "Battery drains quickly and may not hold a full charge."
      }
    ]
  },
  "product_media": [
    {
      "id": "a291bfd7-c3de-4eee-b9f4-f9f85080ea0d",
      "review_id": "7fc1960f-02cb-5689-baaa-6e6d541c726f",
      "type": "IMAGE",
      "normal_url": "https://i5.walmartimages.com/dfw/6e29e393-2ec3/k2-_c05a2afe-6192-436c-aecd-d714ef99aa46.v1.jpg",
      "thumbnail_url": "https://i5.walmartimages.com/dfw/6e29e393-2ec3/k2-_c05a2afe-6192-436c-aecd-d714ef99aa46.v1.jpg?odnWidth=150&odnHeight=150&odnBg=ffffff",
      "rating": 5
    },
    ...
  ],
  "pagination": {
    "current": 1,
    "next": "https://www.walmart.com/reviews/product/2068427086?page=2",
    "total_pages": 111
  }
}

Search with Sorting

Search with Sorting
GET
https://www.searchapi.io/api/v1/search?engine=walmart_reviews&product_id=5025668230&sort_by=newest
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "walmart_reviews",
  "product_id": "5025668230",
  "sort_by": "newest"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "search_metadata": {
    "id": "search_ZD40AeqmorqVs6Agkyw25lR8",
    "status": "Success",
    "created_at": "2025-12-11T02:28:36Z",
    "request_time_taken": 4.16,
    "parsing_time_taken": 0.02,
    "total_time_taken": 4.18,
    "request_url": "https://www.walmart.com/reviews/product/5025668230?sort=submission-desc",
    "html_url": "https://www.searchapi.io/api/v1/searches/search_ZD40AeqmorqVs6Agkyw25lR8.html",
    "json_url": "https://www.searchapi.io/api/v1/searches/search_ZD40AeqmorqVs6Agkyw25lR8"
  },
  "search_parameters": {
    "engine": "walmart_reviews",
    "product_id": "5025668230",
    "sort_by": "newest"
  },
  "search_information": {
    "sorting_by": "submission-desc"
  },
  "product": {
    "title": "Tripcomp Luggage 3 Piece Set,Suitcase with Spinner Wheels Hardside Lightweight Luggage 20in24in28in.(Blue)",
    "link": "https://www.walmart.com/ip/Tripcomp-Luggage-3-Piece-Set-Suitcase-Set-with-Spinner-Wheels-Hardside-Lightweight-Luggage-Set-20in24in28in-Blue/5025668230",
    "rating": 4.6,
    "reviews_count": 5851,
    "reviews_with_text_count": 2702,
    "reviews_histogram": {
      "1": {
        "count": 290,
        "percentage": 5,
        "with_text_count": 151
      },
     ...
    },
    "recommended_percentage": 87,
    "media_count": 130
  },
  "aspect_stats": [
    {
      "id": "48",
      "name": "Value For Money",
      "count": 6
    },
    ...
  ],
  "reviews": {
    "customer_reviews": [
      {
        "id": "407489942",
        "reference_id": "6574f073-cffd-583d-a236-582fd8978f5c",
        "text": "Value for the money case is not hard shell has some give to it.",
        "rating": 4,
        "date": "12/7/2025",
        "iso_date": "2025-12-07",
        "user_id": "32577d2a17aa024498a52841233d1bb30be4537def16a3fa1208b8da863a005abff27bf9e6de41a1131d47cf01a241ae",
        "user_name": "brendan",
        "positive_feedback": 0,
        "negative_feedback": 0,
        "badges": [
          "Verified Purchase"
        ],
        "seller_name": "Tripcomp",
        "item_id": "5025720784",
        "item_name": "Tripcomp Hardside Luggage Set 3-Piece Set(21/25/29) Lightweight Suitcase 4-Wheeled Suitcase Set(Blue)",
        "item_details": [
          {
            "name": "Color",
            "value": "Gray"
          },
          {
            "name": "Pattern",
            "value": "Style A"
          }
        ],
        "fulfilled_by": "Walmart"
      },
      ...
    ],
    "top_positive_review": {
      "id": "406213638",
      "reference_id": "dabe9366-fe51-50e5-ada0-0882dc20fe0f",
      "text": "I'm on my second set of these bags , not because the first set fell apart or cracked , I just wanted to switch colors. I donated the first set I got and upgraded to the deep teal green. For the price these beat Amazon basics and they are way more fashionable and very durable. You stick with darker colors and it hides the marks left by being tossed around by airline employees.",
      "rating": 5,
      "date": "11/27/2025",
      "iso_date": "2025-11-27",
      "user_id": "152504c5f24648660ae99abd0516a86da793a1f636b0d17686dc364e680ad7e0d243761b7d538fc0221864e329145b81",
      "positive_feedback": 0,
      "negative_feedback": 0,
      "badges": [
        "Verified Purchase"
      ],
      "seller_name": "Tripcomp",
      "item_id": "5025668230",
      "item_name": "Tripcomp Hardside Luggage Set 3-Piece Set(21/25/29) Lightweight Suitcase 4-Wheeled Suitcase Set(Blue)",
      "item_details": [
        {
          "name": "actual_color",
          "value": "Blue"
        },
        ...
      ],
      "fulfilled_by": "Walmart"
    },
    "top_negative_review": {
      "id": "406060991",
      "reference_id": "5300a38e-6b8a-5766-a7d8-b67a34fdd0b0",
      "text": "Looked great online, really liked the color and that you get three bags for the price. There is also a good locking system for the zippers. \n\nHowever the bags are cheap plastic. It was so bad that when you lift the handle on top, it would pull up just the part of the bag under the handle. I would not trust using these on one trip. It's apparent they would break just being taken on and off the plane. Returned.",
      "rating": 1,
      "date": "11/26/2025",
      "iso_date": "2025-11-26",
      "user_id": "9ecf6f8dd91d5f188f6946147285b8f0a0e1013f9afe558da5685c2da4db4aa5bff27bf9e6de41a1131d47cf01a241ae",
      "user_name": "Dianne",
      "positive_feedback": 0,
      "negative_feedback": 0,
      "badges": [
        "Verified Purchase"
      ],
      "seller_name": "Tripcomp",
      "item_id": "5025668230",
      "item_name": "Tripcomp Hardside Luggage Set 3-Piece Set(21/25/29) Lightweight Suitcase 4-Wheeled Suitcase Set(Blue)",
      "item_details": [
        {
          "name": "actual_color",
          "value": "Blue"
        }
      ],
      "fulfilled_by": "Walmart"
    }
  },
  "product_media": [
    {
      "id": "bf656ce0-356a-4d78-8415-a75d431098ce",
      "review_id": "f13c9cd2-4641-5347-8878-7a0a22aa70ce",
      "type": "IMAGE",
      "normal_url": "https://i5.walmartimages.com/dfw/6e29e393-7ca0/k2-_a4697a7d-4090-42a5-b505-722da2a66709.v1.jpg",
      "thumbnail_url": "https://i5.walmartimages.com/dfw/6e29e393-7ca0/k2-_a4697a7d-4090-42a5-b505-722da2a66709.v1.jpg?odnWidth=150&odnHeight=150&odnBg=ffffff",
      "rating": 5
    },
    ...
  ],
  "pagination": {
    "current": 1,
    "next": "https://www.walmart.com/reviews/product/5025668230?sort=submission-desc&page=2",
    "total_pages": 271
  }
}

Search with Aspect Filter

Search with Aspect Filter
GET
https://www.searchapi.io/api/v1/search?aspect_id=798&engine=walmart_reviews&product_id=1462477529
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "walmart_reviews",
  "product_id": "1462477529",
  "aspect_id": "798"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "search_metadata": {
    "id": "search_OxE2l6wMgOJVS9Ap9PbYq4Kv",
    "status": "Success",
    "created_at": "2025-12-11T02:27:22Z",
    "request_time_taken": 0.99,
    "parsing_time_taken": 0.01,
    "total_time_taken": 1.98,
    "request_url": "https://www.walmart.com/reviews/product/1462477529?aspect=798",
    "html_url": "https://www.searchapi.io/api/v1/searches/search_OxE2l6wMgOJVS9Ap9PbYq4Kv.html",
    "json_url": "https://www.searchapi.io/api/v1/searches/search_OxE2l6wMgOJVS9Ap9PbYq4Kv"
  },
  "search_parameters": {
    "engine": "walmart_reviews",
    "product_id": "1462477529",
    "aspect_id": "798"
  },
  "search_information": {
    "sorting_by": "relevancy",
    "active_aspect": {
      "id": "798",
      "name": "Handle",
      "count": 27
    },
    "positive_aspect_count": 12,
    "negative_aspect_count": 15
  },
  "product": {
    "title": "AQUAPHILE 30oz Stainless Steel Insulated Coffee Mug with Handle, Double Walled Vacuum Travel Cup with Lid & Straw, Reusable Thermal Coffee Cup, Portable Coffee Tumbler, Rubine red",
    "link": "https://www.walmart.com/ip/AQUAPHILE-30oz-Stainless-Steel-Insulated-Coffee-Mug-Handle-Double-Walled-Vacuum-Travel-Cup-Lid-Straw-Reusable-Thermal-Coffee-Cup-Portable-Coffee-Tumb/1462477529",
    "rating": 4.5,
    "reviews_count": 566,
    "reviews_with_text_count": 221,
    "reviews_histogram": {
      "1": {
        "count": 24,
        "percentage": 4,
        "with_text_count": 14
      },
      ...
    },
    "recommended_percentage": 76,
    "media_count": 5
  },
  "aspect_stats": [
    {
      "id": "798",
      "name": "Handle",
      "count": 27
    },
    ...
  ],
  "reviews": {
    "customer_reviews": [
      {
        "id": "403248993",
        "reference_id": "6346c693-51e1-5e53-9331-1c64c89ff975",
        "text": "To whom it may concern I dislike the handle material to thin and very uncomfortable when holding, the lid very cheaply made and it doesn't keep hot beverages long enough to enjoy, I am stuck with something that I dislike on the other hand I purchased a 40oz cup first now that cup holds up to the word.",
        "rating": 3,
        "date": "11/2/2025",
        "iso_date": "2025-11-02",
        "user_id": "9a5d70505fc46805a79b9189a3669ffe366474860b81df95b1b0221f2b205fdc4058485aee2be8d02fd05482d0aed32b",
        "positive_feedback": 0,
        "negative_feedback": 0,
        "badges": [
          "Verified Purchase"
        ],
        "seller_name": "Home Deals",
        "item_id": "1052900318",
        "item_name": "AQUAPHILE 30oz Stainless Steel Insulated Coffee Mug with Handle, Double Walled Vacuum Travel Cup with Lid & Straw, Reusable Thermal Coffee Cup, Portable Coffee Tumbler,Navy",
        "item_details": [
          {
            "name": "Volume capacity",
            "value": "30 oz"
          },
          ...
        ],
        "fulfilled_by": "Walmart"
      },
      ...
    ],
    "top_positive_review": {
      "id": "399756641",
      "reference_id": "ea5d98e5-2845-52c5-ad98-0c03664a91ed",
      "text": "i love this cup. it keeps the ice frozen for a day or two.\nthe design is not good for the need to sit straight up. it is bigger and wider on the top and very small and slender on the bottom. It falls over from this poor design of being top heavy.  when it falls over, the liquid spills out",
      "rating": 5,
      "date": "9/29/2025",
      "iso_date": "2025-09-29",
      "user_id": "b56998bd7a1b4253edb9dd9c8e6a50a2398f01ae7129096fbfc1a5753b912e61daedcd6334679b60d94f6ce7abcee2ad",
      "user_name": "Nicole",
      "positive_feedback": 0,
      "negative_feedback": 0,
      "badges": [
        "Verified Purchase"
      ],
      "seller_name": "Home Deals",
      "item_id": "2465503716",
      "item_name": "AQUAPHILE 30oz Stainless Steel Insulated Coffee Mug with Handle, Double Walled Vacuum Travel Cup with Lid & Straw, Reusable Thermal Coffee Cup, Portable Coffee Tumbler,Navy",
      "item_details": [
        {
          "name": "volume_capacity",
          "value": "30 oz"
        },
        ...
      ],
      "fulfilled_by": "Walmart"
    },
    "top_negative_review": {
      "id": "360513215",
      "reference_id": "774322dc-c76e-5826-bbd3-895189aedfd0",
      "text": "your items are missed handled produce is terrible bags are always ripped I don't know how many times we've had products that have been mishandled damaged and getting someone on the phone at your company is almost impossible to alleviate the issue I don't know how many times yogurts are destroyed bread is squashed the people who pull off your shelves don't look at dates don't look at freshness they just grab and throw they have bad attitudes when they deliver items and 90% of the time when I order items they say that they're in stock they are not in stock they're out of stock I think the management at Walmart is a disgrace I think your items are terribly mishandled I don't think the people who pulled the items even care whether the produce is rotten they grab what's over on top they throw it in the cart there's lack of effort lack of respect on disabled so I have little recourse to go anywhere else other than you but if I wasn't disabled I would never shop at Walmart for food and that even counts for dog food I think your manager should be fired I think somebody who cares more about their job and not doing their job should be let go immediately you want to blame people for stealing products off of your shelves for why stores are closing I think you need to look in the infrastructure first",
      "rating": 1,
      "date": "10/17/2024",
      "iso_date": "2024-10-17",
      "user_id": "683c124cbd3415552f4d49bcb4ffe6669db2c14288f4421e814738087a9408535bac11f71cb44c0a3eaee4ad7a9b7d8d",
      "user_name": "Bella",
      "positive_feedback": 0,
      "negative_feedback": 0,
      "badges": [
        "Verified Purchase"
      ],
      "seller_name": "Home Deals",
      "item_id": "1052900318",
      "item_name": "AQUAPHILE 30oz Stainless Steel Insulated Coffee Mug with Handle, Double Walled Vacuum Travel Cup with Lid & Straw, Reusable Thermal Coffee Cup, Portable Coffee Tumbler,Navy",
      "item_details": [
        {
          "name": "size",
          "value": "30 Oz"
        },
        ...
      ],
      "fulfilled_by": "Walmart"
    }
  },
  "ai_summary": {
    "title": "Exceptional value and performance in a portable cooler",
    "summary": "Customers praise the product's exceptional value, citing its great pricing, durability, and performance, which exceeds expectations. The size is ideal for travel and home use, with a lightweight design and perfect shape. While some report issues with the lid's quality and handle's comfort, the product's ability to keep ice for several hours is a notable feature. Overall, customers consider it a worthwhile investment, offering fabulous value for the price.",
    "aspect_spans": [
      {
        "id": 266,
        "name": "lid's quality",
        "start": 255,
        "end": 267,
        "sentiment": "neutral"
      },
      ...
    ]
  },
  "bullet_review_summary": {
    "pros": [
      {
        "id": "5948",
        "name": "cold",
        "text": "Retains cold temperature",
        "polarity": "Positive",
        "summary": "Keeps drinks cold for several hours."
      },
      ...
    ],
    "neutral": [
      {
        "id": "266",
        "name": "lid",
        "text": "Closure system",
        "polarity": "Neutral",
        "summary": "Can be secure and versatile, but also prone to breaking."
      },
      ...
    ]
  },
  "product_media": [
    {
      "id": "dd0000c7-7f15-476c-8f02-94fe56f99be9",
      "review_id": "d4744e8a-c245-503b-bbd5-a87d09d110a1",
      "type": "IMAGE",
      "normal_url": "https://i5.walmartimages.com/dfw/6e29e393-bf4f/k2-_9ffc05f4-7662-486f-92f8-2155eb73978c.v1.jpg",
      "thumbnail_url": "https://i5.walmartimages.com/dfw/6e29e393-bf4f/k2-_9ffc05f4-7662-486f-92f8-2155eb73978c.v1.jpg?odnWidth=150&odnHeight=150&odnBg=ffffff",
      "rating": 5
    },
    ...
  ],
  "pagination": {
    "current": 1,
    "next": "https://www.walmart.com/reviews/product/1462477529?aspect=798&page=2",
    "total_pages": 3
  }
}