# Costco Warehouses API Documentation

<p><strong>Costco Warehouses API</strong> lists warehouses nearest first with address, coordinates, phone, opening hours, holiday closures and services (pharmacy, tire center, gas station and more). Send <code>latitude</code> and <code>longitude</code> or a <code>postal_code</code>. The list covers the US and Canada. Use the <code>id</code> with the warehouse route and as the <code>warehouse</code> parameter of search. Costs 1 credit per successful request.</p>

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

## 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 |
| --- | --- | --- | --- |
| `latitude` | number | No | Latitude, with longitude. |
| `longitude` | number | No | Longitude, with latitude. |
| `postal_code` | string | No | Postal or ZIP code. Use it instead of coordinates. |
| `locale` | string | No | en-US (default), en-CA or fr-CA. Sets the language of names and hours. |
| `page` | integer | No | One-based page number (default 1). |
| `per_page` | integer | No | Warehouses per page, 1 to 50 (default 10). |

## Example response

```json
{
    "data": {
        "page": 1,
        "per_page": 2,
        "warehouses": [
            {
                "id": "243",
                "name": "Queens",
                "type": "Warehouse",
                "hours": [
                    {
                        "days": [
                            "monday",
                            "tuesday",
                            "wednesday",
                            "thursday",
                            "friday"
                        ],
                        "open": "09:00",
                        "close": "20:30",
                        "label": "Business Mon-Fri",
                        "closed": false
                    },
                    {
                        "days": [
                            "monday",
                            "tuesday",
                            "wednesday",
                            "thursday",
                            "friday"
                        ],
                        "open": "10:00",
                        "close": "20:30",
                        "label": "Mon-Fri",
                        "closed": false
                    }
                ],
                "phone": "(718) 267-3680",
                "address": {
                    "city": "LONG ISLAND CITY",
                    "line1": "3250 VERNON BLVD",
                    "line2": null,
                    "state": "NY",
                    "country": "US",
                    "postal_code": "11106-4927"
                },
                "distance": 3.26,
                "holidays": [
                    {
                        "date": "2026-11-26",
                        "name": "Thanksgiving Day",
                        "open": null,
                        "close": null,
                        "closed": true
                    }
                ],
                "latitude": 40.76760808,
                "services": [
                    {
                        "code": "food",
                        "name": "Food Court",
                        "hours": [],
                        "phone": "(718) 267-3681"
                    },
                    {
                        "code": "optical",
                        "name": "Optical Department",
                        "hours": [],
                        "phone": "(718) 267-5512"
                    },
                    {
                        "code": "pharmacy",
                        "name": "Pharmacy",
                        "hours": [
                            {
                                "days": [
                                    "monday",
                                    "tuesday",
                                    "wednesday",
                                    "thursday",
                                    "friday"
                                ],
                                "open": "09:00",
                                "close": "19:00",
                                "label": "Mon-Fri",
                                "closed": false
                            },
                            {
                                "days": [
                                    "saturday"
                                ],
                                "open": "09:00",
                                "close": "18:00",
                                "label": "Sat",
                                "closed": false
                            },
                            {
                                "days": [
                                    "sunday"
                                ],
                                "open": null,
                                "close": null,
                                "label": "Sun",
                                "closed": true
                            }
                        ],
                        "phone": "(718) 267-5516"
                    }
                ],
                "longitude": -73.93886284,
                "time_zone": "America/New_York",
                "region_code": "NE",
                "opening_date": "1996-11-20",
                "distance_unit": "mi",
                "has_gas_station": false
            },
            {
                "id": "1062",
                "name": "Manhattan",
                "type": "Warehouse",
                "hours": [
                    {
                        "days": [
                            "monday",
                            "tuesday",
                            "wednesday",
                            "thursday",
                            "friday"
                        ],
                        "open": "09:00",
                        "close": "20:30",
                        "label": "Business Mon-Fri",
                        "closed": false
                    },
                    {
                        "days": [
                            "monday",
                            "tuesday",
                            "wednesday",
                            "thursday",
                            "friday"
                        ],
                        "open": "10:00",
                        "close": "20:30",
                        "label": "Mon-Fri",
                        "closed": false
                    }
                ],
                "phone": "(212) 896-5875",
                "address": {
                    "city": "NEW YORK",
                    "line1": "517 E 117TH ST",
                    "line2": null,
                    "state": "NY",
                    "country": "US",
                    "postal_code": "10035-4409"
                },
                "distance": 4.71,
                "holidays": [
                    {
                        "date": "2026-11-26",
                        "name": "Thanksgiving Day",
                        "open": null,
                        "close": null,
                        "closed": true
                    }
                ],
                "latitude": 40.79570001,
                "services": [
                    {
                        "code": "food",
                        "name": "Food Court",
                        "hours": [],
                        "phone": null
                    },
                    {
                        "code": "hearing",
                        "name": "Hearing Aids",
                        "hours": [],
                        "phone": "(212) 896-5897"
                    },
                    {
                        "code": "optical",
                        "name": "Optical Department",
                        "hours": [],
                        "phone": "(212) 896-5884"
                    }
                ],
                "longitude": -73.93067747,
                "time_zone": "America/New_York",
                "region_code": "NE",
                "opening_date": "2009-11-12",
                "distance_unit": "mi",
                "has_gas_station": false
            }
        ],
        "has_next_page": true
    },
    "meta": {
        "credits": 1,
        "billable": true,
        "endpoint_family": "warehouses"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A required parameter or a value is invalid. 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)