curl -X GET 'https://api.parse.bot/scraper/4176e737-7ff0-494b-9f52-80843e3d64f6/search_products?query=laptop' \ -H 'X-API-Key: $PARSE_API_KEY'
Keyword search over the Sam's Club catalog. Returns one page of up to 45 product tiles (item_id, name, price, was_price/savings, unit price, rating, availability, image, URL) plus paging info: page, max_page, has_more and total_results as reported by the site. Pagination is caller-controlled through page (1-based; omitted = page 1); a page beyond max_page returns an empty items list. sort orders results (omitted = best match) and min_price/max_price filter by price in USD. Sponsored tiles are included and flagged with sponsored=true. brand is frequently null on tiles; use get_product for the full record. One round trip per call.
| Param | Type | Description |
|---|---|---|
| page | integer | 1-based results page. Compare with max_page / has_more in the response to continue. |
| sort | string | Result ordering. |
| queryrequired | string | Free-text search term, e.g. a product name or keyword. |
| max_price | number | Maximum price in USD; items priced above it are excluded. |
| min_price | number | Minimum price in USD; items priced below it are excluded. |
{
"type": "object",
"fields": {
"page": "page returned (integer)",
"sort": "sort applied",
"items": "array of product tiles: item_id (string, feeds get_product), product_id, name, brand, price (number), price_display, was_price, savings, unit_price, price_range, sales_unit, rating, review_count, availability, out_of_stock, sponsored, variant_count, image, description (HTML), url",
"title": "site heading for the result set",
"category": "null for keyword searches (populated by browse_category)",
"has_more": "true when page < max_page",
"max_page": "last available page for this query (integer)",
"page_size": "tiles per page (45)",
"breadcrumbs": "empty for keyword searches (populated by browse_category)",
"total_results": "site-reported total matching items (integer, may differ slightly from tiles returned)"
},
"sample": {
"data": {
"page": 1,
"sort": "best_match",
"items": [
{
"url": "https://www.samsclub.com/ip/ASUS-VivoBook-14-FHD-Laptop-Intel-Core-5-8GB-RAM-512GB-SSD-Windows-11-includes-ASUS-Backpack/17470818757?classType=VARIANT",
"name": "ASUS VivoBook 14\" FHD Laptop | Intel Core 5 | 8GB RAM | 512GB SSD | Windows 11 | includes ASUS Backpack",
"brand": null,
"image": "https://i5.samsclubimages.com/asr/ac6cd867-dadd-4a6f-b2a2-8060ec0578f0.d8095ab7e4ea85bfca1e6365e83b88ca.jpeg",
"price": 399,
"rating": 4.4,
"item_id": "17470818757",
"savings": "SAVE $150.00",
"sponsored": false,
"was_price": "$549.00",
"product_id": "5Y10W64V7K08",
"sales_unit": "EACH",
"unit_price": null,
"description": "<ul>\n<li>14\" FHD Display</li>\n<li>Intel Core 5 120U 1.4 - 5GHz Processor</li>\n</ul>",
"price_range": null,
"availability": "IN_STOCK",
"out_of_stock": false,
"review_count": 5,
"price_display": "Now $399.00",
"variant_count": 4
}
],
"title": "Results for \"laptop\"",
"category": null,
"has_more": true,
"max_page": 2,
"page_size": 45,
"breadcrumbs": [],
"total_results": 61
},
"status": "success"
}
}About the Samsclub API
The Samsclub API on Parse exposes 5 endpoints for the publicly available data on samsclub.com. Calls return JSON over HTTPS and are billed per successful response.
Pin a release with the API-Snapshot-Version header so canonical updates don't silently change your contract.