Costco Product
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.
Credit cost: 2 credits per call
ApiKeyAuthx-api-key<token>Your API key. Include it in the x-api-key header for every request.
query*stringCostco product ID or full product URL.
Examples:
40002663854000268598 + region=cahttps://www.costco.com/p/-/mohawk-home-6mm-thick-94in-x-478in-22-mil-waterproof-luxury-vinyl-plank-flooring-1565-sq-ftctn/4000266385https://www.costco.ca/nom.produit.product.4000268598.htmlregion?stringRegional Costco site. Accepts a region code (us, fr, ca, uk, …) or full host (www.costco.fr). Defaults to US (www.costco.com) when omitted.
Examples:
frcawww.costco.co.ukreturn_page_source?booleanWhen true, return the raw HTML page source as {"result": "..."} instead of structured JSON. Defaults to false.
fields?stringComma-separated list of response fields to return, with dot notation for nested fields (e.g. name,location.city).
is_async?booleanRun the request as a background job: the API answers 202 with a job_id to poll on GET /v1/jobs/{id}.
falsesoft_fail?booleanReturn HTTP 200 even when the request fails; the error is in the error field of the body.
falseSuccessful response
application/json- response
url?stringname?stringbrand?stringprice?numberimages?array<string>rating?numberregion?stringcurrency?stringimage_url?stringproduct_id?stringbreadcrumbs?array<string>description?stringitem_number?stringavailability?stringreview_count?integercurl -X GET 'https://api.piloterr.com/v2/costco/product?query=string'{ "url": "https://www.costco.com/p/-/mohawk-home-6mm-thick-94in-x-478in-22-mil-waterproof-luxury-vinyl-plank-flooring-1565-sq-ftctn/4000266385", "name": "Mohawk Home 6MM Thick 9.4in X 47.8in 22 MIL Waterproof Luxury Vinyl Plank Flooring (15.65 sq ft/ctn)", "brand": "Mohawk Home", "price": 47.99, "images": [ "https://bfasset.costco-static.com/U447IH35/as/44xhpxq9ttr6nhpr4trsx53/4000266385-847_bloomingtonoak_1?auto=webp&format=jpg", "https://bfasset.costco-static.com/U447IH35/as/6wxn2893r8g35r5p98jnkw2v/4000266385-847_tudoroak_1?auto=webp&format=jpg&width=727&height=727&fit=bounds&canvas=727%2C727" ], "rating": 3.68, "region": "www.costco.com", "currency": "USD", "image_url": "https://bfasset.costco-static.com/U447IH35/as/44xhpxq9ttr6nhpr4trsx53/4000266385-847_bloomingtonoak_1?auto=webp&format=jpg", "product_id": "4000266385", "breadcrumbs": [ "Home Improvement", "Flooring", "Vinyl Flooring" ], "description": "SplashDefense® 100% Waterproof and Water-tight Joints;CleanProtect® Technology with Antimicrobial Properties Built in to Protect the Floor;Wide Plank Vinyl Flooring, 5mm Thick Plank + 1mm Attached Pad for Fast, Easy Installation and No Underlayment Required", "item_number": "1806569", "availability": "in_stock", "review_count": 84}