Retail pricing and availability monitoring
Costcoエンドポイントを使えば、「Retail pricing and availability monitoring」をドキュメント化された入力とJSONレスポンスによる再現可能なAPIリクエストに変えられます。
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.
エンドポイントファミリー
4
ドキュメント化されたパラメータ
16
サンプル数
6
ライブカタログスナップショット
稼働エンドポイント
6
メソッド
GET
必須パラメータ
13
スキーマ参照
6
{
"platform": "Costco",
"endpoint": "costco-search",
"method": "GET",
"path": "/costco/search",
"auth": "apiKey"
}ユースケース
Search Costco products and get product detail, availability, reviews, category facets, and nearby warehouses as structured JSON.
Costcoエンドポイントを使えば、「Retail pricing and availability monitoring」をドキュメント化された入力とJSONレスポンスによる再現可能なAPIリクエストに変えられます。
Costcoエンドポイントを使えば、「Product and category research」をドキュメント化された入力とJSONレスポンスによる再現可能なAPIリクエストに変えられます。
Costcoエンドポイントを使えば、「Review and rating collection」をドキュメント化された入力とJSONレスポンスによる再現可能なAPIリクエストに変えられます。
マネージド実行
以下の数値はすべて、稼働中のCostcoエンドポイントカタログから取得しています(エンドポイント6件、ドキュメント化されたリクエストパラメータ16個、公開レスポンススキーマ6件)。DocsとPlaygroundが参照しているカタログと同じものです。
Costcoのエンドポイントは6件、4つのリクエストファミリーに分類されています(Product、Categories、Searchほか1件)。
これらのCostcoエンドポイントには16個のリクエストパラメータがドキュメント化されており、うち13個が必須です。統合コードを書く前に入力仕様をすべて確認できます。
6件のCostcoエンドポイントのうち6件が実際のサンプルレスポンスを、6件がドキュメント化されたレスポンススキーマを備えています。最初のリクエストの前に実データの形に合わせて実装できます。
Costcoのエンドポイントは成功時のスキーマに加えてエラーレスポンス(400、404、500、503)もドキュメント化しています。ブロック、レート制限、レコード欠損は空データではなく型付きのエラーとして返ります。
Costcoのエンドポイントは6個のホスト型MCPツールとして提供されており、エージェントは同じパラメータと同じJSON契約のまま、追加の実装なしに同じルートを呼び出せます。
カバレッジマップ
/costco/product/{id}
/costco/categories
/costco/search
/costco/warehouses
エンドポイントカタログ
/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.
レスポンスに関する注記
- 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ツール 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.
レスポンスに関する注記
- `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ツール 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.
レスポンスに関する注記
- `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ツール 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.
レスポンスに関する注記
- `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ツール 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.
レスポンスに関する注記
- 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ツール 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.
レスポンスに関する注記
- `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ツール costco_warehouses
関連API
Marketplaces & Retail
Separate an auction that is still open from a completed sale, and use BaT's own make and model directory to carry valid IDs into search and price-history requests.
Marketplaces & Retail
Treat Glovo as a local marketplace: discover the supported city first, then follow that city's category, store, menu, and collection identifiers through the catalog.
Marketplaces & Retail
Use PetSmart's hierarchical paths to scope product searches, then keep product SKU, price range, online availability, pickup eligibility, and store inventory as separate fields.
対象企業
Costco Wholesale Corporation · COST
Costcoを運営するのはCostco Wholesale Corporation(COST)です。CrawloraのSECエンドポイントは同じ企業のCIKを受け取るため、提出書類・財務・インサイダー取引・13F保有を上記のCostcoエンドポイントと同じAPIキーで取得できます。
SEC提出書類・財務API →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.
エージェントスキル
Crawlora のエージェントスキルをインストールすると、スクレイパーを書かずに、ドキュメント化された API 経由で Costco のデータを JSON として取得できます。Costco に対応するスキル:
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.