Costco: Search
Search from Costco as JSON. 1 credit per successful call.
GET /v1/costco/search
Parameters
Send parameters in the query string.
| Parameter | Type | Required | Allowed values |
|---|---|---|---|
country | string | Optional | us, ca |
locale | string | Optional | en-US, en-CA, fr-CA |
query | string | Required | Up to 120 characters |
page | integer | Optional | Any |
per_page | integer | Optional | Any |
sort | string | Optional | relevance, price_asc, price_desc, rating_desc |
brand[] | list of string | Optional | Up to 80 characters |
min_rating | integer | Optional | Any |
min_price | number | Optional | Any |
max_price | number | Optional | Any |
category | string | Optional | Up to 200 characters |
in_stock | boolean | Optional | Any |
warehouse | string | Optional | Any |
Example request
Costco
GET/v1/costco/search?query=laptop
{
"success": true,
"data": {
"query": "laptop",
"country": "us",
"page": 1,
"per_page": 24,
"total_results": 164,
"has_next_page": true,
"warehouse": "243",
"items": [
{
"id": "4201046364",
"title": "Acer Aspire 16\" AI Copilot+ PC Touchscreen Laptop - Intel Core Ultra 7 processor 256V - WUXGA (1920 x 1200) Touchscreen - 16GB RAM – 512GB SSD - Windows 11 Home - Steel Gray.",
"brand": "Acer",
"url": "https://www.costco.com/p/-/acer-aspire-16-ai-copilot-pc-touchscreen-laptop---intel-core-ultra-7-processor-256v---wuxga-1920-x-1200-touchscreen---16gb-ram--512gb-ssd---windows-11-home---steel-gray/4201046364",
"image": "https://gdx-assets.costco.com/adobe/assets/urn:aaid:aem:a9825355-7467-44bc-8b34-a0e340d1266e/as/4201046364-847__1.avif?width=350&height=350&fit=contain",
"categories": [
"Computers",
"Computers > Laptops",
"Computers > Laptops > Windows Copilot+ PCs"
],
"model": "A16-52MT-78LQ",
"rating": {
"average": 5,
"count": 2
},
"price": {
"currency": "USD",
"delivery_min": 599.99,
"delivery_max": 599.99,
"original": 899.99
},
"member_only": false,
"availability": {
"delivery": "IN_STOCK"
},
"delivery_type": "Warehouse Pick-up",
"program_types": [
"Google",
"SiteControlledInventory",
"Standard"
],
"features": [
"Integrated Webcam",
"Backlit Keyboard",
"USB Ports"
],
"promotional_statement": "$300 manufacturer's savings is valid 10/24/26 through 11/15/26. While supplies last. Limit 2 per member. <a href='/promo-terms-conditions.html'>Terms & Conditions</a>",
"promotions": [
{
"short_text": "$90 OFF"
},
{
"short_text": "$210 OFF"
}
],
"position": 1
},
{
"id": "4201005956",
"title": "HP OmniBook 3 16\" Touchscreen Laptop - Intel Core Ultra 7 Series 2 - 2K (1920 x 1200) - 16GB Memory - 1TB SSD - Windows 11 Home.",
"brand": "HP",
"url": "https://www.costco.com/p/-/hp-omnibook-3-16-touchscreen-laptop---intel-core-ultra-7-series-2---2k-1920-x-1200---16gb-memory---1tb-ssd---windows-11-home/4201005956",
"image": "https://gdx-assets.costco.com/adobe/assets/urn:aaid:aem:6ad980ed-6d9b-423d-b091-3bddc4e96588/as/4201005956-847__1.avif?width=350&height=350&fit=contain",
"categories": [
"Computers",
"Computers > Laptops",
"Computers > Laptops > Windows Laptops"
],
"model": "16-bu0575cl",
"rating": {
"average": 3,
"count": 3
},
"price": {
"currency": "USD",
"delivery_min": 699.99,
"delivery_max": 699.99,
"original": 1199.99
},
"member_only": false,
"availability": {
"delivery": "IN_STOCK"
},
"delivery_type": "Warehouse Pick-up",
"program_types": [
"Google",
"SiteControlledInventory",
"Standard"
],
"features": [
"Backlit Keyboard",
"Integrated Webcam",
"Touchscreen"
],
"promotional_statement": "$500 manufacturer's savings is valid 11/1/26 through 11/30/26. While supplies last. Limit 2 per member. <a href='/promo-terms-conditions.html'>Terms & Conditions</a>",
"promotions": [
{
"short_text": "$355 OFF"
},
{
"short_text": "$145 OFF"
}
],
"position": 2
},
{
"id": "4000372290",
"title": "Dell 16 Touchscreen Laptop - 16.0\" FHD+ 1920x1200 Touchscreen - Ryzen 7 250 - 16GB RAM - 1TB SSD - Windows 11 Home - Carbon Black.",
"brand": "Dell",
"url": "https://www.costco.com/p/-/dell-16-touchscreen-laptop---160-fhd-1920x1200-touchscreen---ryzen-7-250---16gb-ram---1tb-ssd---windows-11-home---carbon-black/4000372290",
"image": "https://gdx-assets.costco.com/adobe/assets/urn:aaid:aem:013ea058-66b5-4ea1-929d-d9764278f7de/as/95bbbfv3f3brjkxw5hz4pg__4000372290-847__1.avif?width=350&height=350&fit=contain",
"categories": [
"Computers",
"Computers > Laptops",
"Computers > Laptops > Windows Laptops"
],
"model": "LDC16255-A087BLK-PUS",
"rating": {
"average": 4.1892,
"count": 185
},
"price": {
"currency": "USD",
"delivery_min": 799.99,
"delivery_max": 799.99,
"original": 1199.99
},
"member_only": false,
"availability": {
"delivery": "IN_STOCK"
},
"delivery_type": "Warehouse Pick-up",
"program_types": [
"SiteControlledInventory",
"Standard",
"ShipIt"
],
"features": [
"Integrated Webcam",
"Touchscreen"
],
"promotional_statement": "$400 manufacturer's savings is valid 11/1/26 through 11/30/26. While supplies last. Limit 2 per member. <a href='/promo-terms-conditions.html'>Terms & Conditions</a>",
"promotions": [
{
"short_text": "$150 OFF"
},
{
"short_text": "$250 OFF"
}
],
"position": 3
}
],
"facets": [
{
"key": "price",
"values": [
{
"min": 25,
"max": 50,
"count": 10
},
{
"min": 50,
"max": 100,
"count": 18
},
{
"min": 200,
"max": 500,
"count": 6
}
]
},
{
"key": "rating",
"values": [
{
"min": 1,
"max": 5,
"count": 97
},
{
"min": 2,
"max": 5,
"count": 94
},
{
"min": 3,
"max": 5,
"count": 82
}
]
},
{
"key": "buy_in_warehouse",
"values": [
{
"value": "1",
"count": 37
}
]
}
]
},
"meta": {
"endpoint_family": "search",
"filtered_out": 0,
"request_id": "req_3dc723442fcd44328042768096b44a43",
"credits_charged": 1,
"credits_remaining": 1950
}
}200 OKJSONX-Credits-Used: 1
Recorded from our API and shortened.
Run this endpoint in the playground with your own parameters. 1 credit per successful call; failed calls are free.