Sign inGet a free API keyDashboard
Menu

APIs / Marketplaces / Costco

1 credit per call8 endpoints17 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 keyRun 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. <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.

Sample data

What one call returns

A recorded run of search: the fields and shapes you will get, shortened to 3 items.

#idstringtitlestringbrandstringurlurlimageurlcategoriesstring[]modelstringratingobjectpriceobjectmember_onlybooleanavailabilityobjectdelivery_typestringprogram_typesstring[]featuresstring[]promotional_statementstringpromotionsobject[]positioninteger
14201046364Acer 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.Acerhttps://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/4201046364https://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. <a href='/promo-terms-conditions.html'>Terms & Conditions</a>[2 items]1
24201005956HP OmniBook 3 16" Touchscreen Laptop - Intel Core Ultra 7 Series 2 - 2K (1920 x 1200) - 16GB Memory - 1TB SSD - Windows 11 Home.HPhttps://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/4201005956https://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. <a href='/promo-terms-conditions.html'>Terms & Conditions</a>[2 items]2
34000372290Dell 16 Touchscreen Laptop - 16.0" FHD+ 1920x1200 Touchscreen - Ryzen 7 250 - 16GB RAM - 1TB SSD - Windows 11 Home - Carbon Black.Dellhttps://www.costco.com/p/-/dell-16-touchscreen-laptop---160-fhd-1920x1200-touchscreen---ryzen-7-250---16gb-ram---1tb-ssd---windows-11-home---carbon-black/4000372290https://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. <a href='/promo-terms-conditions.html'>Terms & Conditions</a>[2 items]3

Recorded from our API · 3 items shown · 17 datapoints per itemGET /v1/costco/search?query=laptop

17 datapoints

Identity

  • idstring
  • titlestring
  • brandstring
  • delivery_typestring
  • program_typesstring[]

Contact

  • urlurl

Location

  • promotional_statementstring

Reputation

  • imageurl
  • ratingobject

Price

  • priceobject

Other

  • categoriesstring[]
  • modelstring
  • member_onlyboolean
  • availabilityobject
  • featuresstring[]
  • promotionsobject[]
  • positioninteger

Playground

Run this API

cURLshell
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.

EndpointRequired parametersCost
GET/v1/costco/autocomplete
query+2 optional
1 credit
GET/v1/costco/product
id+3 optional
1 credit
GET/v1/costco/product-price
item+3 optional
1 credit
GET/v1/costco/reviews
product_id+7 optional
1 credit
GET/v1/costco/reviews-summary
product_id+1 optional
1 credit
GET/v1/costco/search
query+12 optional
1 credit
GET/v1/costco/warehouse
id+2 optional
1 credit
GET/v1/costco/warehouses
none+6 optional
1 credit

Overview

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.

MarketplacesJSONRESTMCP

More marketplaces APIs

About YouadidasAliExpressAllegroAmazonASOSBilliger.debol.comChrono24CraigslistDBADepop

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 keyRead the docs