Luxury ready-to-wear and accessories pricing monitoring
Balenciagaエンドポイントを使えば、「Luxury ready-to-wear and accessories pricing monitoring」をドキュメント化された入力とJSONレスポンスによる再現可能なAPIリクエストに変えられます。
Turn Balenciaga's own public storefront into structured JSON — a full category taxonomy, keyword and category browsing through Balenciaga's own Search-ShowAjax listing fragment with live facet counts, full product detail sourced from each page's own schema.org markup, the complete color/size variation matrix, and the worldwide boutique locator by country. Normalized JSON, credential-free.
Browse Balenciaga's category tree, search with live facets, get full product detail with variants, and look up boutiques by country as structured JSON.
エンドポイントファミリー
6
ドキュメント化されたパラメータ
19
サンプル数
7
ライブカタログスナップショット
稼働エンドポイント
7
メソッド
GET
必須パラメータ
12
スキーマ参照
7
{
"platform": "Balenciaga",
"endpoint": "balenciaga-search",
"method": "GET",
"path": "/balenciaga/search",
"auth": "apiKey"
}ユースケース
Browse Balenciaga's category tree, search with live facets, get full product detail with variants, and look up boutiques by country as structured JSON.
Balenciagaエンドポイントを使えば、「Luxury ready-to-wear and accessories pricing monitoring」をドキュメント化された入力とJSONレスポンスによる再現可能なAPIリクエストに変えられます。
Balenciagaエンドポイントを使えば、「Category assortment and facet-driven merchandising research」をドキュメント化された入力とJSONレスポンスによる再現可能なAPIリクエストに変えられます。
Balenciagaエンドポイントを使えば、「Boutique network and market-availability mapping」をドキュメント化された入力とJSONレスポンスによる再現可能なAPIリクエストに変えられます。
マネージド実行
以下の数値はすべて、稼働中のBalenciagaエンドポイントカタログから取得しています（エンドポイント7件、ドキュメント化されたリクエストパラメータ19個、公開レスポンススキーマ7件）。DocsとPlaygroundが参照しているカタログと同じものです。
Balenciagaのエンドポイントは7件、6つのリクエストファミリーに分類されています（Product、Categories、Categoryほか3件）。
これらのBalenciagaエンドポイントには19個のリクエストパラメータがドキュメント化されており、うち12個が必須です。統合コードを書く前に入力仕様をすべて確認できます。
7件のBalenciagaエンドポイントのうち7件が実際のサンプルレスポンスを、7件がドキュメント化されたレスポンススキーマを備えています。最初のリクエストの前に実データの形に合わせて実装できます。
Balenciagaのエンドポイントは成功時のスキーマに加えてエラーレスポンス（400、404、429、503）もドキュメント化しています。ブロック、レート制限、レコード欠損は空データではなく型付きのエラーとして返ります。
Balenciagaのエンドポイントは7個のホスト型MCPツールとして提供されており、エージェントは同じパラメータと同じJSON契約のまま、追加の実装なしに同じルートを呼び出せます。
カバレッジマップ
これらのカードは稼働中のエンドポイントカタログから生成されるため、このページはDocsとPlaygroundが使うAPIサーフェスをそのまま反映します。
/balenciaga/product
/balenciaga/categories
/balenciaga/category
/balenciaga/search
/balenciaga/store-countries
/balenciaga/stores
エンドポイントカタログ
/balenciaga/searchSearches Balenciaga's storefront by keyword using the site's own product-grid fragment. q is required; sort accepts latest, price_ascending, or price_descending; page is one-based with 12 products per page; and filters accepts comma-separated exact field:value pairs from live facets. Repeat a field to OR multiple values within that facet. A genuine no-result query returns an empty products list.
レスポンスに関する注記
- Search uses the product-grid fragments fired by Balenciaga's own sort and load-more controls. - Search filters are passed to the same storefront facet parameters as the live UI; different facet fields are combined, and repeated values within one field are ORed upstream. - A genuine no-result query returns `count: 0` and `products: []`. - Product URLs in the response can be passed directly to `balenciaga-product`. Example response: ```json { "code": 200, "msg": "OK", "data": { "query": "hourglass", "sort": "latest", "country": "ZW", "language": "en", "page": 1, "limit": 12, "count": 1, "total_results": 35, "products": [ { "product_id": "A007IH2ACT21000", "name": "HOURGLASS AVENUE TOP HANDLE BAG SMALL", "url": "https://www.balenciaga.com/en-en/hourglass-avenue-top-handle-bag-small-black-A007IH2ACT21000.html" } ] } } ```
MCPツール balenciaga_search
/balenciaga/categoryReturns one Balenciaga category listing from the site's own Search-ShowAjax fragment. path comes from balenciaga-categories. sort accepts latest, price_ascending, or price_descending. filters is a comma-separated list of exact field:value pairs from the response's live facets; repeat a field to OR multiple values within that facet; omit it for an unfiltered listing.
レスポンスに関する注記
- The endpoint uses Balenciaga's own `Search-ShowAjax` HTML fragment and returns its live total and facet counts. - `sort` values map to the upstream values `NewIn`, `PriceAscending`, and `PriceDescending`. - Do not invent facet values; use a prior response's `facets` values. Example response: ```json { "code": 200, "msg": "OK", "data": { "path": "/en-en/women/bags-for-women/handbags", "country": "ZW", "language": "en", "sort": "latest", "page": 1, "limit": 16, "count": 1, "total_results": 148, "total_pages": 10, "products": [ { "product_id": "A007IH2ACT21000", "name": "HOURGLASS AVENUE TOP HANDLE BAG SMALL", "currency": "USD", "in_stock": true, "url": "https://www.balenciaga.com/en-en/hourglass-avenue-top-handle-bag-small-black-A007IH2ACT21000.html" } ] } } ```
MCPツール balenciaga_category
/balenciaga/categoriesReturns Balenciaga's live storefront navigation/category taxonomy. Each categories[].path is the exact value accepted by balenciaga-category's path parameter.
レスポンスに関する注記
- The taxonomy is read from Balenciaga's own navigation links. - `country` is `ZW` and `language` is `en` for this first validated storefront contract. Example response: ```json { "code": 200, "msg": "OK", "data": { "country": "ZW", "language": "en", "count": 2, "categories": [ { "id": "women_bags_handbags", "name": "Handbags", "department": "Women", "path": "/en-en/women/bags-for-women/handbags", "url": "https://www.balenciaga.com/en-en/women/bags-for-women/handbags" } ] } } ```
MCPツール balenciaga_categories
/balenciaga/productReturns structured product detail from Balenciaga's product page, including schema.org name/SKU/price/availability, images, color variants, and visible product details. url must be a product URL returned by balenciaga-category or balenciaga-search.
レスポンスに関する注記
- The product page's schema.org JSON-LD supplies the canonical name, SKU, description, price, currency, availability, and images when present. - Visible color variants, product-detail bullets, dimensions, and product-care text are included when present. Each color variant includes a `url` for the site's live `Product-Variation` request, which can be passed to `balenciaga-product-variants`. - Unknown or malformed product URLs are rejected before the upstream request. Example response: ```json { "code": 200, "msg": "OK", "data": { "product_id": "A007IH2ACT21000", "sku": "814444397", "name": "WOMEN'S HOURGLASS AVENUE TOP HANDLE BAG SMALL IN BLACK", "description": "Hourglass Avenue Top Handle Bag Small in black shiny box calfskin with aged-gold hardware.", "color": "Black", "material": "Calfskin", "dimensions": ["Length: 24 cm | 9.4\"", "Height: 18 cm | 7.1\""], "product_care": "Wipe with a soft, dry cloth. Keep away from heat.", "currency": "USD", "in_stock": true, "url": "https://www.balenciaga.com/en-en/hourglass-avenue-top-handle-bag-small-black-A007IH2ACT21000.html" } } ```
MCPツール balenciaga_product
/balenciaga/product/variantsReturns Balenciaga's live color/size variation matrix for a product, including variation ids, selection/sellability flags, care text, availability, and related product ids. url may be a product URL or a Product-Variation URL from balenciaga-product's colors[].url.
MCPツール balenciaga_product_variants
/balenciaga/storesReturns Balenciaga's public physical-store directory for one country, including addresses, coordinates, phone numbers, opening hours, and store-service flags. Use balenciaga-store-countries to discover the complete accepted country enum.
MCPツール balenciaga_stores
/balenciaga/store-countriesReturns every country code accepted by balenciaga-stores, discovered from Balenciaga's own public store-locator form.
MCPツール balenciaga_store_countries
関連API
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.
Marketplaces & Retail
Turn public Shop.app product and merchant pages into structured JSON for e-commerce product intelligence, price research, shop monitoring, and marketplace discovery workflows.
Balenciagaのスクレイピング方法
Crawlora's seven Balenciaga endpoints return category, search, product, variant, and store data as normalized JSON with one API key — category and search share the same product-grid and facet shape, since both read Balenciaga's own live listing fragments.
Call /balenciaga/categories for the full navigation/category taxonomy, each with a path usable directly on /balenciaga/category. Both /balenciaga/category and /balenciaga/search accept sort (latest, price_ascending, or price_descending), page, and a comma-separated filters list of exact field:value pairs — read the response's own live facets (e.g. akeneo_macroColor:BLACK) rather than inventing values, and repeat a field to OR multiple values within it.
Send q to /balenciaga/search for keyword search across the full catalogue, 12 products per page. total_results is Balenciaga's own true match count independent of the page size, and a genuine no-result query returns count: 0 with an empty products array.
Pass a product url from any search/category/store result to /balenciaga/product — its schema.org JSON-LD supplies name, SKU, description, price, currency, availability, and images, plus visible color variants, dimensions, and care text when present. Each color variant carries its own url for /balenciaga/product/variants, which returns the live color/size matrix with per-value selectability and sellable_online flags.
Call /balenciaga/store-countries for the live country-code list Balenciaga's own locator form publishes, then pass one to /balenciaga/stores for every boutique in that country — city, address, coordinates, phone, hours, and capability flags (appointments, reserve_in_store, pickup). An accepted country with no stores returns an empty list rather than an error.
FAQ
Read them from a prior response's own facets field rather than guessing — /balenciaga/search and /balenciaga/category expose live facet groups (color, category, material, selling line, stone, size, and more) with their currently valid values, which filters accepts as comma-separated field:value pairs.
A /balenciaga/product result's color variants each include their own url for the site's live Product-Variation request. Pass that url (or the original product page url) to /balenciaga/product/variants for the full color/size attribute matrix, including which combinations are selectable and sellable online.
Yes — filters on /balenciaga/search and /balenciaga/category is a comma-separated list of field:value pairs; different facet fields AND together, and repeating the same field ORs its values, for example akeneo_macroColor:BLACK,akeneo_macroColor:WHITE.
Call /balenciaga/store-countries first for the live list of accepted country codes, then pass one to /balenciaga/stores' required country parameter for every boutique the public locator publishes there.
No — only your Crawlora API key. Balenciaga's category, search, product, variant, and store data are collected from its public, credential-free storefront and locator pages.