baccarat.com APIbaccarat.com ↗
Access Baccarat's full product catalog via API. Search products, browse categories, fetch product details, and locate stores. 5 endpoints, structured JSON.
curl -X GET 'https://api.parse.bot/scraper/57adbf4a-dd9a-4bbf-87ab-f533659637bb/search_products?limit=5&query=vase&start=0' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for products by keyword on baccarat.com. Returns a paginated list of matching products with names, IDs, prices, categories, and URLs.
| Param | Type | Description |
|---|---|---|
| limit | integer | Number of results to return per page. |
| queryrequired | string | Search keyword (e.g. 'vase', 'crystal', 'rouge 540'). |
| start | integer | Pagination offset. |
{
"type": "object",
"fields": {
"limit": "integer, page size used",
"start": "integer, pagination offset used",
"products": "array of product objects with name, id, sku, price, currency, brand, category, subcategory, subsubcategory, url, and badge",
"total_count": "integer, number of products returned in this response"
},
"sample": {
"data": {
"limit": 18,
"start": 0,
"products": [
{
"id": "MDEYEVA5",
"sku": null,
"url": "https://www.baccarat.com/en_us/home-decor/fine-pieces/vases/eye-ii-vase-MDEYEVA5.html?variation=2817432",
"name": "Eye II Vase",
"badge": "New",
"brand": "BACCARAT",
"price": 1900,
"category": "Home Decor",
"currency": "USD",
"subcategory": "Fine Pieces",
"subsubcategory": "Vases"
}
],
"total_count": 18
},
"status": "success"
}
}About the baccarat.com API
The Baccarat.com API provides access to the full Baccarat luxury crystal product catalog across 5 endpoints, returning product names, SKUs, prices, physical attributes, color variations, and high-resolution images. The get_product_detail endpoint exposes structured schema.org JSON-LD alongside designer, material, year of creation, and dimension attributes. Use search_products to query by keyword or get_category_products to paginate through specific catalog sections.
Product Search and Category Browsing
The search_products endpoint accepts a query string (e.g. 'rouge 540', 'vase', 'crystal') and returns a paginated list of matching products. Each product object includes name, id, sku, price, currency, brand, category, subcategory, subsubcategory, url, and badge. Pagination is controlled via start (offset) and limit parameters. The get_category_products endpoint works the same way but filters by a category_id string — IDs like 'gifts', 'barware-dining', 'fragrance', and 'home-decor' come from the navigation structure returned by get_navigation_categories.
Product Detail
The get_product_detail endpoint takes a full product URL or path and returns the complete product record: name, sku, price, description, images (array of URLs), variations (color options with id, color, url, and image), and an attributes object covering height, width, weight, material, color, made_in, year_of_creation, and designer. A json_ld field delivers the raw schema.org Product structured data block for downstream enrichment or SEO pipelines.
Navigation and Store Locator
get_navigation_categories requires no inputs and returns the full site navigation tree as an array of category objects, each with name, url, cgid, and a subcategories array. The cgid values are the category IDs expected by get_category_products. The find_store endpoint returns the URL to Baccarat's official store locator page alongside an informational message — useful for directing end-users to physical boutique lookup without hardcoding the URL.
- Build a Baccarat product catalog browser that filters by category using
get_category_productsand displays price and badge fields. - Aggregate product attributes (material, designer, year_of_creation) from
get_product_detailto populate a luxury goods comparison tool. - Extract
json_ldstructured data for each product to feed a search index or enrich a knowledge graph. - Monitor Baccarat price changes on specific SKUs by polling
get_product_detailand comparing thepricefield over time. - Use
search_productswith fragrance or barware keywords to research product availability for a gifting or concierge application. - Map the full category hierarchy via
get_navigation_categoriesto build a site-mirror navigation component with correctcgidreferences. - Pull color variation arrays from
get_product_detailto display all available finishes for a given product in a custom storefront.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Baccarat have an official developer API?+
What does `get_product_detail` return beyond basic price and name?+
attributes object with physical fields — height, width, weight, material, color, made_in, year_of_creation, and designer — plus an array of variations (each with id, color name, url, and image), an array of images, a description string, and a json_ld block containing schema.org Product structured data.How do I know which category IDs to pass to `get_category_products`?+
get_navigation_categories first. It returns the full navigation tree with a cgid field on each category object. Pass that cgid value as the category_id parameter. Examples include 'gifts', 'barware-dining', 'fragrance', and 'home-decor'.Does the API return customer reviews or ratings for products?+
Are stock availability or inventory levels included in the responses?+
search_products, get_category_products, or get_product_detail. Those endpoints return price, SKU, badge, and attributes. You can fork this API on Parse and revise it to surface inventory or availability signals if that data is accessible on the product page.