# Costco Warehouse Prices API Documentation

<p><strong>Costco Warehouse Prices API</strong> returns the price of one item for up to two warehouses in one request. <code>online_price</code> is the warehouse price, <code>delivered_price</code> is the price with delivery. Warehouse 847 is the online price in the US, 894 in Canada.</p><p>This route takes the <strong>item number</strong> (<code>item_numbers</code> in the product answer), not the product id. Costs 1 credit per successful request.</p>

- **Documentation:** [https://scrappa.co/docs/costco-api/costco_product_price](https://scrappa.co/docs/costco-api/costco_product_price)
- **API group:** Costco API
- **Endpoint:** `GET https://scrappa.co/api/costco/product-price`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `item` | string | Yes | Item number from the product answer, 4 to 12 digits. |
| `warehouses` | string | No | Up to 2 comma separated warehouse numbers (default: the main warehouse and the online price). |
| `country` | string | No | us (default) or ca. Selects costco.com or costco.ca. |
| `locale` | string | No | en-US, en-CA or fr-CA. Canadian French works with country ca. Default is the English locale of the country. |

## Example response

```json
{
    "data": {
        "prices": [
            {
                "currency": "USD",
                "discount": 0,
                "warehouse": "243",
                "item_number": "2051888",
                "online_price": 799.99,
                "delivered_price": 799.99
            },
            {
                "currency": "USD",
                "discount": 0,
                "warehouse": "847",
                "item_number": "2051888",
                "online_price": 799.99,
                "delivered_price": 799.99
            }
        ],
        "country": "us",
        "item_number": "2051888"
    },
    "meta": {
        "credits": 1,
        "billable": true,
        "endpoint_family": "product_price"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A required parameter or a value is invalid. This response is not billable. |
| 404 | Not Found | The product, item or warehouse does not exist. This response is not billable. |
| 503 | Upstream Unavailable | Costco could not be reached after several tries. This response is not billable. Retry shortly. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)