GET/gucci/categoriesapiKey3 credits/request
Returns Gucci's full department/category/subcategory taxonomy, sourced directly from the site's own header navigation menu. Each entry's category value is exactly what gucci-category's own category parameter accepts. Filter to one department with department (e.g. women, men); omit for every department -- see the response's own departments field for the live list of top-level department labels to filter by.
Optional: department.
Sampled 14 Oct 2026: 4 fields returned with a value. In the sample: country: “us”; departments: 13 entries; language: “en”; categories: 184 entries.
Open in Playground
GET/gucci/categoryapiKey3 credits/request
Returns one Gucci category/browse listing: products (name, price, colors, images, stock) plus the upstream's own product count, page count, sibling-category counts, and sort options. category comes from gucci-categories' own category field. page selects how many of the upstream's own batches to accumulate -- Gucci's own category pages page this way: requesting page=N returns every product from page 1 through page N combined (its own "Load All" button simply requests the last page), not a single page's worth. Defaults to 1 (the upstream's own first batch, 36 products); request page equal to the response's own pages_count to fetch a category's complete listing in one call.
Required: category. Optional: page.
Sampled 14 Oct 2026: 36 items. Filled in every item: style_code, name, variation_description, price, currency, colors, images, url and 3 more. In the sample: price: 1,450 to 3,950, median 2,390; name: “Paparazzo large top handle bag” and 21 other values; url: gucci.com; in_stock: true in 36 of 36; colors: median 1 entry; variation_description: “black leather” and 8 other values; images: median 10 entries; in_stock_online: true in 36 of 36.
Open in Playground
GET/gucci/productapiKey2 credits/request
Returns product detail for one style: name, price, images, stock, and PDP attributes available from Gucci's current storefront, including description, breadcrumbs, SKU, colors, materials, and sizes. style_code comes from gucci-search's or gucci-category's own style_code field. PDP-only fields are omitted if the detail page is unavailable.
Required: style_code.
Sampled 14 Oct 2026: 18 fields returned with a value. In the sample: price: 4,450; name: “Bamboo Tote large bag”; url: gucci.com; in_stock: true; description: 287 characters; colors: 1 entry; brand: “Gucci”; materials: 1 entry.
Open in Playground
GET/gucci/recommendationsapiKey3 credits/request
Returns one Gucci recommendations shelf: product summaries (name, price, image, stock) from either a given product's own "You May Also Like" carousel (style_code set) or the site's general trending-items shelf (style_code omitted). style_code comes from gucci-search's or gucci-category's own style_code field.
Optional: style_code, max.
Sampled 14 Oct 2026: 10 items. Filled in every item: style_code, name, price, currency, image_url, url, in_stock_online, in_stock_stores. In the sample: price: 2,065 to 4,600, median 4,150; name: “Bamboo Tote large bag” and 8 other values; image_url: media.gucci.com; in_stock_online: true in 10 of 10; url: gucci.com; in_stock_stores: true in 10 of 10.
Open in Playground
GET/gucci/searchapiKey2 credits/request
Searches Gucci's US product catalog by keyword using the storefront's public catalog. Results include card-level data and the live total count; per-product colors, materials, sizes, gender, and line are omitted when the search source does not provide them. A genuinely empty result returns a well-formed empty products list. The response's size_facets field lists live size values and counts -- pass one as size on a follow-up call to filter.
Required: q. Optional: page, limit, size.
Sampled 14 Oct 2026: 24 items. Filled in every item: style_code, name, brand, price, currency, images, thumbnail_url, url and 3 more. In the sample: price: 430 to 720, median 590; name: “GG Marmont reversible belt” and 15 other values; thumbnail_url: media.gucci.com; in_stock: true in 24 of 24; images: median 6 entries; url: gucci.com; in_stock_online: true in 24 of 24; in_stock_stores: true in 24 of 24.
Open in Playground
GET/gucci/size-guideapiKey3 credits/request
Returns Gucci's own size-conversion chart for one product style, as a plain header row plus data rows. Not every style carries one -- a one-size accessory (a bag, a scarf) returns available: false with no headers/rows, a well-formed signal rather than an error. style_code comes from gucci-search's or gucci-category's own style_code field.
Required: style_code.
Sampled 14 Oct 2026: 5 fields returned with a value. In the sample: title: “MEN'S SHOES”; available: true; headers: 8 entries; rows: 27 entries.
Open in Playground
GET/gucci/storeapiKey3 credits/request
Returns one Gucci store's full detail: name, phone, address, opening hours, and photos. slug comes from gucci-stores' own slug field.
Required: slug.
Sampled 14 Oct 2026: 2 items. Filled in every item: days, opens, closes. In the sample: opens: “10:00” and 1 other value; days: median 1 entry; closes: “19:00” and 1 other value.
Open in Playground
GET/gucci/storesapiKey3 credits/request
Returns Gucci's full US store-locator listing: name, address, phone, coordinates, product departments carried, and a link to book an in-store appointment for each location. Filter to stores carrying one department with department (e.g. jewelry, mens_shoes); omit for every store -- see the response's own departments field for the live list of department tags to filter by.
Optional: department.
Sampled 14 Oct 2026: 96 items. Filled in every item: store_code, slug, name, type, address, city, latitude, longitude and 1 more. Not in every item: phone (95), departments (95), book_appointment_url (82). In the sample: type: store (84), flagship (12); name: “Chicago Flagship” and 95 other values; book_appointment_url: gucci.com; departments: median 12 entries; city: “Chicago, Illinois, 60611, United States” and 80 other values; url: gucci.com.
Open in Playground
GET/gucci/stores/searchapiKey3 credits/request
Searches Gucci's public store-map GeoJSON feed for locations inside the requested viewport. market selects the storefront locale and localized labels; it does not filter results by country. The supported, live-verified market values are ca (English), fr (French), jp (Japanese), uk (English), and us (English). Coordinates and viewport bounds determine the returned stores. The Gucci site's text field geocodes in the browser and its name parameter does not filter this feed, so callers must provide bounds and a center (geocode a place before calling). Dateline-crossing bounds are not supported.
Required: market (5 allowed values: ca, fr, jp, uk, us), north, west, south, east, latitude, longitude.
Sampled 14 Oct 2026: 16 items. Filled in every item: number, active, name, type, latitude, longitude, categories. In the sample: type: store (14), flagship (2); name: “London Bond Street Flagship” and 15 other values; active: true in 16 of 16; categories: median 7 entries.
Open in Playground
GET/gucci/suggestapiKey1 credit/request
Returns Gucci's own search-box typeahead suggestions for a partial query. The current public suggestion source does not provide per-phrase result counts. Not product data -- pass a suggestion's query into gucci-search for results.
Required: q. Optional: limit.
Sampled 14 Oct 2026: 5 items. Filled in every item: query. In the sample: query: “belts” and 4 other values.
Open in Playground