Costco Category Search API
A GET request to our endpoint /api/getter/?platform="costco_category" allows you to scrape category pages from Costco in real-time.
Example
To scrape Costco's category page for Dishwashers, you can use the following command:
1 | |
Note
Any Costco category URL with pagination can be used to scrape the category. Ensure that the URL is URL-encoded before passing it as a query parameter. You can add filters such as price or specific brands and then copy the URL. The Costco Category Search API works with any category URL that supports pagination.
Query Parameters
Our endpoint requires the following query parameters:
Query Parameters
url
Required
The encoded URL of the Costco category page you wish to scrape. Make sure it contains a list of products and supports pagination to receive a successful response.
page
Optional
The page number for which you want the results. Default value is 1.
Note
The page number in the URL (if any) will be overridden by the page parameter in the request (even with the default value of 1 if you don't specify it).
Required Parameters
platform
Required
Specifies the scraping engine you wish to invoke. In this case, the value should be costco_category.
api_key
Required
Your account's token—which can be obtained by signing up here.
Results
Each request returns up to 24 results per page. The response will include the following attributes for each product in the category:
| Attributes Returned | Data Type | Information Represented |
|---|---|---|
| id | string | Unique product identifier |
| name | string | Name of product listing |
| url | string | URL of product listing |
| thumbnail | string | URL of product's thumbnail |
| rating | float | Average rating of product |
| total_ratings | int | Number of ratings received |
| price | float | Price of product |
| currency | string | Currency of product |
| product_features | array | List of key features of the product |
| promo | string | Promotional information or price validity date |
Response Example
Here's the response you can expect to receive for the request showcased above:
{
"success": true,
"category_url": "https://www.costco.com/dishwashers.html?refine=||item_program_eligibility-ShipIt||Color_attr-Stainless+Steel&deliveryFacetFlag=false",
"page": 1,
"total_results": 38,
"no_of_pages": 2,
"result_count": 24,
"results": [
{
"id": "100682823",
"url": "https://www.costco.com/whirlpool-top-control-dishwasher-with-soak-and-clean-cycle.product.100682823.html",
"thumbnail": "https://cdn.bfldr.com/U447IH35/as/q3cvmpwbcjwm6chqrzqjfcqr/6660750-847__1?auto=webp&format=jpg&width=350&height=350&fit=bounds&canvas=350,350",
"name": "Whirlpool Top Control Dishwasher with Soak and Clean Cycle",
"price": 629.99,
"currency": "USD",
"rating": 4.42,
"total_ratings": 2548,
"product_features": [
"24 Inch. Fit Width",
"Sensor Cycle",
"1-hour Wash Cycle",
"Tap Touch Controls"
],
"promo": "Price includes $320 savings.Price valid through 10/20/24"
},
{
"id": "4000113061",
"url": "https://www.costco.com/bosch-800-series-top-control-towel-bar-handle-dishwasher%2c-stainless-steel-tub%2c-crystaldry-technology%2c-ultra-quiet-42-dba.product.4000113061.html",
"thumbnail": "https://cdn.bfldr.com/U447IH35/as/v8b66ps8nppkwqv3sv752zf4/1719026-847__1?auto=webp&format=jpg&width=350&height=350&fit=bounds&canvas=350,350",
"name": "Bosch 800 Series Top Control Towel Bar Handle Dishwasher, Stainless Steel Tub, CrystalDry Technology, Ultra Quiet 42 dBa",
"price": 1149.99,
"currency": "USD",
"rating": 4.48,
"total_ratings": 2005,
"product_features": [
"Intelligent PrecisionWash",
"Full Stainless Steel Tub",
"Flexible 3rd Rack Holds Larger Cutlery",
"Patented CrystalDry Technology",
"Energy Efficient with Water Saving Wash Technologies"
],
"promo": "Price includes $200 savings.Price valid through 10/16/24"
},
{
"id": "4000265240",
"url": "https://www.costco.com/kitchenaid-hidden-control-44-dba-dishwasher-with-printshield-finish-and-freeflex-third-level-rack.product.4000265240.html",
"thumbnail": "https://cdn.bfldr.com/U447IH35/as/x5wwsjjpngbg9g4x8n232/1823433-847__1?auto=webp&format=jpg&width=350&height=350&fit=bounds&canvas=350,350",
"name": "KitchenAid Hidden Control 44 dBA Dishwasher with PrintShield Finish and FreeFlex Third Level Rack",
"price": 899.99,
"currency": "USD",
"rating": 4.65,
"total_ratings": 257,
"product_features": [
"SatinGlide® Rails",
"ProWash Cycle",
"Energy Star® Certified",
"44 dBA",
"Stainless Steel Interior"
],
"promo": "Price includes $500 savings.Price valid through 10/16/24"
},
...
],
"meta_data": {},
"remaining_credits": 639134
}
Request Cost
1 credit per request.
Support
If you encounter any issues or have questions about using the API, please contact our support team at support@unwrangle.com. We're here to help!
Supported Countries
Currently, the Costco Category Search API supports the following country:
| Country | Domain | Code |
|---|---|---|
| USA | Costco.com | us |
If you need data from a country not listed here, please contact us at support@unwrangle.com.
Conclusion
The Costco Category Search API provides a powerful tool for real-time data extraction from Costco's category pages. By following the guidelines and examples provided in this documentation, you can start integrating Costco product data into your applications today.
Remember to monitor your usage to stay within rate limits and handle errors gracefully. Happy scraping!