costcobusinessdelivery.com APIcostcobusinessdelivery.com ↗
Access Costco Business Delivery product data via 6 endpoints. Search products, retrieve pricing, browse categories, and find warehouse locations by ZIP code.
curl -X GET 'https://api.parse.bot/scraper/e088fae7-127e-4c18-bcca-4ded0a66bbbc/search_products?sort=bestMatch&limit=3&query=paper+towels' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for products by keyword or item number. Returns paginated product results with pricing, availability, and faceted filters.
| Param | Type | Description |
|---|---|---|
| loc | string | Warehouse location ID for pricing and availability context. |
| sort | string | Sort order. Accepted values: bestMatch, bestSeller, price, topRated. |
| limit | integer | Maximum number of results to return per page. |
| query | string | Search keyword or item number. |
| start | integer | Pagination offset (0-based index of first result). |
{
"type": "object",
"fields": {
"facets": "object containing filter facets (category, price, brand)",
"fusion": "object containing query metadata (sort, queryId)",
"response": "object containing docs array of products, numFound total count, and start offset",
"responseHeader": "object with query timing metadata"
},
"sample": {
"data": {
"facets": {
"Brand_attr": {
"buckets": [
{
"val": "Kirkland Signature",
"count": 1
}
]
},
"item_category": {
"buckets": [
{
"val": "0|Disposables",
"count": 10
}
]
}
},
"fusion": {
"fusionQueryId": "iTxfzKzjkN",
"requestedSort": "score desc"
},
"response": {
"docs": [
{
"name": "Kirkland Signature 2-Ply Paper Towels, White, 160 Create-A-Size Sheets, 12 ct",
"image": "https://bfasset.costco-static.com/U447IH35/as/h827kgxsh96x6754wrn98fj/512599__1psd?auto=webp&format=jpg&width=350&height=350&fit=bounds&canvas=350,350",
"Brand_attr": [
"Kirkland Signature"
],
"item_number": "512599",
"item_location_stockStatus": "in stock",
"item_location_pricing_salePrice": 23.79
}
],
"start": 0,
"numFound": 12
}
},
"status": "success"
}
}About the costcobusinessdelivery.com API
The Costco Business Delivery API provides 6 endpoints to search products, retrieve detailed item data, browse category listings, and locate warehouses by ZIP code. The search_products endpoint returns paginated results with list price, sale price, stock status, and faceted filters for brand, category, and price range — all scoped to a specific warehouse location when a loc parameter is supplied.
Product Search and Detail
The search_products endpoint accepts a query keyword or item number and returns a response object containing a docs array of matching products alongside numFound and start for pagination. Sort order is controlled via the sort parameter, accepting bestMatch, bestSeller, price, or topRated. The accompanying facets object exposes filterable buckets for category, price, and brand. For a full item record, pass an item_number to get_product_detail, which returns fields including item_location_pricing_listPrice, item_location_pricing_salePrice, item_location_stockStatus, item_product_marketing_features, Brand_attr, and a primary image URL.
Category Browsing
get_category_products accepts a category_url path such as /beverages.html or /grocery.html and returns the same paginated structure as search results, with facets now broken down by subcategory. A dedicated get_restaurant_supplies endpoint targets /restaurant.html specifically and returns identical response fields — useful for restaurant procurement workflows without needing to know the category path. The get_search_filters endpoint lets you pre-fetch available filter facets — including Brand_attr buckets, item_category buckets, and item_location_pricing_salePrice price ranges — for a given query before executing a full search.
Location Context
Most endpoints accept a loc parameter (warehouse location ID) that scopes pricing and availability to a specific Costco Business Delivery warehouse. The find_warehouse endpoint resolves a US ZIP code to geocoded location data — city, stateProvince, latitude, longitude, and timeZone — which can then feed the loc parameter on subsequent product requests to get regionally accurate pricing.
- Monitor list price and sale price changes on specific item numbers for bulk procurement decisions
- Build a product catalog browser filtered by brand and subcategory using
get_category_productsfacets - Resolve a buyer's ZIP code with
find_warehouseto deliver location-accurate pricing via thelocparameter - Aggregate
item_product_marketing_featuresacross competing items to automate spec comparison sheets - Pre-populate filter UI dropdowns using
get_search_filtersbefore users perform a search - Track stock status (
item_location_stockStatus) for high-volume restaurant supply items at specific warehouses - Extract brand and category distribution data from
facetsto analyze Costco Business Delivery's assortment mix
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Costco Business Delivery have an official developer API?+
What does `get_product_detail` return beyond what `search_products` includes?+
get_product_detail returns the full item record including item_product_marketing_features (an array of feature descriptions), Brand_attr, description, and both item_location_pricing_listPrice and item_location_pricing_salePrice. The search endpoint returns a subset of these fields within each docs entry — the detail endpoint is the appropriate call when you need the complete field set for a single item.Does the API expose customer reviews or product ratings?+
How does pagination work across the search and category endpoints?+
start integer (0-based offset) combined with limit to page through results. The response.numFound field in every response gives the total count of matching items, so you can calculate how many pages exist before fetching them.