Skip to main content
Network status
Log in
Piloterr
Back to library

Costco Product API

Costco Product API: fetch full product page data from a product ID or URL across regional Costco sites. Returns pricing, availability, ratings, images and breadcrumbs via browser rendering.

Active2 credits = 1 requestGET/v2/costco/product
Try endpoint for freePiloterr

Endpoint Overview

Detailed documentation, pricing, and usage examples.

OverviewLink to Overview

The Costco Product API returns full product page data from Costco regional sites. Pass a numeric product ID, a full product URL, or an ID with region and receive structured JSON with pricing, availability, ratings, images, and breadcrumbs.

Piloterr uses browser rendering (wait_for=#costco-consent-manager) and parses Next.js RSC productDetailsData, JSON-LD Product, and DOM stock status.

Supported regionsLink to Supported regions

Code Host Search path Page param
us / com www.costco.com /s?keyword= currentPage
fr www.costco.fr /s?keyword= currentPage
es www.costco.es /s?keyword= currentPage
mx www.costco.com.mx /s?keyword= currentPage
kr www.costco.co.kr /s?keyword= currentPage
tw www.costco.com.tw /s?keyword= currentPage
jp www.costco.co.jp /s?keyword= currentPage
au www.costco.com.au /s?keyword= currentPage
is www.costco.is /s?keyword= currentPage
nz www.costco.co.nz /s?keyword= currentPage
se www.costco.se /s?keyword= currentPage
ca www.costco.ca /CatalogSearch?keyword= currentPage
uk www.costco.co.uk /search?text= page

CA and UK use dedicated search URL formats; other regions follow the US-like /s?keyword= pattern.

QuickstartLink to Quickstart

GET https://api.piloterr.com/v2/costco/product?query=4000266385
GET https://api.piloterr.com/v2/costco/product?query=4000268598&region=ca
GET https://api.piloterr.com/v2/costco/product?query=https://www.costco.com/p/-/mohawk-home-6mm-thick-94in-x-478in-22-mil-waterproof-luxury-vinyl-plank-flooring-1565-sq-ftctn/4000266385

Via POST:

POST https://api.piloterr.com/v2/costco/product
Content-Type: application/json

{"query": "4000266385", "region": "us", "return_page_source": false}

ParametersLink to Parameters

Parameter Type Required Description
query string yes Product ID or full regional product URL
region string no Region code or host when query is a numeric ID only (default: US)
return_page_source boolean no Raw HTML as {"result": "..."} (default: false)

Response fieldsLink to Response fields

Field Type Description
product_id string Catalog product ID
item_number string | null Selected item / SKU number
name string Product title
url string Canonical product URL
brand string | null Brand (JSON-LD)
description string | null Long description / features (RSC, ;-separated)
image_url string | null First image (images[0])
images string[] | null All image URLs found
price number | null Online display price
currency string | null ISO 4217 code
availability string | null e.g. in_stock, out_of_stock
rating number | null Average rating / 5
review_count integer | null Review count
breadcrumbs string[] | null Category breadcrumb trail
region string Regional host

Costco API workflowLink to Costco API workflow

  1. Costco Search: discover listings and product URLs
  2. Costco Product: fetch full PDP JSON (this endpoint)

Error codesLink to Error codes

Code Meaning
400 Missing or invalid query
404 Product page not parseable
500 Rendering or parsing error

NotesLink to Notes

  • Product parsing uses RSC + JSON-LD; search remains DOM-based.
  • images may include multiple resolutions and color variants.
  • Costs 2 credits per call (browser rendering).

Main use casesLink to Main use cases

  • PDP enrichment: extract brand, specs, and all gallery images
  • Availability monitoring: track stock status across regions
  • Price intelligence: compare online prices on Costco regional stores

Related APIs

Expand your data capabilities with these complementary tools.

View All
Costco Search/v2/costco/search

Costco Search API: search product listings by keyword or URL across 13 regional Costco sites. Returns prices, availability, review counts and pagination via browser rendering.

GET2 credits = 1 requestActive

Ready to get started?

Your web scraping API is one click away. Start with +500 credits, no infrastructure to set up, no proxies to manage, and no credit card required.

  • +500 credits
  • No credit card required
  • All endpoints included
Start free (+500 credits)PiloterrTalk to a data expert