API Reference
Search Costco products and get product detail, availability, reviews, category facets, and nearby warehouses as structured JSON. 6 endpoints documented below.
curl "https://api.crawlora.net/api/v1/costco/search?query=refrigerator" \
-H "x-api-key: $CRAWLORA_API_KEY"Crawlora's Costco endpoints return product search, detail, availability, reviews, categories, and warehouse lookup as normalized JSON with one API key — no Costco membership or account required. A pull on 2026-10-27 showed a tv search returning 378 products with a wall mount first, 47 warehouses near Seattle, and a categories route that hit upstream rate limiting.
Send a keyword to /costco/search for normalized product cards; an optional category narrows it. Both parameters are optional, and the response reports Costco's own total match count alongside the page — a search for coffee returns 24 cards out of 478 matches.
Pass a product id from a search result to /costco/product/{id} for full detail and pricing.
/costco/product/{id}/availability needs a location as well as the id — postal_code and state are both required, and omitting either returns a 400 rather than a national default. That is the point of the endpoint: delivery estimates are per-destination, so the same product answers differently by address.
/costco/product/{id}/reviews returns that product's reviews; unlike availability it needs only the id.
/costco/warehouses takes a latitude and longitude — both required — for nearby warehouse lookup, and /costco/categories returns category facets, optionally scoped by a query.
search for tv reported total_count 378 and 24 products per page, and the first was an ErgoAV Full Motion 43-90 inch TV Wall Mount rated 4.57. Short terms match accessories, so filter by category.
warehouses for 47.6, -122.3 returned 47 warehouses; the first, Seattle (id 1, 4401 4TH AVE S), was 2.8 miles away, with distance_miles on each row.
categories answered once with an upstream 429, so retry with backoff.
/costco/categoriesapiKey1 credit/requestReturns Costco category slugs and product counts relevant to an optional search term, each slug usable directly with GET /costco/search's category filter. Public data sourced from Costco's own search backend.
Optional: query.
Sampled 14 Oct 2026: 50 items. Filled in every item: slug, name, count. In the sample: count: 4 to 408, median 13; name: “Appliances” and 49 other values.
/costco/product/{id}apiKey3 credits/requestReturns a Costco product's detail: title, description, manufacturer, image, price, stock status, and rating. Public data sourced from Costco's own product backend.
Required: id.
Sampled 14 Oct 2026: 9 fields returned with a value. In the sample: price: 1,399.99; manufacturer: “LG ELECTRONICS USA INC”; image_url: gdx-assets.costco.com; buyable: true; title: 102 characters; description: 753 characters; rating: 4.43; rating_count: 479.
/costco/product/{id}/availabilityapiKey1 credit/requestReturns a Costco product's stock and estimated-delivery status for a delivery destination. Public data sourced from Costco's own fulfillment backend.
Required: id, postal_code, state.
Sampled 14 Oct 2026: 6 fields returned with a value. In the sample: supplier_available_date: 2026-10-14; availability: “INSTOCK”; available_for_sale: true; fulfilled_by: “Innovel”; estimated_delivery_date: 2026-10-16.
/costco/product/{id}/reviewsapiKey3 credits/requestReturns a page of a Costco product's reviews: title, text, rating, author, and recommendation for each. Public data sourced from Costco's own review platform.
Required: id.
Sampled 14 Oct 2026: 20 items. Filled in every item: id, text, rating, submitted_at. Not in every item: title (18), author (19), recommended (11). In the sample: submitted_at: 2025-04-26 to 2026-09-24; rating: 1 to 5, median 4; recommended: true in 11 of 11; text: median 528 characters.
/costco/searchapiKey3 credits/requestReturns public Costco products matching a text query and/or a category slug: title, brand, model, image, and rating for each result. GDX is primary; if GDX is blocked, query-only searches may return explicitly partial product-sitemap results.
Optional: query, category.
Sampled 14 Oct 2026: 24 items. Filled in every item: id, url, title, brand, model, image_url, categories. Not in every item: rating (23), rating_count (23). In the sample: brand: Whirlpool (6), LG (5), Samsung (4) and 5 more; rating: 3.03 to 4.55, median 4.09; title: “LG 20 cu. ft. Top Freezer Refrigerator” and 23 other values; url: costco.com; categories: median 3 entries; model: “LTCS20020V” and 23 other values; image_url: gdx-assets.costco.com and 1 other host; rating_count: 11 to 2,008, median 410.
/costco/warehousesapiKey1 credit/requestReturns Costco warehouses near a latitude/longitude, sorted by distance: name, address, and distance for each. Public data sourced from Costco's own warehouse locator backend.
Required: latitude, longitude.
Sampled 14 Oct 2026: 47 items. Filled in every item: id, name, type, address_line1, city, state, postal_code, latitude and 2 more. In the sample: state: WA (30), BC (10), OR (7); distance_miles: 0.08 to 173.08, median 85.27; name: “Seattle” and 46 other values; city: “SEATTLE” and 44 other values.
Results from the 7 days to 14 Oct 2026. Current status
| Endpoint | Request | Checks passed | Median response |
|---|---|---|---|
| Get Costco category facets | GET /costco/categories?query=refrigerator | 100% | 2.49 s |
| Get a Costco product's detail | GET /costco/product/4000103922 | 100% | 2.75 s |
| Get a Costco product's delivery estimate | GET /costco/product/1942114/availability?postal_code=98101&state=WA | 100% | 1.74 s |
| Get a Costco product's reviews | GET /costco/product/4000354684/reviews | 99.9% | 1.50 s |
| Search Costco products | GET /costco/search?query=refrigerator | 100% | 2.99 s |
| Find nearby Costco warehouses | GET /costco/warehouses?latitude=47.565&longitude=-122.329 | 100% | 2.16 s |