Sams' Product Reviews API
With a GET request to the /api/getter/?platform="samsclub_reviews" endpoint, we can scrape customer reviews for any product on Sams' Club's online store in real-time.
Example
Here's an example showcasing how you can scrape customer reviews for any product on SamsClub.com using its product URL and the page number we're interested in scraping reviews from.
The results are sorted by recency, so the most recent reviews are on page 1.
1 | |
Note
When using curl, it is necessary to add the option -L to get the data back. This is because in some cases our server responds with a 301 and curl does not follow the redirect by default.
Query Parameters
As you can see in the example below, our endpoint needs the following query parameters:
Review Query
url
Required
Parameter defines the URL of the product listing for which you want to query reviews. Value of this parameter must be encoded.
page
Optional
Parameter defines the page number from which you want to query reviews. The default value is 1.
Other Required Parameters
platform
Required
Parameter specifies the scraping engine you want to invoke. For the Sams' Club Reviews API, the value should be samsclub_reviews.
api_key
Required
Parameter defines your account's token. Get your API key for free here.
Note
The value of the query parameter url must be URL or percent encoded. If you're using Python, this can be done with the function urlencode.
Results
Each request returns up to 10 reviews. The response will include the following attirbutes for each review present in the response:
| Attributes Returned | Data Type | Information Represented |
|---|---|---|
| id | string | Retailer ID of the review |
| date | string | Date when review was published |
| rating | int | Rating by reviewer |
| review_title | string | Review title by reviewer |
| review_text | string | Review's text content |
| review_url | string | URL of the review on SamsClub.com |
| author_name | string | Reviewer's name |
| meta_data | dict | Dict containing meta data like whether purchase is verified and user recommends product. For e.g. verified purchase status |
| lang_code | string | Country level language of review content |
Response Example
Each request returns up to 10 results. Here's the response you can expect for the request showcased above:
{
"success": true,
"url": "https://www.samsclub.com/p/pure-life-purified-water/prod21002929",
"page": 1,
"total_results": 1617,
"no_of_pages": 54,
"result_count": 30,
"reviews": [
{
"id": "333888967",
"date": "2024-01-29",
"rating": 4,
"review_title": "You have to try it!",
"review_text": "Great water for the size & money!",
"review_url": null,
"author_name": "D Strang",
"author_url": null,
"meta_data": {
"author_id": "43240774c81e0d282e7812adfebb55e6cba8768f9b2190d770c03176fc6f8070f0f2c00e0a6b26aec2e1601a9c12c582",
"is_syndicated": false,
"is_recommended": true,
"source": "samsclub.com"
},
"lang_code": "en_US",
"location": null
},
{
"id": "333877460",
"date": "2024-01-28",
"rating": 5,
"review_title": "Trusted brand",
"review_text": "I love the taste",
"review_url": null,
"author_name": "Jac",
"author_url": null,
"meta_data": {
"author_id": "47f80fba63ec05f6c029e4078b7645aa7a71d6922f6a8ed4b24be604ace9e87e70c98470e871d0a0eeaf9ce23c47e973",
"is_syndicated": false,
"is_recommended": true,
"source": "samsclub.com"
},
"lang_code": "en_US",
"location": null
},
{
"id": "333851310",
"date": "2024-01-28",
"rating": 4,
"review_title": "Fresh taste",
"review_text": "Good fresh tasting water. Only issue is the lids are hard to open.",
"review_url": null,
"author_name": "Angiebaby",
"author_url": null,
"meta_data": {
"author_id": "5c5a8faa-e966-4d2e-ad46-042f0ba7668f",
"is_syndicated": false,
"is_recommended": true,
"source": "samsclub.com"
},
"lang_code": "en_US",
"location": null
},
{
"id": "333840310",
"date": "2024-01-28",
"rating": 5,
"review_title": "Tired of wearing my water!!!",
"review_text": "I was tired of spilling my water every time I opened the bottle. Back then I was buying MM water. Then I went up in bottled water by a couple of other brands that also had flaimsy bottles. Then I came across Pure Life, I can open the bottles without wearing the water. The bottle is just right. I have been a loyal customer ever since. Thank you Pure Life for making a cheap bottle!!!!!!",
"review_url": null,
"author_name": "Brenda Tyler",
"author_url": null,
"meta_data": {
"author_id": "87484049196685ca361e12dbdfb73c8891f96d829d0208e3faf134f8b542c358a5e3141d1aaf2ec941d6e56a12506c4a",
"is_syndicated": false,
"is_recommended": true,
"source": "samsclub.com"
},
"lang_code": "en_US",
"location": null
},
{
"id": "333800356",
"date": "2024-01-28",
"rating": 5,
"review_title": "Great value for the money",
"review_text": "Water great value",
"review_url": null,
"author_name": "Kayla",
"author_url": null,
"meta_data": {
"author_id": "1fba494a3bc0ad95efe3653b8d8c14f07a4a63b8c69b48c52008a803a4b57737dd77032504bd3bc47015d20e59f9e132",
"is_syndicated": false,
"is_recommended": true,
"source": "samsclub.com"
},
"lang_code": "en_US",
"location": null
},
{
"id": "333708285",
"date": "2024-01-27",
"rating": 5,
"review_title": "Good product",
"review_text": "Good tasting for less cost. I always recycle so I wouldn’t mind a bit more thickness in the container",
"review_url": null,
"author_name": "Mac89",
"author_url": null,
"meta_data": {
"author_id": "7e511cb5-a66c-4737-b525-8b437df3c9ab",
"is_syndicated": false,
"is_recommended": true,
"source": "samsclub.com"
},
"lang_code": "en_US",
"location": null
},
{
"id": "333590789",
"date": "2024-01-26",
"rating": 5,
"review_title": "Perfect Pick up",
"review_text": "Perfect pick up",
"review_url": null,
"author_name": "Renee",
"author_url": null,
"meta_data": {
"author_id": "913431114127c5e0da7d1c6de3a3a4230ba2468d5c54781837b9570511eaa5280c2046199da5adf6e4bb7a096bf4ee9f",
"is_syndicated": false,
"is_recommended": true,
"source": "samsclub.com"
},
"lang_code": "en_US",
"location": null
},
{
"id": "333577769",
"date": "2024-01-26",
"rating": 5,
"review_title": "Great Deal",
"review_text": "By far the best deal on bottled water.",
"review_url": null,
"author_name": "Lo",
"author_url": null,
"meta_data": {
"author_id": "6bd8e35c-f733-46f7-a44d-0460cbdc5f33",
"is_syndicated": false,
"is_recommended": null,
"source": "samsclub.com"
},
"lang_code": "en_US",
"location": null
},
{
"id": "269971544",
"date": "2024-01-25",
"rating": 5,
"review_title": "My favorite water brand",
"review_text": "Pure life water is delicious. I’m a big water drinker and I’ve tried so many different brands and pure life has definitely been my favorite. There’s no funny plastic taste or iron-y taste. It’s straight up refreshing and clean. I keep a couple 24 packs here in the office for everyday drink.",
"review_url": null,
"author_name": "miggs13",
"author_url": null,
"meta_data": {
"author_id": "inf12390531",
"is_syndicated": true,
"is_recommended": null,
"source": "influenster.com"
},
"lang_code": "en_US",
"location": null
},
{
"id": "333429658",
"date": "2024-01-25",
"rating": 5,
"review_title": "Greed",
"review_text": "Good water for the price. It is a shame that mankind has put a price on water. When it was free from the begin.",
"review_url": null,
"author_name": "Louis",
"author_url": null,
"meta_data": {
"author_id": "9c724f7d-0424-4b7a-b110-c78c6316954a",
"is_syndicated": false,
"is_recommended": true,
"source": "samsclub.com"
},
"lang_code": "en_US",
"location": null
},
{
"id": "333461866",
"date": "2024-01-25",
"rating": 5,
"review_title": "Taste great",
"review_text": "I just love the taste",
"review_url": null,
"author_name": "Ritaboo",
"author_url": null,
"meta_data": {
"author_id": "f27badde-bffc-46b0-b2cb-a17b23e2a72d",
"is_syndicated": false,
"is_recommended": true,
"source": "samsclub.com"
},
"lang_code": "en_US",
"location": null
},
{
"id": "333364771",
"date": "2024-01-24",
"rating": 5,
"review_title": "Our favorite water",
"review_text": "Purchased many times",
"review_url": null,
"author_name": "JoM",
"author_url": null,
"meta_data": {
"author_id": "c23a1918-4acb-425d-80f7-0ea0b4e81e0d",
"is_syndicated": false,
"is_recommended": true,
"source": "samsclub.com"
},
"lang_code": "en_US",
"location": null
},
{
"id": "333348625",
"date": "2024-01-24",
"rating": 5,
"review_title": "Genial",
"review_text": "Genial",
"review_url": null,
"author_name": "Karla",
"author_url": null,
"meta_data": {
"author_id": "b394d89d-f6e2-41cf-a812-5c27270b7b5e",
"is_syndicated": false,
"is_recommended": true,
"source": "samsclub.com"
},
"lang_code": "en_US",
"location": null
},
{
"id": "333344466",
"date": "2024-01-24",
"rating": 5,
"review_title": "Good value",
"review_text": "Largest quantity for the least cost. Good water.",
"review_url": null,
"author_name": "ScoutMomma2",
"author_url": null,
"meta_data": {
"author_id": "1f6434a6-b2f4-44fc-9bad-e657a3642708",
"is_syndicated": false,
"is_recommended": true,
"source": "samsclub.com"
},
"lang_code": "en_US",
"location": null
},
{
"id": "333334825",
"date": "2024-01-23",
"rating": 5,
"review_title": "Value pack water",
"review_text": "Great value",
"review_url": null,
"author_name": "Diana",
"author_url": null,
"meta_data": {
"author_id": "39b7bbe5adb3c2b1322038d0ac49aa9af26e27b522710fc01d2ba2b777e2bfe8edd193e40a768cff895103ae64d580a9",
"is_syndicated": false,
"is_recommended": true,
"source": "samsclub.com"
},
"lang_code": "en_US",
"location": null
},
{
"id": "333200056",
"date": "2024-01-22",
"rating": 4,
"review_title": "Water",
"review_text": "Water taste good",
"review_url": null,
"author_name": "Mom of many",
"author_url": null,
"meta_data": {
"author_id": "4b1b38a0-b045-4214-8211-91cd9515d293",
"is_syndicated": false,
"is_recommended": true,
"source": "samsclub.com"
},
"lang_code": "en_US",
"location": null
},
{
"id": "333160759",
"date": "2024-01-22",
"rating": 5,
"review_title": "Water",
"review_text": "Great water",
"review_url": null,
"author_name": "Katherine",
"author_url": null,
"meta_data": {
"author_id": "3d54a13adb76b6a54b8f30e3454d50ff3c8142cb6f6e68df49155e1be49794a52640631843b3084bf4fc457cba13c8c2",
"is_syndicated": false,
"is_recommended": true,
"source": "samsclub.com"
},
"lang_code": "en_US",
"location": null
},
{
"id": "333146332",
"date": "2024-01-22",
"rating": 5,
"review_title": "Purified Water",
"review_text": "As advertised",
"review_url": null,
"author_name": "Jjab",
"author_url": null,
"meta_data": {
"author_id": "cfcbf199-408d-4605-87d6-6ab98d8f9cdd",
"is_syndicated": false,
"is_recommended": true,
"source": "samsclub.com"
},
"lang_code": "en_US",
"location": null
},
{
"id": "333129337",
"date": "2024-01-22",
"rating": 5,
"review_title": "Water",
"review_text": "Just water",
"review_url": null,
"author_name": "Bob",
"author_url": null,
"meta_data": {
"author_id": "84a0c89d-bd56-4206-b3ce-5128aaf9b22b",
"is_syndicated": false,
"is_recommended": true,
"source": "samsclub.com"
},
"lang_code": "en_US",
"location": null
},
{
"id": "332997787",
"date": "2024-01-20",
"rating": 5,
"review_title": "Water bottles are too thin except this one",
"review_text": "Bottles are thicker",
"review_url": null,
"author_name": "Kathie 1313",
"author_url": null,
"meta_data": {
"author_id": "3d4f8a36-c62c-45c6-89e7-12c15eea85fa",
"is_syndicated": false,
"is_recommended": true,
"source": "samsclub.com"
},
"lang_code": "en_US",
"location": null
},
{
"id": "332800513",
"date": "2024-01-19",
"rating": 5,
"review_title": "Good value",
"review_text": "Good value",
"review_url": null,
"author_name": "RAH",
"author_url": null,
"meta_data": {
"author_id": "b33c0047-b823-4330-8c6e-199557eabfd6",
"is_syndicated": false,
"is_recommended": true,
"source": "samsclub.com"
},
"lang_code": "en_US",
"location": null
},
{
"id": "332786007",
"date": "2024-01-19",
"rating": 5,
"review_title": "don't like it? try doing without it a few days",
"review_text": "Now if it could just carry itself from the store to the car and the car to the house...",
"review_url": null,
"author_name": "Michael John",
"author_url": null,
"meta_data": {
"author_id": "732fa352-22c7-46cb-974b-169804faa075",
"is_syndicated": false,
"is_recommended": null,
"source": "samsclub.com"
},
"lang_code": "en_US",
"location": null
},
{
"id": "332781718",
"date": "2024-01-19",
"rating": 5,
"review_title": "Pure life water",
"review_text": "Having someone’s else handle the carrying of case is worth shipping",
"review_url": null,
"author_name": "Angie",
"author_url": null,
"meta_data": {
"author_id": "f607ca3e6158e7eb1dcbd6173f8519a5b087d83ce6bebef089e2c7f77e31c4a8f92843e52d55fcea81eb66428ab19038",
"is_syndicated": false,
"is_recommended": true,
"source": "samsclub.com"
},
"lang_code": "en_US",
"location": null
},
{
"id": "332738086",
"date": "2024-01-19",
"rating": 5,
"review_title": "Refreshing",
"review_text": "Nothing like pure life",
"review_url": null,
"author_name": "Melody",
"author_url": null,
"meta_data": {
"author_id": "5e01c3fb06cd65da0773b66d8123084d006631e595363445a6f5b3067ae385566df74580a401a1b017bb2fb95e671a0c",
"is_syndicated": false,
"is_recommended": true,
"source": "samsclub.com"
},
"lang_code": "en_US",
"location": null
},
{
"id": "332693426",
"date": "2024-01-18",
"rating": 5,
"review_title": "Love having water on hard for in the car & workout",
"review_text": "Water on hand",
"review_url": null,
"author_name": "Lc",
"author_url": null,
"meta_data": {
"author_id": "a08430b02a806d6100fa50a00403e6ce11be08b1c0c90fb21cad50fe6788320c8a60326d01f258f262bab0a25e170de7",
"is_syndicated": false,
"is_recommended": true,
"source": "samsclub.com"
},
"lang_code": "en_US",
"location": null
},
{
"id": "332627465",
"date": "2024-01-18",
"rating": 5,
"review_title": "5 star",
"review_text": "Good taste.",
"review_url": null,
"author_name": "Maxwell",
"author_url": null,
"meta_data": {
"author_id": "9e1b2e8e-f402-4c65-b99d-9f94dee06d79",
"is_syndicated": false,
"is_recommended": true,
"source": "samsclub.com"
},
"lang_code": "en_US",
"location": null
},
{
"id": "332566378",
"date": "2024-01-17",
"rating": 1,
"review_title": "they say drink water but now its not good for you?",
"review_text": "sad to hear there is small plastic particles in the water i drink",
"review_url": null,
"author_name": "Christine",
"author_url": null,
"meta_data": {
"author_id": "c826b4f0-a985-4c02-9c17-3814f56f3a96",
"is_syndicated": false,
"is_recommended": null,
"source": "samsclub.com"
},
"lang_code": "en_US",
"location": null
},
{
"id": "332538206",
"date": "2024-01-17",
"rating": 5,
"review_title": "Pure Refreshing Experience",
"review_text": "Only water that gives a clean, fresh and healthy drinking experience .",
"review_url": null,
"author_name": "Rachael",
"author_url": null,
"meta_data": {
"author_id": "81e98a66-9460-487d-a88c-05dfd26ee42f",
"is_syndicated": false,
"is_recommended": null,
"source": "samsclub.com"
},
"lang_code": "en_US",
"location": null
},
{
"id": "332529588",
"date": "2024-01-17",
"rating": 5,
"review_title": "Good",
"review_text": "Good",
"review_url": null,
"author_name": "Good",
"author_url": null,
"meta_data": {
"author_id": "6393a32c-e8a3-4c3a-8b8d-e694c826732f",
"is_syndicated": false,
"is_recommended": true,
"source": "samsclub.com"
},
"lang_code": "en_US",
"location": null
},
{
"id": "332467051",
"date": "2024-01-16",
"rating": 4,
"review_title": "Bad deal unless you pick up at store",
"review_text": "I ordered these to be shipped to my home, as a plus member I was told I got free shipping, but I was charged $27.00 shipping!",
"review_url": null,
"author_name": "Connie",
"author_url": null,
"meta_data": {
"author_id": "4550354153b5d41bc2a551fa499a58bcfe2cb48d3545bd8424b4cb1f819f421247a70ca3c3601659a87f7087a2c9151a",
"is_syndicated": false,
"is_recommended": false,
"source": "samsclub.com"
},
"lang_code": "en_US",
"location": null
}
],
"meta_data": {},
"remaining_credits": 708128
}
Request Cost
Each request returns up to 10 reviews and costs 10 credits.
Support
If the response doesn't include the data you need, or if you have any question or feedback, please write to us at support@unwrangle.com