--- title: "Costco API: JSON data, 8 endpoints, 1 credit per call" description: "Costco API for product search, product details and prices, reviews, review summaries and warehouse locations as JSON. 1 credit per successful call." url: https://perceptlayer.com/apis/costco --- [APIs](https://perceptlayer.com/apis) / [Marketplaces](https://perceptlayer.com/verticals/marketplaces) / Costco 1 credit per call 8 endpoints 17 datapoints # Costco API Costco API for product search, product details and prices, reviews, review summaries and warehouse locations as JSON. 1 credit per successful call. [Get a free API key](https://perceptlayer.com/signup) Run it below 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. Terms & Conditions", "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. Terms & Conditions", "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. Terms & Conditions", "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 OK JSON X-Credits-Used: 1 Recorded from our API and shortened. Sample data ## What one call returns A recorded run of `search`: the fields and shapes you will get, shortened to 3 items. | # | id string | title string | brand string | url url | image url | categories string\[\] | model string | rating object | price object | member\_only boolean | availability object | delivery\_type string | program\_types string\[\] | features string\[\] | promotional\_statement string | promotions object\[\] | position integer | | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 1 | 4201046364 | 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. | Acer | 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 | 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 | \[3 items\] | A16-52MT-78LQ | {2 fields} | {4 fields} | false | {1 fields} | Warehouse Pick-up | \[3 items\] | \[3 items\] | $300 manufacturer's savings is valid 10/24/26 through 11/15/26. While supplies last. Limit 2 per member. Terms & Conditions | \[2 items\] | 1 | | 2 | 4201005956 | HP OmniBook 3 16" Touchscreen Laptop - Intel Core Ultra 7 Series 2 - 2K (1920 x 1200) - 16GB Memory - 1TB SSD - Windows 11 Home. | HP | 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 | 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 | \[3 items\] | 16-bu0575cl | {2 fields} | {4 fields} | false | {1 fields} | Warehouse Pick-up | \[3 items\] | \[3 items\] | $500 manufacturer's savings is valid 11/1/26 through 11/30/26. While supplies last. Limit 2 per member. Terms & Conditions | \[2 items\] | 2 | | 3 | 4000372290 | Dell 16 Touchscreen Laptop - 16.0" FHD+ 1920x1200 Touchscreen - Ryzen 7 250 - 16GB RAM - 1TB SSD - Windows 11 Home - Carbon Black. | Dell | 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 | 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 | \[3 items\] | LDC16255-A087BLK-PUS | {2 fields} | {4 fields} | false | {1 fields} | Warehouse Pick-up | \[3 items\] | \[2 items\] | $400 manufacturer's savings is valid 11/1/26 through 11/30/26. While supplies last. Limit 2 per member. Terms & Conditions | \[2 items\] | 3 | Recorded from our API · 3 items shown · 17 datapoints per item GET /v1/costco/search?query=laptop 17 datapoints ### Identity - id string - title string - brand string - delivery\_type string - program\_types string\[\] ### Contact - url url ### Location - promotional\_statement string ### Reputation - image url - rating object ### Price - price object ### Other - categories string\[\] - model string - member\_only boolean - availability object - features string\[\] - promotions object\[\] - position integer Playground ## Run this API cURL shell ``` curl "https://api.perceptlayer.com/v1/costco/search?query=laptop" \ -H "X-API-Key: $API_KEY" ``` Costco · 8 endpoints ## Endpoints Every endpoint takes the same key. Open one for its parameters and an example request. | Endpoint | Required parameters | Cost | | --- | --- | --- | | [GET `/v1/costco/autocomplete`](https://perceptlayer.com/apis/costco/autocomplete) | `query` +2 optional | 1 credit | | [GET `/v1/costco/product`](https://perceptlayer.com/apis/costco/product) | `id` +3 optional | 1 credit | | [GET `/v1/costco/product-price`](https://perceptlayer.com/apis/costco/product-price) | `item` +3 optional | 1 credit | | [GET `/v1/costco/reviews`](https://perceptlayer.com/apis/costco/reviews) | `product_id` +7 optional | 1 credit | | [GET `/v1/costco/reviews-summary`](https://perceptlayer.com/apis/costco/reviews-summary) | `product_id` +1 optional | 1 credit | | [GET `/v1/costco/search`](https://perceptlayer.com/apis/costco/search) | `query` +12 optional | 1 credit | | [GET `/v1/costco/warehouse`](https://perceptlayer.com/apis/costco/warehouse) | `id` +2 optional | 1 credit | | [GET `/v1/costco/warehouses`](https://perceptlayer.com/apis/costco/warehouses) | none +6 optional | 1 credit | Overview ## About the Costco API ## What you can get The Costco API returns Costco product and warehouse data as JSON through 8 endpoints. Most take a `country` (us or ca) and a `locale` (en-US, en-CA or fr-CA). - **Search:** `search` takes a `query`, with `page`, `per_page`, `sort` (relevance, price\_asc, price\_desc or rating\_desc), `brand[]`, `min_rating`, `min_price`, `max_price`, `category`, `in_stock` and `warehouse`. `autocomplete` takes a partial `query`. - **Products:** `product` takes an `id`, with `warehouse`. `product-price` takes an `item`, with `warehouses[]`. - **Reviews:** `reviews` takes a `product_id`, with `page`, `per_page`, `rating`, `max_rating` and `sort` (relevancy, newest, oldest, rating\_desc, rating\_asc or helpful). `reviews-summary` takes a `product_id`. - **Warehouses:** `warehouses` finds warehouses by `latitude` and `longitude` or a `postal_code`, with `page` and `per_page`. `warehouse` takes an `id`, with `include_gas`. The recorded search for "laptop" in the us returns `items`, each with `id`, `title`, `brand`, `url`, `image`, `categories`, `model`, `rating` ( `average` and `count`), `price` ( `currency`, `delivery_min`, `delivery_max` and `original`), `member_only`, `availability`, `delivery_type`, `program_types`, `features`, `promotional_statement`, `promotions` and `position`. It also returns `total_results` (164 in that recording), `has_next_page`, a `warehouse`, and `facets`. ## How a call works Search, then look up: `GET /v1/costco/search?query=laptop` with your key in the `X-API-Key` header returns each product's `id`; `product` takes that `id`. To price against a nearby warehouse, find one with `GET /v1/costco/warehouses?latitude=40.749&longitude=-73.996&per_page=5` and pass its id as `warehouse`. Check `has_next_page` before asking for the next `page`. Every successful call costs 1 credit; failed calls cost nothing. Marketplaces JSON REST MCP ### More marketplaces APIs [About You](https://perceptlayer.com/apis/about-you) [adidas](https://perceptlayer.com/apis/adidas) [AliExpress](https://perceptlayer.com/apis/aliexpress) [Allegro](https://perceptlayer.com/apis/allegro) [Amazon](https://perceptlayer.com/apis/amazon) [ASOS](https://perceptlayer.com/apis/asos) [Billiger.de](https://perceptlayer.com/apis/billiger) [bol.com](https://perceptlayer.com/apis/bol) [Chrono24](https://perceptlayer.com/apis/chrono24) [Craigslist](https://perceptlayer.com/apis/craigslist) [DBA](https://perceptlayer.com/apis/dba) [Depop](https://perceptlayer.com/apis/depop) Use cases ### Track Costco prices and promotions for a product list `Use the Costco API to track Costco prices and promotions for a product list` ### Compare a product's price across warehouses with \`product-price\` `` Use the Costco API to compare a product's price across warehouses with `product-price` `` ### Watch member-only items and stock for a search `Use the Costco API to watch member-only items and stock for a search` ### Analyse product reviews by rating, or read the review summary `Use the Costco API to analyse product reviews by rating, or read the review summary` FAQ ## Questions **How much does the Costco API cost?** Each successful call costs one credit, and each search page is one call. New accounts get free credits to start, and credit packs bring the price down as you scale. **Can I get prices for a specific warehouse?** Yes. \`search\` and \`product\` take a \`warehouse\`, and \`product-price\` takes a list of \`warehouses\[\]\`. \`warehouses\` finds warehouse ids by coordinates or \`postal\_code\`. **Do I need a Costco membership?** No. You call this Costco API with your Perceptlayer key in the \`X-API-Key\` header, with no Costco login. **What format are responses in?** Every endpoint returns JSON, with no HTML parsing on your side. **Should I build a Costco scraper instead?** You can, but a Costco scraper is code you maintain: page changes break it, requests get blocked, and Costco's terms govern how you collect data. The Costco API gives you 8 endpoints of named JSON fields for 1 credit per successful call, and failed calls cost nothing. A scraper makes sense only for data these endpoints don't return, so check the response in the playground on this page first. ## Try the Costco API with 100 free credits No credit card. Failed calls are never billed. [Get a free API key](https://perceptlayer.com/signup) [Read the docs](https://docs.perceptlayer.com)