Costco Product Data API
Scrape detailed Costco product information instantly with a simple API call
Get instant access to Costco product data with our API.
A GET request to our /api/getter/?platform="costco_detail" endpoint allows you to scrape product data for any product listing on Costco's website in real-time.
Example
Here's how you can scrape product data for this product with our API:
1 | |
1 2 3 4 5 | |
1 2 3 | |
1 2 3 4 5 6 | |
1 2 3 4 5 6 | |
In this example, we've provided the product's URL.
Query Parameters
As you can see in the example above, our endpoint needs the following query parameters:
Product URL
url
Required
Product listing's URL on Costco. Remove unnecessary query parameters and encode the URL.
Other Required Parameters
platform
Required
Specifies the scraping engine you wish to invoke. In this case, the value should be costco_detail.
api_key
Required
Your account's token—which can be obtained by signing up here.
🔗 URL Encoding
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
The response will include the following attributes for the product:
| Attributes Returned | Data Type | Information Represented |
|---|---|---|
| name | string | Name of product listing |
| brand | string | Brand of product listing |
| url | string | URL of the product listing |
| description | string | Description of the product |
| product_id | string | Product's unique identifier on Costco |
| sku | string | Stock Keeping Unit identifier |
| model_number | string | Model number of the product |
| availability | string | Availability status of the product |
| main_image | string | URL of main image |
| images | array | List of product listing's image URLs |
| price | float | Current price of product |
| listing_price | float | Listing price of product |
| currency_symbol | string | Currency symbol of the price |
| currency | string | Currency code of the price |
| specifications | array | List of product's specifications |
| product_guides | array | List of product guides |
| shipping | string | Shipping information |
| returns | string | Return policy information |
| variant_types | array | List of variant types |
| variants | array | List of product variants |
Member Only Items
Some products are only available to Costco members. For those products the values of price and listing_price will be null
📸 High-Quality Product Images & Detailed Info 🔍
While the Costco Product Data API may not always provide pricing details and doesn't include UPC codes (which is present in the Costco Search API), it shines in delivering stunning high-resolution product images 🖼️ along with a wealth of other valuable information such as product names, descriptions, specifications, and more! 📝 This API is your go-to resource for accessing comprehensive product details straight from Costco's website. 🛒💡
Response Example
Here's the response you can expect to receive for the request showcased above:
{
"success": true,
"product_url": "https://www.costco.com/stix-10-piece-golf-club-set.product.4000282550.html",
"result_count": 1,
"detail": {
"name": "Stix 10-piece Golf Club Set",
"brand": "Stix Golf",
"url": "https://www.costco.com/stix-10-piece-golf-club-set.product.4000282550.html",
"description": "Stix 10-piece Golf Club Set Designed for Forgiveness & Performance\nSet Includes 10 Clubs: Driver, 3w, 4h, 6i-PW, 56°, Putter\nSet Includes Black Stand Bag and 4 Black Head Covers\nGraphite Regular Flex Shafts on Driver, 3w and 4h\nSteel Chrome Regular Shafts on Irons, Wedges & Putter",
"product_id": "4000282550",
"sku": "1845950",
"model_number": "1845950",
"availability": "Online Only",
"main_image": "https://bfasset.costco-static.com/U447IH35/as/wpjssjshp7kh5sx7p8grbj3s/4000282550-847__1",
"images": [
"https://bfasset.costco-static.com/U447IH35/as/wpjssjshp7kh5sx7p8grbj3s/4000282550-847__1?auto=webp&format=jpg",
"https://bfasset.costco-static.com/U447IH35/as/wgj76jfkvrq48rh6jqqjh7v9/4000282550-847__2?auto=webp&format=jpg",
"https://bfasset.costco-static.com/U447IH35/as/7gb8m48857shb6mgqbg8t7/4000282550-847__3?auto=webp&format=jpg",
"https://bfasset.costco-static.com/U447IH35/as/98jgz4pjs2m9b7f8hk8c3w7/4000282550-847__4?auto=webp&format=jpg",
"https://bfasset.costco-static.com/U447IH35/as/xkgnjxpxhtnj2w4wmc7pccff/4000282550-847__5?auto=webp&format=jpg",
"https://bfasset.costco-static.com/U447IH35/as/27nwbxrfng2zq6njwhrgjjsb/4000282550-847__6?auto=webp&format=jpg",
"https://bfasset.costco-static.com/U447IH35/as/hsvcg98n99jh6t2s93bws38/4000282550-847__7?auto=webp&format=jpg",
"https://bfasset.costco-static.com/U447IH35/as/46qxt7wrgs93kc86x9km7mc9/4000282550-847__8?auto=webp&format=jpg",
"https://bfasset.costco-static.com/U447IH35/as/wpjssjshp7kh5sx7p8grbj3s/4000282550-847__1?auto=webp&format=jpg",
"https://bfasset.costco-static.com/U447IH35/as/wgj76jfkvrq48rh6jqqjh7v9/4000282550-847__2?auto=webp&format=jpg",
"https://bfasset.costco-static.com/U447IH35/as/7gb8m48857shb6mgqbg8t7/4000282550-847__3?auto=webp&format=jpg",
"https://bfasset.costco-static.com/U447IH35/as/98jgz4pjs2m9b7f8hk8c3w7/4000282550-847__4?auto=webp&format=jpg",
"https://bfasset.costco-static.com/U447IH35/as/xkgnjxpxhtnj2w4wmc7pccff/4000282550-847__5?auto=webp&format=jpg",
"https://bfasset.costco-static.com/U447IH35/as/27nwbxrfng2zq6njwhrgjjsb/4000282550-847__6?auto=webp&format=jpg",
"https://bfasset.costco-static.com/U447IH35/as/hsvcg98n99jh6t2s93bws38/4000282550-847__7?auto=webp&format=jpg",
"https://bfasset.costco-static.com/U447IH35/as/46qxt7wrgs93kc86x9km7mc9/4000282550-847__8?auto=webp&format=jpg"
],
"price": 479.99,
"listing_price": 479.99,
"currency_symbol": "$",
"currency": "USD",
"product_label": null,
"warning": null,
"includes": null,
"features": [],
"dimensions_weight": [],
"additional_demensions": [],
"specifications": [
{
"name": "Brand",
"value": "Stix Golf"
},
{
"name": "Number of Drivers",
"value": "1 Driver"
},
{
"name": "Number of Fairways",
"value": "1 Fairway Wood (3 Wood)"
},
{
"name": "Number of Hybrids",
"value": "1 Hybrid Iron (4 Hybrid)"
},
{
"name": "Number of Irons",
"value": "4 Irons (6, 7, 8 & 9 Iron)"
},
{
"name": "Number of Putters",
"value": "1 Putter"
},
{
"name": "Number of Wedges",
"value": "2 Wedges (Pitching & Sand Wedge)"
},
{
"name": "Online Only",
"value": "Online Only"
}
],
"product_guides": [
"https://stix.golf/pages/warranty"
],
"shipping": "Standard shipping via FedEx Ground is included in the quoted price.\nDelivery is not available to Puerto Rico, Alaska or Hawaii. \n\t\t\t\t\t\t\t\t\t\t\n\t\t\t\t\t\t\t\t\t\tCostco.com products can be returned to any of our more than 800 Costco warehouses worldwide.\n",
"returns": "SHOP CONFIDENTLY\nWe are committed to offering the best value to our members, with a risk-free 100% satisfaction guarantee on your membership and merchandise with some exceptions and limitations*. If you have questions about your membership or products you've purchased at Costco, please visit the membership counter at your local Costco or Contact Customer Service.\n*Certain items are not available for return or refund or may have limitations on their eligibility for return or refund. View Costco's Return Policy.\nCostco Technical and Warranty Services for select electronics and consumer goods. For manufacturer warranty information, please contact us.\nHow To Return Costco.com Orders\n",
"variant_types": [
{
"type": "Hand",
"code": "7741124012285428388",
"name": "Left Handed"
},
{
"type": "Hand",
"code": "7000000000000731543",
"name": "Right Handed"
}
],
"variants": [
{
"part_number": "1845950",
"product_url": "https://www.costco.com/stix-10-piece-golf-club-set.product.1845950.html",
"max_quantity": 9999,
"image_url": "",
"options": [
"7000000000000731543"
],
"in_stock": true
},
{
"part_number": "1845964",
"product_url": "https://www.costco.com/stix-10-piece-golf-club-set.product.1845964.html",
"max_quantity": 9999,
"image_url": "",
"options": [
"7741124012285428388"
],
"in_stock": true
}
]
},
"remaining_credits": 3820615.5
}
Request Cost
• 1 credit is deducted for each successful request to Costco.
Support
If you want to add a parameter to our response, need data from a country not listed above, or have any other questions or feedback, please write to us at support@unwrangle.com