get_product

get_product

Get full details of a specific product by ID. Returns all variants, images, AI classification, pricing, and a direct purchase link.

Parameters

ParameterTypeRequiredDescription
product_idstringYesThe product ID

Response

{
  "id": "665a1f...",
  "title": "Classic Leather Chelsea Boot",
  "description": "Handcrafted from full-grain Italian leather with a comfortable rubber sole...",
  "summary": "A timeless chelsea boot in black leather with pull tabs and elastic side panels.",
  "category": "Footwear",
  "subcategory": "boots",
  "style": "classic",
  "silhouette": "fitted",
  "attributes": {
    "fit": "regular"
  },
  "price": 295,
  "compareAtPrice": 350,
  "currency": "USD",
  "images": [
    "https://cdn.store.com/boot-front.jpg",
    "https://cdn.store.com/boot-side.jpg",
    "https://cdn.store.com/boot-sole.jpg"
  ],
  "variants": [
    {
      "externalId": "var_001",
      "title": "Black / 9",
      "price": 295,
      "compareAtPrice": 350,
      "sku": "CLB-BLK-9",
      "available": true
    },
    {
      "externalId": "var_002",
      "title": "Black / 10",
      "price": 295,
      "compareAtPrice": 350,
      "sku": "CLB-BLK-10",
      "available": true
    }
  ],
  "brand": "Grenson",
  "productUrl": "https://store.com/classic-chelsea-boot",
  "store": {
    "store_id": "665a1e...",
    "name": "Grenson",
    "domain": "grenson.com"
  }
}

Response fields

FieldDescription
summaryAI-generated one-line product summary
styleAI-classified style (e.g. classic, minimalist, streetwear)
silhouetteAI-classified fit (e.g. fitted, oversized, relaxed)
attributesAdditional AI-classified attributes
compareAtPriceOriginal price before discount (present when on sale)
variantsAll size/color combinations with availability and SKU
productUrlDirect link to purchase on the retailer's site
storeStore info: store_id, name, domain

Example

{
  "name": "get_product",
  "arguments": {
    "product_id": "665a1f2b3c4d5e6f7a8b9c0d"
  }
}

When to use

Use get_product after a search or discovery query when the user wants to drill into a specific item — check available sizes, see if it's on sale, view all images, or get the purchase link.