Retail pricing and availability monitoring
Mit Costco-Endpunkten verwandelst du retail pricing and availability monitoring in wiederholbare API-Requests mit dokumentierten Inputs und JSON-Antworten.
Turn Costco's public product data into structured retail data — keyword product search, full product detail with pricing, delivery-availability estimates, reviews, category facets, and nearby-warehouse lookup, all as normalized JSON. Credential-free.
Search Costco products and get product detail, availability, reviews, category facets, and nearby warehouses as structured JSON.
Endpunkt-Familien
4
Dokumentierte Parameter
16
Beispiele
6
Live-Katalog-Snapshot
Aktive Endpunkte
6
Methoden
GET
Pflichtparameter
13
Schema-Referenzen
6
{
"platform": "Costco",
"endpoint": "costco-search",
"method": "GET",
"path": "/costco/search",
"auth": "apiKey"
}Use Cases
Search Costco products and get product detail, availability, reviews, category facets, and nearby warehouses as structured JSON.
Mit Costco-Endpunkten verwandelst du retail pricing and availability monitoring in wiederholbare API-Requests mit dokumentierten Inputs und JSON-Antworten.
Mit Costco-Endpunkten verwandelst du product and category research in wiederholbare API-Requests mit dokumentierten Inputs und JSON-Antworten.
Mit Costco-Endpunkten verwandelst du review and rating collection in wiederholbare API-Requests mit dokumentierten Inputs und JSON-Antworten.
Managed Execution
Jede Zahl unten stammt direkt aus dem Live-Costco-Endpunktkatalog — 6 Endpunkte, 16 dokumentierte Request-Parameter und 6 veröffentlichte Response-Schemas — demselben Katalog, gegen den auch Docs und Playground laufen.
6 documented Costco endpoints, grouped into 4 request families — Product, Categories and Search, plus 1 more.
16 request parameters are documented across those Costco endpoints, 13 of them required — the full input contract is public before you write any integration code.
6 of the 6 Costco endpoints ship a recorded example response, and 6 carry a documented response schema — you can code against the real JSON before the first request.
Costco endpoints document their error responses (400, 404, 500 and 503) alongside the success schema, so a block, a rate limit, or a missing record comes back as a typed error rather than silently empty data.
6 hosted MCP tools back the Costco endpoints, so an agent can call the same routes with the same parameters and the same JSON contract, with no custom glue.
Abdeckungskarte
/costco/product/{id}
/costco/categories
/costco/search
/costco/warehouses
Endpunktkatalog
/costco/searchReturns 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.
Hinweise zur Response
- Each result's `id` is usable directly as the `id` path parameter to [`/costco/product/{id}`](costco-product.md). - A missing `query` and `category` returns `400` before any upstream request is made. - When the GDX search service is blocked, query-only requests may use a partial fallback. In that response, `source` is `product_sitemap` and `is_partial` is `true`. The `total_count` then counts product URL slugs matching the query, not Costco's GDX result count, and the order follows Costco's product sitemap rather than GDX relevance. Other source values are not currently returned; `source` is omitted for complete GDX results. - The product-sitemap fallback does not handle category filters and does not return success when no product slug matches the query. - If GDX is blocked, text-only queries may fall back to actual products from Costco's public product sitemap, enriched from its product GraphQL API. Those responses include `source: "product_sitemap"` and `is_partial: true`. In that case `total_count` counts matching sitemap URL slugs, the product order follows the sitemap, and results may be fewer than Costco's GDX result set. This fallback is not used for category-filtered queries or when no sitemap product matches; those calls continue returning an upstream error.
MCP-Tool costco_search
/costco/product/{id}Returns a Costco product's detail: title, description, manufacturer, image, price, stock status, and rating. Public data sourced from Costco's own product backend.
Hinweise zur Response
- `description` is Costco's own long-form description field for the product; for many products this is legal/compliance boilerplate (e.g. a California Prop 65 warning) rather than marketing copy — treat it as supplementary, not guaranteed to be useful prose. - `buyable` reflects Costco's own purchase-eligibility flag for the product, independent of `rating`/`rating_count`. - `membership_required` is `true` for a small number of products that require an active Costco membership to purchase online. - An unrecognized `id` returns `404`. - A missing `id` returns `400` before any upstream request is made.
MCP-Tool costco_product
/costco/product/{id}/availabilityReturns a Costco product's stock and estimated-delivery status for a delivery destination. Public data sourced from Costco's own fulfillment backend.
Hinweise zur Response
- `availability`/`available_for_sale` reflect real-time stock status for the given destination, distinct from [`/costco/product/{id}`](costco-product.md)'s `buyable` flag (which is a general purchase-eligibility flag, not destination-specific). - `estimated_delivery_date` and `supplier_available_date` are ISO 8601 timestamps (no timezone offset — Costco returns these as local wall-clock dates). - A missing `id`, `postal_code`, or `state` returns `400` before any upstream request is made.
MCP-Tool costco_product_availability
/costco/product/{id}/reviewsReturns 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.
Hinweise zur Response
- `average_rating` is computed from the returned page of reviews, not Costco's own site-wide aggregate — for the full aggregate, use `rating`/`rating_count` on [`/costco/product/{id}`](costco-product.md). - `total_count` is the total number of reviews available for the product, independent of how many are returned in this page. - A missing `id` returns `400` before any upstream request is made.
MCP-Tool costco_product_reviews
/costco/categoriesReturns 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.
Hinweise zur Response
- This is a **query-scoped** category breakdown, not a claim of Costco's complete category taxonomy — Costco's own backend caps the category facet list at roughly 50 entries regardless of query, the same limit its own site's "Show more options" filter sidebar is bound by. - `name` is derived by title-casing each category `slug`'s hyphen-separated words (e.g. `compact-refrigerators` -> `"Compact Refrigerators"`), confirmed to reproduce Costco's own category display text.
MCP-Tool costco_categories
/costco/warehousesReturns 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.
Hinweise zur Response
- `distance_miles` is straight-line distance from the given coordinates. - Only physical warehouse locations are returned; nearby distribution centers and other non-warehouse sales locations Costco's own locator API returns internally are filtered out. - Missing or zero-valued `latitude`/`longitude` returns `400` before any upstream request is made.
MCP-Tool costco_warehouses
Verwandte APIs
Marketplaces & Retail
Research new, used, and vintage instruments across Reverb listings, seller shops, and the Price Guide. Keep current asking prices separate from historical sales, and preserve model, finish, year, condition, and currency when comparing gear.
Marketplaces & Retail
Collect marketplace product signals from Amazon without building brittle storefront scrapers.
Marketplaces & Retail
Build resale, pricing, and marketplace workflows from structured eBay data.
Unternehmensabdeckung
Costco Wholesale Corporation · COST
Costco wird von Costco Wholesale Corporation (COST) betrieben. Crawloras SEC-Endpunkte nutzen dieselbe CIK dieses Unternehmens, sodass Filings, Finanzdaten, Insider-Transaktionen und 13F-Beteiligungen mit demselben API-Key wie die Costco-Endpunkte oben abrufbar sind.
SEC-Filings & Finanzdaten-API →So scrapst du Costco
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.
Agent Skills
Installiere einen Crawlora Agent Skill, und dein Agent ruft Costco-Daten als JSON über die dokumentierte API ab, ohne einen Scraper zu schreiben. Diese Skills decken Costco ab:
Researches Costco products, categories, warehouse stock/availability, and reviews using the Crawlora API, returning clean JSON. Use when the user…
npx skills add github.com/Crawlora-org/crawlora-skills --skill costco-researchResearch products, prices, sellers, and reviews across major online marketplaces and retailers, including African Jumia storefronts. Use when the…
npx skills add github.com/Crawlora-org/crawlora-skills --skill product-price-researchFAQ
Send a keyword to Crawlora's /costco/search endpoint and get normalized product cards — title, price, image — as structured JSON, no Costco membership required.
Yes, but you must supply a destination: /costco/product/{id}/availability requires postal_code and state alongside the product id, and a call without them returns a 400. Delivery estimates are inherently per-address, so there is no location-free answer to fall back on.
Yes — /costco/warehouses takes latitude and longitude, both required, rather than a postal code or city name. Resolve your location to coordinates first, then call it.
No Costco membership, login, or account is required from the caller — only your Crawlora API key.
On 2026-10-27 the term tv matched accessories as well as televisions, so narrow with a category.