Get Agentic Search Status

cURL

# Check execution status
curl -X GET "https://api.getcatalog.ai/v2/agentic-search/agentic-a1b2c3d4-1735123456789" \
  -H "x-api-key: $CATALOG_API_KEY"

// Check execution status
const executionId = 'agentic-a1b2c3d4-1735123456789';

const response = await fetch(
  `https://api.getcatalog.ai/v2/agentic-search/${executionId}`,
  {
    headers: {
      'x-api-key': 'YOUR_API_KEY'
    }
  }
);

const data = await response.json();

if (data.status === 'completed') {
  console.log(`Search completed!`);
  console.log(`Products found: ${data.meta.result?.products_returned || 0}`);
  console.log(`Duration: ${data.meta.duration_ms}ms`);
  console.log(`Products:`, data.data);
} else if (data.status === 'running') {
  console.log('Search is still running...');
  if (data.meta.progress) {
    console.log(`Progress: ${data.meta.progress.percent_complete}% complete`);
  }
  // Optionally cancel if needed: DELETE /v2/agentic-search/{executionId}
} else if (data.status === 'failed') {
  console.error(`Search failed: ${data.error}`);
}

import requests
import time

execution_id = 'agentic-a1b2c3d4-1735123456789'

# Poll for completion
while True:
    response = requests.get(
        f'https://api.getcatalog.ai/v2/agentic-search/{execution_id}',
        headers={'x-api-key': 'YOUR_API_KEY'}
    )
    
    data = response.json()
    
    if data['status'] == 'completed':
        print(f"Search completed!")
        print(f"Products found: {data['meta'].get('result', {}).get('products_returned', 0)}")
        print(f"Duration: {data['meta']['duration_ms']}ms")
        print(f"Products: {data.get('data', [])}")
        break
    elif data['status'] == 'running':
        print('Search is still running...')
        if data['meta'].get('progress'):
            progress = data['meta']['progress']
            print(f"Progress: {progress['percent_complete']}% complete")
        # Optionally cancel if needed: DELETE /v2/agentic-search/{execution_id}
        time.sleep(5)  # Wait 5 seconds before next poll
    elif data['status'] == 'failed':
        print(f"Search failed: {data['error']}")
        break

{
  "execution_id": "agentic-589b1966-1770040673820",
  "status": "completed",
  "error": null,
  "meta": {
    "query": "A Barbour jacket suitable for the office",
    "progress": {
      "products_processed": 8,
      "products_total": 8,
      "percent_complete": 100
    },
    "start_date": "2026-02-02T13:57:54.099Z",
    "stop_date": "2026-02-02T14:03:41.281Z",
    "duration_ms": 347182,
    "result": {
      "products_returned": 8
    },
    "credits_used": 25
  },
  "data": [
    {
      "url": "https://www.barbour.com/us/cropped-beadnell-waxed-jacket-LWX1403BK71.html",
      "product": {
        "id": "8a19462a-1499-4221-9fff-fca3f036cc27",
        "title": "Cropped Beadnell Waxed Jacket",
        "description": "The Beadnell waxed jacket has been a part of Barbour's signature waxed jacket selection since 2010, offering a feminine, tailored rendition of the best-selling men's Bedale waxed jacket to the collection. This season, the Beadnell takes on a modern new look as the Barbour Cropped Beadnell Waxed Jacket displays oversized details featured on the original style. With large, gold-tone, branded snap buttons and the traditional saddle pockets, this style is complete with a cord collar and exaggerated elasticated cuffs for a contemporary touch.",
        "vendor": "barbour.com",
        "brand": "Barbour",
        "url": "https://www.barbour.com/us/cropped-beadnell-waxed-jacket-LWX1403BK71.html",
        "handle": "cropped-beadnell-waxed-jacket-lwx1403bk71",
        "is_available": true,
        "attributes": {
          "additional_attributes": [
            "cropped silhouette",
            "feminine, tailored rendition of the Bedale",
            "oversized details inspired by original style",
            "large gold-tone branded snap buttons",
            "traditional saddle pockets",
            "cord collar",
            "exaggerated elasticated cuffs",
            "waxed finish"
          ],
          "age_group": "adult",
          "gender": "female",
          "summary": "Cropped, feminine waxed jacket offering a tailored take on Barbour's Bedale with oversized details and contemporary finishes.",
          "features": "Cropped silhouette with oversized detailing; large gold-tone branded snap button closure; traditional saddle pockets; cord collar; exaggerated elasticated cuffs; waxed finish.",
          "care_instructions": "null",
          "color": {
            "iscc_family": "black",
            "merchant_label": "Black-Classic"
          },
          "closure_type": "snap",
          "style": [
            "tailored",
            "heritage",
            "modern"
          ],
          "mood": [
            "feminine"
          ],
          "additional_product_information": "The Beadnell waxed jacket is a feminine, tailored rendition of the classic Bedale waxed jacket. Key features: large gold-tone branded snap buttons, traditional saddle pockets, cord collar and exaggerated elasticated cuffs for a contemporary touch. Part of Barbour's signature waxed jacket selection since 2010. SKU: LWX1403BK71. Price: $425.00 (USD). Full-product images (multiple angles and detail shots) are provided on the product page."
        },
        "price": {
          "current_value": 425,
          "compare_at_value": 425,
          "currency": "USD"
        },
        "images": [
          {
            "url": "https://www.barbour.com/dw/image/v2/BLCL_PRD/on/demandware.static/-/Sites-master-catalog/default/dw04ac0533/images/LWX1403BK71/LWX1403BK71_01front.jpg?sw=1500&q=70",
            "alt_text": "Cropped Beadnell Waxed Jacket product image (primary)",
            "position": 1,
            "width": 1500,
            "height": 1836,
            "id": "img-1770040913273-0",
            "variant_ids": [
              "variant-1770040913275-0",
              "variant-1770040913275-1",
              "variant-1770040913275-2",
              "variant-1770040913275-3",
              "variant-1770040913275-4",
              "variant-1770040913275-5",
              "variant-1770040913275-6",
              "variant-1770040913275-7"
            ],
            "attributes": null
          },
          {
            "url": "https://www.barbour.com/dw/image/v2/BLCL_PRD/on/demandware.static/-/Sites-master-catalog/default/dw3435dec4/images/LWX1403BK71/LWX1403BK71_03getthelook.jpg?sw=1500&q=70",
            "alt_text": "Cropped Beadnell Waxed Jacket product image 2",
            "position": 2,
            "width": 1500,
            "height": 1836,
            "id": "img-1770040913273-1",
            "variant_ids": [
              "variant-1770040913275-0",
              "variant-1770040913275-1",
              "variant-1770040913275-2",
              "variant-1770040913275-3",
              "variant-1770040913275-4",
              "variant-1770040913275-5",
              "variant-1770040913275-6",
              "variant-1770040913275-7"
            ],
            "attributes": null
          },
          {
            "url": "https://www.barbour.com/dw/image/v2/BLCL_PRD/on/demandware.static/-/Sites-master-catalog/default/dw433521eb/images/LWX1403BK71/LWX1403BK71_04back.jpg?sw=1500&q=70",
            "alt_text": "Cropped Beadnell Waxed Jacket product image 3",
            "position": 3,
            "width": 1500,
            "height": 1836,
            "id": "img-1770040913273-2",
            "variant_ids": [
              "variant-1770040913275-0",
              "variant-1770040913275-1",
              "variant-1770040913275-2",
              "variant-1770040913275-3",
              "variant-1770040913275-4",
              "variant-1770040913275-5",
              "variant-1770040913275-6",
              "variant-1770040913275-7"
            ],
            "attributes": null
          },
          {
            "url": "https://www.barbour.com/dw/image/v2/BLCL_PRD/on/demandware.static/-/Sites-master-catalog/default/dwb09d0c6f/images/LWX1403BK71/LWX1403BK71_05detaila.jpg?sw=1500&q=70",
            "alt_text": "Cropped Beadnell Waxed Jacket product image 4",
            "position": 4,
            "width": 1500,
            "height": 1836,
            "id": "img-1770040913273-3",
            "variant_ids": [
              "variant-1770040913275-0",
              "variant-1770040913275-1",
              "variant-1770040913275-2",
              "variant-1770040913275-3",
              "variant-1770040913275-4",
              "variant-1770040913275-5",
              "variant-1770040913275-6",
              "variant-1770040913275-7"
            ],
            "attributes": null
          },
          {
            "url": "https://www.barbour.com/dw/image/v2/BLCL_PRD/on/demandware.static/-/Sites-master-catalog/default/dwebbb5a93/images/LWX1403BK71/LWX1403BK71_05detailb.jpg?sw=1500&q=70",
            "alt_text": "Cropped Beadnell Waxed Jacket product image 5",
            "position": 5,
            "width": 1500,
            "height": 1836,
            "id": "img-1770040913273-4",
            "variant_ids": [
              "variant-1770040913275-0",
              "variant-1770040913275-1",
              "variant-1770040913275-2",
              "variant-1770040913275-3",
              "variant-1770040913275-4",
              "variant-1770040913275-5",
              "variant-1770040913275-6",
              "variant-1770040913275-7"
            ],
            "attributes": null
          },
          {
            "url": "https://www.barbour.com/dw/image/v2/BLCL_PRD/on/demandware.static/-/Sites-master-catalog/default/dw6cc4cf07/images/LWX1403BK71/LWX1403BK71_05detailc.jpg?sw=1500&q=70",
            "alt_text": "Cropped Beadnell Waxed Jacket product image 6",
            "position": 6,
            "width": 1500,
            "height": 1836,
            "id": "img-1770040913273-5",
            "variant_ids": [
              "variant-1770040913275-0",
              "variant-1770040913275-1",
              "variant-1770040913275-2",
              "variant-1770040913275-3",
              "variant-1770040913275-4",
              "variant-1770040913275-5",
              "variant-1770040913275-6",
              "variant-1770040913275-7"
            ],
            "attributes": null
          },
          {
            "url": "https://www.barbour.com/dw/image/v2/BLCL_PRD/on/demandware.static/-/Sites-master-catalog/default/dw04f04054/images/LWX1403BK71/LWX1403BK71_05detaild.jpg?sw=1500&q=70",
            "alt_text": "Cropped Beadnell Waxed Jacket product image 7",
            "position": 7,
            "width": 1500,
            "height": 1836,
            "id": "img-1770040913273-6",
            "variant_ids": [
              "variant-1770040913275-0",
              "variant-1770040913275-1",
              "variant-1770040913275-2",
              "variant-1770040913275-3",
              "variant-1770040913275-4",
              "variant-1770040913275-5",
              "variant-1770040913275-6",
              "variant-1770040913275-7"
            ],
            "attributes": null
          }
        ],
        "options": [
          {
            "name": "Color",
            "position": 1,
            "values": [
              "Black-Classic"
            ]
          },
          {
            "name": "Size",
            "position": 2,
            "values": [
              "US 2",
              "US 4",
              "US 6",
              "US 8",
              "US 10",
              "US 12",
              "US 14",
              "US 16"
            ]
          }
        ],
        "variants": [
          {
            "id": "variant-1770040913275-0",
            "title": "Cropped Beadnell Waxed Jacket - Black-Classic - Us 2",
            "is_available": true,
            "price": {
              "current_value": 425,
              "compare_at_value": null,
              "currency": "USD"
            },
            "sku": "LWX1403BK71",
            "option1": "Black-Classic",
            "option2": "US 2",
            "url": "https://www.barbour.com/us/cropped-beadnell-waxed-jacket-LWX1403BK71.html",
            "image": {
              "url": "https://www.barbour.com/dw/image/v2/BLCL_PRD/on/demandware.static/-/Sites-master-catalog/default/dw04ac0533/images/LWX1403BK71/LWX1403BK71_01front.jpg?sw=1500&q=70",
              "alt_text": "Cropped Beadnell Waxed Jacket - Black-Classic - US 2 variant image",
              "position": 1,
              "width": 1500,
              "height": 1836,
              "id": "img-variant-variant-1770040913275-0",
              "variant_ids": [
                "variant-1770040913275-0"
              ]
            }
          },
          {
            "id": "variant-1770040913275-1",
            "title": "Cropped Beadnell Waxed Jacket - Black-Classic - Us 4",
            "is_available": true,
            "price": {
              "current_value": 425,
              "compare_at_value": null,
              "currency": "USD"
            },
            "sku": "LWX1403BK71",
            "option1": "Black-Classic",
            "option2": "US 4",
            "url": "https://www.barbour.com/us/cropped-beadnell-waxed-jacket-LWX1403BK71.html",
            "image": {
              "url": "https://www.barbour.com/dw/image/v2/BLCL_PRD/on/demandware.static/-/Sites-master-catalog/default/dw04ac0533/images/LWX1403BK71/LWX1403BK71_01front.jpg?sw=1500&q=70",
              "alt_text": "Cropped Beadnell Waxed Jacket - Black-Classic - US 4 variant image",
              "position": 2,
              "width": 1500,
              "height": 1836,
              "id": "img-variant-variant-1770040913275-1",
              "variant_ids": [
                "variant-1770040913275-1"
              ]
            }
          },
          {
            "id": "variant-1770040913275-2",
            "title": "Cropped Beadnell Waxed Jacket - Black-Classic - Us 6",
            "is_available": true,
            "price": {
              "current_value": 425,
              "compare_at_value": null,
              "currency": "USD"
            },
            "sku": "LWX1403BK71",
            "option1": "Black-Classic",
            "option2": "US 6",
            "url": "https://www.barbour.com/us/cropped-beadnell-waxed-jacket-LWX1403BK71.html",
            "image": {
              "url": "https://www.barbour.com/dw/image/v2/BLCL_PRD/on/demandware.static/-/Sites-master-catalog/default/dw04ac0533/images/LWX1403BK71/LWX1403BK71_01front.jpg?sw=1500&q=70",
              "alt_text": "Cropped Beadnell Waxed Jacket - Black-Classic - US 6 variant image",
              "position": 3,
              "width": 1500,
              "height": 1836,
              "id": "img-variant-variant-1770040913275-2",
              "variant_ids": [
                "variant-1770040913275-2"
              ]
            }
          },
          {
            "id": "variant-1770040913275-3",
            "title": "Cropped Beadnell Waxed Jacket - Black-Classic - Us 8",
            "is_available": true,
            "price": {
              "current_value": 425,
              "compare_at_value": null,
              "currency": "USD"
            },
            "sku": "LWX1403BK71",
            "option1": "Black-Classic",
            "option2": "US 8",
            "url": "https://www.barbour.com/us/cropped-beadnell-waxed-jacket-LWX1403BK71.html",
            "image": {
              "url": "https://www.barbour.com/dw/image/v2/BLCL_PRD/on/demandware.static/-/Sites-master-catalog/default/dw04ac0533/images/LWX1403BK71/LWX1403BK71_01front.jpg?sw=1500&q=70",
              "alt_text": "Cropped Beadnell Waxed Jacket - Black-Classic - US 8 variant image",
              "position": 4,
              "width": 1500,
              "height": 1836,
              "id": "img-variant-variant-1770040913275-3",
              "variant_ids": [
                "variant-1770040913275-3"
              ]
            }
          },
          {
            "id": "variant-1770040913275-4",
            "title": "Cropped Beadnell Waxed Jacket - Black-Classic - Us 10",
            "is_available": true,
            "price": {
              "current_value": 425,
              "compare_at_value": null,
              "currency": "USD"
            },
            "sku": "LWX1403BK71",
            "option1": "Black-Classic",
            "option2": "US 10",
            "url": "https://www.barbour.com/us/cropped-beadnell-waxed-jacket-LWX1403BK71.html",
            "image": {
              "url": "https://www.barbour.com/dw/image/v2/BLCL_PRD/on/demandware.static/-/Sites-master-catalog/default/dw04ac0533/images/LWX1403BK71/LWX1403BK71_01front.jpg?sw=1500&q=70",
              "alt_text": "Cropped Beadnell Waxed Jacket - Black-Classic - US 10 variant image",
              "position": 5,
              "width": 1500,
              "height": 1836,
              "id": "img-variant-variant-1770040913275-4",
              "variant_ids": [
                "variant-1770040913275-4"
              ]
            }
          },
          {
            "id": "variant-1770040913275-5",
            "title": "Cropped Beadnell Waxed Jacket - Black-Classic - Us 12",
            "is_available": true,
            "price": {
              "current_value": 425,
              "compare_at_value": null,
              "currency": "USD"
            },
            "sku": "LWX1403BK71",
            "option1": "Black-Classic",
            "option2": "US 12",
            "url": "https://www.barbour.com/us/cropped-beadnell-waxed-jacket-LWX1403BK71.html",
            "image": {
              "url": "https://www.barbour.com/dw/image/v2/BLCL_PRD/on/demandware.static/-/Sites-master-catalog/default/dw04ac0533/images/LWX1403BK71/LWX1403BK71_01front.jpg?sw=1500&q=70",
              "alt_text": "Cropped Beadnell Waxed Jacket - Black-Classic - US 12 variant image",
              "position": 6,
              "width": 1500,
              "height": 1836,
              "id": "img-variant-variant-1770040913275-5",
              "variant_ids": [
                "variant-1770040913275-5"
              ]
            }
          },
          {
            "id": "variant-1770040913275-6",
            "title": "Cropped Beadnell Waxed Jacket - Black-Classic - Us 14",
            "is_available": true,
            "price": {
              "current_value": 425,
              "compare_at_value": null,
              "currency": "USD"
            },
            "sku": "LWX1403BK71",
            "option1": "Black-Classic",
            "option2": "US 14",
            "url": "https://www.barbour.com/us/cropped-beadnell-waxed-jacket-LWX1403BK71.html",
            "image": {
              "url": "https://www.barbour.com/dw/image/v2/BLCL_PRD/on/demandware.static/-/Sites-master-catalog/default/dw04ac0533/images/LWX1403BK71/LWX1403BK71_01front.jpg?sw=1500&q=70",
              "alt_text": "Cropped Beadnell Waxed Jacket - Black-Classic - US 14 variant image",
              "position": 7,
              "width": 1500,
              "height": 1836,
              "id": "img-variant-variant-1770040913275-6",
              "variant_ids": [
                "variant-1770040913275-6"
              ]
            }
          },
          {
            "id": "variant-1770040913275-7",
            "title": "Cropped Beadnell Waxed Jacket - Black-Classic - Us 16",
            "is_available": true,
            "price": {
              "current_value": 425,
              "compare_at_value": null,
              "currency": "USD"
            },
            "sku": "LWX1403BK71",
            "option1": "Black-Classic",
            "option2": "US 16",
            "url": "https://www.barbour.com/us/cropped-beadnell-waxed-jacket-LWX1403BK71.html",
            "image": {
              "url": "https://www.barbour.com/dw/image/v2/BLCL_PRD/on/demandware.static/-/Sites-master-catalog/default/dw04ac0533/images/LWX1403BK71/LWX1403BK71_01front.jpg?sw=1500&q=70",
              "alt_text": "Cropped Beadnell Waxed Jacket - Black-Classic - US 16 variant image",
              "position": 8,
              "width": 1500,
              "height": 1836,
              "id": "img-variant-variant-1770040913275-7",
              "variant_ids": [
                "variant-1770040913275-7"
              ]
            }
          }
        ],
        "store_canonical_url": "https://www.barbour.com/",
        "store_domain": "www.barbour.com",
        "platform": null,
        "platform_id": "LWX1403BK71",
        "description_html": "*content*"
        "product_type": "JACKETS",
        "google_product_category_id": "5598",
        "google_product_category_path": "Apparel & Accessories > Clothing > Outerwear > Coats & Jackets",
        "tags": [
          "JACKETS"
        ],
        "video_url": null,
        "review_count": null,
        "average_rating": null,
        "rating_scale": 5,
        "faqs": null,
        "reviews": null,
        "updated_at": "2026-02-02T14:02:32.789Z",
        "enable_enrichment": true,
        "enable_reviews": false,
        "enable_image_tags": false,
        "enable_full_html": false,
        "similar_products": null,
        "enable_similar_products": false
      }
    },
    ...
  ],
  "pagination": {
    "page": 1,
    "page_size": 50,
    "total_items": 8,
    "total_pages": 1,
    "has_next": false,
    "has_prev": false
  }
}

{
  "execution_id": "agentic-a1b2c3d4-1735123456789",
  "status": "running",
  "error": null,
  "meta": {
    "query": "A Barbour jacket suitable for the office",
    "progress": {
      "products_processed": 0,
      "products_total": 8,
      "percent_complete": 0
    },
    "start_date": "2025-01-15T10:30:00.000Z",
    "stop_date": null,
    "duration_ms": 15000
  }
}

{
  "execution_id": "agentic-a1b2c3d4-1735123456789",
  "status": "failed",
  "error": "Execution failed. Please check the execution details or contact support.",
  "meta": {
    "query": "A Barbour jacket suitable for the office",
    "progress": null,
    "start_date": "2025-01-15T10:30:00.000Z",
    "stop_date": "2025-01-15T10:31:15.000Z",
    "duration_ms": 75000
  }
}

GET

agentic-search

{execution_id}

cURL

# Check execution status
curl -X GET "https://api.getcatalog.ai/v2/agentic-search/agentic-a1b2c3d4-1735123456789" \
  -H "x-api-key: $CATALOG_API_KEY"

// Check execution status
const executionId = 'agentic-a1b2c3d4-1735123456789';

const response = await fetch(
  `https://api.getcatalog.ai/v2/agentic-search/${executionId}`,
  {
    headers: {
      'x-api-key': 'YOUR_API_KEY'
    }
  }
);

const data = await response.json();

if (data.status === 'completed') {
  console.log(`Search completed!`);
  console.log(`Products found: ${data.meta.result?.products_returned || 0}`);
  console.log(`Duration: ${data.meta.duration_ms}ms`);
  console.log(`Products:`, data.data);
} else if (data.status === 'running') {
  console.log('Search is still running...');
  if (data.meta.progress) {
    console.log(`Progress: ${data.meta.progress.percent_complete}% complete`);
  }
  // Optionally cancel if needed: DELETE /v2/agentic-search/{executionId}
} else if (data.status === 'failed') {
  console.error(`Search failed: ${data.error}`);
}

import requests
import time

execution_id = 'agentic-a1b2c3d4-1735123456789'

# Poll for completion
while True:
    response = requests.get(
        f'https://api.getcatalog.ai/v2/agentic-search/{execution_id}',
        headers={'x-api-key': 'YOUR_API_KEY'}
    )
    
    data = response.json()
    
    if data['status'] == 'completed':
        print(f"Search completed!")
        print(f"Products found: {data['meta'].get('result', {}).get('products_returned', 0)}")
        print(f"Duration: {data['meta']['duration_ms']}ms")
        print(f"Products: {data.get('data', [])}")
        break
    elif data['status'] == 'running':
        print('Search is still running...')
        if data['meta'].get('progress'):
            progress = data['meta']['progress']
            print(f"Progress: {progress['percent_complete']}% complete")
        # Optionally cancel if needed: DELETE /v2/agentic-search/{execution_id}
        time.sleep(5)  # Wait 5 seconds before next poll
    elif data['status'] == 'failed':
        print(f"Search failed: {data['error']}")
        break

{
  "execution_id": "agentic-589b1966-1770040673820",
  "status": "completed",
  "error": null,
  "meta": {
    "query": "A Barbour jacket suitable for the office",
    "progress": {
      "products_processed": 8,
      "products_total": 8,
      "percent_complete": 100
    },
    "start_date": "2026-02-02T13:57:54.099Z",
    "stop_date": "2026-02-02T14:03:41.281Z",
    "duration_ms": 347182,
    "result": {
      "products_returned": 8
    },
    "credits_used": 25
  },
  "data": [
    {
      "url": "https://www.barbour.com/us/cropped-beadnell-waxed-jacket-LWX1403BK71.html",
      "product": {
        "id": "8a19462a-1499-4221-9fff-fca3f036cc27",
        "title": "Cropped Beadnell Waxed Jacket",
        "description": "The Beadnell waxed jacket has been a part of Barbour's signature waxed jacket selection since 2010, offering a feminine, tailored rendition of the best-selling men's Bedale waxed jacket to the collection. This season, the Beadnell takes on a modern new look as the Barbour Cropped Beadnell Waxed Jacket displays oversized details featured on the original style. With large, gold-tone, branded snap buttons and the traditional saddle pockets, this style is complete with a cord collar and exaggerated elasticated cuffs for a contemporary touch.",
        "vendor": "barbour.com",
        "brand": "Barbour",
        "url": "https://www.barbour.com/us/cropped-beadnell-waxed-jacket-LWX1403BK71.html",
        "handle": "cropped-beadnell-waxed-jacket-lwx1403bk71",
        "is_available": true,
        "attributes": {
          "additional_attributes": [
            "cropped silhouette",
            "feminine, tailored rendition of the Bedale",
            "oversized details inspired by original style",
            "large gold-tone branded snap buttons",
            "traditional saddle pockets",
            "cord collar",
            "exaggerated elasticated cuffs",
            "waxed finish"
          ],
          "age_group": "adult",
          "gender": "female",
          "summary": "Cropped, feminine waxed jacket offering a tailored take on Barbour's Bedale with oversized details and contemporary finishes.",
          "features": "Cropped silhouette with oversized detailing; large gold-tone branded snap button closure; traditional saddle pockets; cord collar; exaggerated elasticated cuffs; waxed finish.",
          "care_instructions": "null",
          "color": {
            "iscc_family": "black",
            "merchant_label": "Black-Classic"
          },
          "closure_type": "snap",
          "style": [
            "tailored",
            "heritage",
            "modern"
          ],
          "mood": [
            "feminine"
          ],
          "additional_product_information": "The Beadnell waxed jacket is a feminine, tailored rendition of the classic Bedale waxed jacket. Key features: large gold-tone branded snap buttons, traditional saddle pockets, cord collar and exaggerated elasticated cuffs for a contemporary touch. Part of Barbour's signature waxed jacket selection since 2010. SKU: LWX1403BK71. Price: $425.00 (USD). Full-product images (multiple angles and detail shots) are provided on the product page."
        },
        "price": {
          "current_value": 425,
          "compare_at_value": 425,
          "currency": "USD"
        },
        "images": [
          {
            "url": "https://www.barbour.com/dw/image/v2/BLCL_PRD/on/demandware.static/-/Sites-master-catalog/default/dw04ac0533/images/LWX1403BK71/LWX1403BK71_01front.jpg?sw=1500&q=70",
            "alt_text": "Cropped Beadnell Waxed Jacket product image (primary)",
            "position": 1,
            "width": 1500,
            "height": 1836,
            "id": "img-1770040913273-0",
            "variant_ids": [
              "variant-1770040913275-0",
              "variant-1770040913275-1",
              "variant-1770040913275-2",
              "variant-1770040913275-3",
              "variant-1770040913275-4",
              "variant-1770040913275-5",
              "variant-1770040913275-6",
              "variant-1770040913275-7"
            ],
            "attributes": null
          },
          {
            "url": "https://www.barbour.com/dw/image/v2/BLCL_PRD/on/demandware.static/-/Sites-master-catalog/default/dw3435dec4/images/LWX1403BK71/LWX1403BK71_03getthelook.jpg?sw=1500&q=70",
            "alt_text": "Cropped Beadnell Waxed Jacket product image 2",
            "position": 2,
            "width": 1500,
            "height": 1836,
            "id": "img-1770040913273-1",
            "variant_ids": [
              "variant-1770040913275-0",
              "variant-1770040913275-1",
              "variant-1770040913275-2",
              "variant-1770040913275-3",
              "variant-1770040913275-4",
              "variant-1770040913275-5",
              "variant-1770040913275-6",
              "variant-1770040913275-7"
            ],
            "attributes": null
          },
          {
            "url": "https://www.barbour.com/dw/image/v2/BLCL_PRD/on/demandware.static/-/Sites-master-catalog/default/dw433521eb/images/LWX1403BK71/LWX1403BK71_04back.jpg?sw=1500&q=70",
            "alt_text": "Cropped Beadnell Waxed Jacket product image 3",
            "position": 3,
            "width": 1500,
            "height": 1836,
            "id": "img-1770040913273-2",
            "variant_ids": [
              "variant-1770040913275-0",
              "variant-1770040913275-1",
              "variant-1770040913275-2",
              "variant-1770040913275-3",
              "variant-1770040913275-4",
              "variant-1770040913275-5",
              "variant-1770040913275-6",
              "variant-1770040913275-7"
            ],
            "attributes": null
          },
          {
            "url": "https://www.barbour.com/dw/image/v2/BLCL_PRD/on/demandware.static/-/Sites-master-catalog/default/dwb09d0c6f/images/LWX1403BK71/LWX1403BK71_05detaila.jpg?sw=1500&q=70",
            "alt_text": "Cropped Beadnell Waxed Jacket product image 4",
            "position": 4,
            "width": 1500,
            "height": 1836,
            "id": "img-1770040913273-3",
            "variant_ids": [
              "variant-1770040913275-0",
              "variant-1770040913275-1",
              "variant-1770040913275-2",
              "variant-1770040913275-3",
              "variant-1770040913275-4",
              "variant-1770040913275-5",
              "variant-1770040913275-6",
              "variant-1770040913275-7"
            ],
            "attributes": null
          },
          {
            "url": "https://www.barbour.com/dw/image/v2/BLCL_PRD/on/demandware.static/-/Sites-master-catalog/default/dwebbb5a93/images/LWX1403BK71/LWX1403BK71_05detailb.jpg?sw=1500&q=70",
            "alt_text": "Cropped Beadnell Waxed Jacket product image 5",
            "position": 5,
            "width": 1500,
            "height": 1836,
            "id": "img-1770040913273-4",
            "variant_ids": [
              "variant-1770040913275-0",
              "variant-1770040913275-1",
              "variant-1770040913275-2",
              "variant-1770040913275-3",
              "variant-1770040913275-4",
              "variant-1770040913275-5",
              "variant-1770040913275-6",
              "variant-1770040913275-7"
            ],
            "attributes": null
          },
          {
            "url": "https://www.barbour.com/dw/image/v2/BLCL_PRD/on/demandware.static/-/Sites-master-catalog/default/dw6cc4cf07/images/LWX1403BK71/LWX1403BK71_05detailc.jpg?sw=1500&q=70",
            "alt_text": "Cropped Beadnell Waxed Jacket product image 6",
            "position": 6,
            "width": 1500,
            "height": 1836,
            "id": "img-1770040913273-5",
            "variant_ids": [
              "variant-1770040913275-0",
              "variant-1770040913275-1",
              "variant-1770040913275-2",
              "variant-1770040913275-3",
              "variant-1770040913275-4",
              "variant-1770040913275-5",
              "variant-1770040913275-6",
              "variant-1770040913275-7"
            ],
            "attributes": null
          },
          {
            "url": "https://www.barbour.com/dw/image/v2/BLCL_PRD/on/demandware.static/-/Sites-master-catalog/default/dw04f04054/images/LWX1403BK71/LWX1403BK71_05detaild.jpg?sw=1500&q=70",
            "alt_text": "Cropped Beadnell Waxed Jacket product image 7",
            "position": 7,
            "width": 1500,
            "height": 1836,
            "id": "img-1770040913273-6",
            "variant_ids": [
              "variant-1770040913275-0",
              "variant-1770040913275-1",
              "variant-1770040913275-2",
              "variant-1770040913275-3",
              "variant-1770040913275-4",
              "variant-1770040913275-5",
              "variant-1770040913275-6",
              "variant-1770040913275-7"
            ],
            "attributes": null
          }
        ],
        "options": [
          {
            "name": "Color",
            "position": 1,
            "values": [
              "Black-Classic"
            ]
          },
          {
            "name": "Size",
            "position": 2,
            "values": [
              "US 2",
              "US 4",
              "US 6",
              "US 8",
              "US 10",
              "US 12",
              "US 14",
              "US 16"
            ]
          }
        ],
        "variants": [
          {
            "id": "variant-1770040913275-0",
            "title": "Cropped Beadnell Waxed Jacket - Black-Classic - Us 2",
            "is_available": true,
            "price": {
              "current_value": 425,
              "compare_at_value": null,
              "currency": "USD"
            },
            "sku": "LWX1403BK71",
            "option1": "Black-Classic",
            "option2": "US 2",
            "url": "https://www.barbour.com/us/cropped-beadnell-waxed-jacket-LWX1403BK71.html",
            "image": {
              "url": "https://www.barbour.com/dw/image/v2/BLCL_PRD/on/demandware.static/-/Sites-master-catalog/default/dw04ac0533/images/LWX1403BK71/LWX1403BK71_01front.jpg?sw=1500&q=70",
              "alt_text": "Cropped Beadnell Waxed Jacket - Black-Classic - US 2 variant image",
              "position": 1,
              "width": 1500,
              "height": 1836,
              "id": "img-variant-variant-1770040913275-0",
              "variant_ids": [
                "variant-1770040913275-0"
              ]
            }
          },
          {
            "id": "variant-1770040913275-1",
            "title": "Cropped Beadnell Waxed Jacket - Black-Classic - Us 4",
            "is_available": true,
            "price": {
              "current_value": 425,
              "compare_at_value": null,
              "currency": "USD"
            },
            "sku": "LWX1403BK71",
            "option1": "Black-Classic",
            "option2": "US 4",
            "url": "https://www.barbour.com/us/cropped-beadnell-waxed-jacket-LWX1403BK71.html",
            "image": {
              "url": "https://www.barbour.com/dw/image/v2/BLCL_PRD/on/demandware.static/-/Sites-master-catalog/default/dw04ac0533/images/LWX1403BK71/LWX1403BK71_01front.jpg?sw=1500&q=70",
              "alt_text": "Cropped Beadnell Waxed Jacket - Black-Classic - US 4 variant image",
              "position": 2,
              "width": 1500,
              "height": 1836,
              "id": "img-variant-variant-1770040913275-1",
              "variant_ids": [
                "variant-1770040913275-1"
              ]
            }
          },
          {
            "id": "variant-1770040913275-2",
            "title": "Cropped Beadnell Waxed Jacket - Black-Classic - Us 6",
            "is_available": true,
            "price": {
              "current_value": 425,
              "compare_at_value": null,
              "currency": "USD"
            },
            "sku": "LWX1403BK71",
            "option1": "Black-Classic",
            "option2": "US 6",
            "url": "https://www.barbour.com/us/cropped-beadnell-waxed-jacket-LWX1403BK71.html",
            "image": {
              "url": "https://www.barbour.com/dw/image/v2/BLCL_PRD/on/demandware.static/-/Sites-master-catalog/default/dw04ac0533/images/LWX1403BK71/LWX1403BK71_01front.jpg?sw=1500&q=70",
              "alt_text": "Cropped Beadnell Waxed Jacket - Black-Classic - US 6 variant image",
              "position": 3,
              "width": 1500,
              "height": 1836,
              "id": "img-variant-variant-1770040913275-2",
              "variant_ids": [
                "variant-1770040913275-2"
              ]
            }
          },
          {
            "id": "variant-1770040913275-3",
            "title": "Cropped Beadnell Waxed Jacket - Black-Classic - Us 8",
            "is_available": true,
            "price": {
              "current_value": 425,
              "compare_at_value": null,
              "currency": "USD"
            },
            "sku": "LWX1403BK71",
            "option1": "Black-Classic",
            "option2": "US 8",
            "url": "https://www.barbour.com/us/cropped-beadnell-waxed-jacket-LWX1403BK71.html",
            "image": {
              "url": "https://www.barbour.com/dw/image/v2/BLCL_PRD/on/demandware.static/-/Sites-master-catalog/default/dw04ac0533/images/LWX1403BK71/LWX1403BK71_01front.jpg?sw=1500&q=70",
              "alt_text": "Cropped Beadnell Waxed Jacket - Black-Classic - US 8 variant image",
              "position": 4,
              "width": 1500,
              "height": 1836,
              "id": "img-variant-variant-1770040913275-3",
              "variant_ids": [
                "variant-1770040913275-3"
              ]
            }
          },
          {
            "id": "variant-1770040913275-4",
            "title": "Cropped Beadnell Waxed Jacket - Black-Classic - Us 10",
            "is_available": true,
            "price": {
              "current_value": 425,
              "compare_at_value": null,
              "currency": "USD"
            },
            "sku": "LWX1403BK71",
            "option1": "Black-Classic",
            "option2": "US 10",
            "url": "https://www.barbour.com/us/cropped-beadnell-waxed-jacket-LWX1403BK71.html",
            "image": {
              "url": "https://www.barbour.com/dw/image/v2/BLCL_PRD/on/demandware.static/-/Sites-master-catalog/default/dw04ac0533/images/LWX1403BK71/LWX1403BK71_01front.jpg?sw=1500&q=70",
              "alt_text": "Cropped Beadnell Waxed Jacket - Black-Classic - US 10 variant image",
              "position": 5,
              "width": 1500,
              "height": 1836,
              "id": "img-variant-variant-1770040913275-4",
              "variant_ids": [
                "variant-1770040913275-4"
              ]
            }
          },
          {
            "id": "variant-1770040913275-5",
            "title": "Cropped Beadnell Waxed Jacket - Black-Classic - Us 12",
            "is_available": true,
            "price": {
              "current_value": 425,
              "compare_at_value": null,
              "currency": "USD"
            },
            "sku": "LWX1403BK71",
            "option1": "Black-Classic",
            "option2": "US 12",
            "url": "https://www.barbour.com/us/cropped-beadnell-waxed-jacket-LWX1403BK71.html",
            "image": {
              "url": "https://www.barbour.com/dw/image/v2/BLCL_PRD/on/demandware.static/-/Sites-master-catalog/default/dw04ac0533/images/LWX1403BK71/LWX1403BK71_01front.jpg?sw=1500&q=70",
              "alt_text": "Cropped Beadnell Waxed Jacket - Black-Classic - US 12 variant image",
              "position": 6,
              "width": 1500,
              "height": 1836,
              "id": "img-variant-variant-1770040913275-5",
              "variant_ids": [
                "variant-1770040913275-5"
              ]
            }
          },
          {
            "id": "variant-1770040913275-6",
            "title": "Cropped Beadnell Waxed Jacket - Black-Classic - Us 14",
            "is_available": true,
            "price": {
              "current_value": 425,
              "compare_at_value": null,
              "currency": "USD"
            },
            "sku": "LWX1403BK71",
            "option1": "Black-Classic",
            "option2": "US 14",
            "url": "https://www.barbour.com/us/cropped-beadnell-waxed-jacket-LWX1403BK71.html",
            "image": {
              "url": "https://www.barbour.com/dw/image/v2/BLCL_PRD/on/demandware.static/-/Sites-master-catalog/default/dw04ac0533/images/LWX1403BK71/LWX1403BK71_01front.jpg?sw=1500&q=70",
              "alt_text": "Cropped Beadnell Waxed Jacket - Black-Classic - US 14 variant image",
              "position": 7,
              "width": 1500,
              "height": 1836,
              "id": "img-variant-variant-1770040913275-6",
              "variant_ids": [
                "variant-1770040913275-6"
              ]
            }
          },
          {
            "id": "variant-1770040913275-7",
            "title": "Cropped Beadnell Waxed Jacket - Black-Classic - Us 16",
            "is_available": true,
            "price": {
              "current_value": 425,
              "compare_at_value": null,
              "currency": "USD"
            },
            "sku": "LWX1403BK71",
            "option1": "Black-Classic",
            "option2": "US 16",
            "url": "https://www.barbour.com/us/cropped-beadnell-waxed-jacket-LWX1403BK71.html",
            "image": {
              "url": "https://www.barbour.com/dw/image/v2/BLCL_PRD/on/demandware.static/-/Sites-master-catalog/default/dw04ac0533/images/LWX1403BK71/LWX1403BK71_01front.jpg?sw=1500&q=70",
              "alt_text": "Cropped Beadnell Waxed Jacket - Black-Classic - US 16 variant image",
              "position": 8,
              "width": 1500,
              "height": 1836,
              "id": "img-variant-variant-1770040913275-7",
              "variant_ids": [
                "variant-1770040913275-7"
              ]
            }
          }
        ],
        "store_canonical_url": "https://www.barbour.com/",
        "store_domain": "www.barbour.com",
        "platform": null,
        "platform_id": "LWX1403BK71",
        "description_html": "*content*"
        "product_type": "JACKETS",
        "google_product_category_id": "5598",
        "google_product_category_path": "Apparel & Accessories > Clothing > Outerwear > Coats & Jackets",
        "tags": [
          "JACKETS"
        ],
        "video_url": null,
        "review_count": null,
        "average_rating": null,
        "rating_scale": 5,
        "faqs": null,
        "reviews": null,
        "updated_at": "2026-02-02T14:02:32.789Z",
        "enable_enrichment": true,
        "enable_reviews": false,
        "enable_image_tags": false,
        "enable_full_html": false,
        "similar_products": null,
        "enable_similar_products": false
      }
    },
    ...
  ],
  "pagination": {
    "page": 1,
    "page_size": 50,
    "total_items": 8,
    "total_pages": 1,
    "has_next": false,
    "has_prev": false
  }
}

{
  "execution_id": "agentic-a1b2c3d4-1735123456789",
  "status": "running",
  "error": null,
  "meta": {
    "query": "A Barbour jacket suitable for the office",
    "progress": {
      "products_processed": 0,
      "products_total": 8,
      "percent_complete": 0
    },
    "start_date": "2025-01-15T10:30:00.000Z",
    "stop_date": null,
    "duration_ms": 15000
  }
}

{
  "execution_id": "agentic-a1b2c3d4-1735123456789",
  "status": "failed",
  "error": "Execution failed. Please check the execution details or contact support.",
  "meta": {
    "query": "A Barbour jacket suitable for the office",
    "progress": null,
    "start_date": "2025-01-15T10:30:00.000Z",
    "stop_date": "2025-01-15T10:31:15.000Z",
    "duration_ms": 75000
  }
}

When to use: After starting a search job with the POST endpoint, use this endpoint to:

Check if the search is complete
Monitor real-time progress
Get detailed metrics including products found
Retrieve paginated product results when processing completes
Track execution timing and duration

Authentication Required: This endpoint requires a valid API key. Execution IDs are scoped to your organization - you can only access executions that belong to your organization.Cancel Running Executions: If you need to stop a search that is currently running, use DELETE /v2/agentic-search/{execution_id} to stop the execution.

Request

string

required

Your API key for authentication

string

required

The execution ID returned from POST /v2/agentic-searchFormat: agentic-{uuid}-{timestamp}Note: If the execution ID does not exist or does not belong to your organization, the endpoint returns a 404 Not Found error.

Query Parameters

number

default:"1"

Page number for paginated results (only applicable when status is “completed”)Minimum: 1

number

default:"50"

Number of results per page (only applicable when status is “completed”)Maximum: 100

Response

string

The execution identifier

string

Current execution statusPossible values:

"pending" - Execution has been created but not yet started
"running" - Execution is currently processing
"completed" - Execution finished successfully
"failed" - Execution failed or was aborted

string | null

Error message if the execution failed, otherwise null

array

Array of product results (only present when status is “completed”, up to 8 items). Fewer items may be returned if some cannot be processed or don’t meet quality requirements.

Hide Product Result

string

Original URL that was processed

boolean

Whether the product was successfully processed

object | null

Product object

Hide Product Object

string

Product title

string

Detailed product description

string

Product URL

string | null

Product brand name

string | null

Full product category breadcrumb path

string | null

Google product category identifier

string | null

Full Google product category path

string | null

Product condition (e.g. “new”, “used”, “refurbished”)

string | null

Availability status string (e.g. “in_stock”, “out_of_stock”, “preorder”, “backorder”)

string | null

Product price as a value and currency string (e.g. “1628 USD”)

string | null

Sale price as a value and currency string (e.g. “1365 USD”)

string | null

Product material description

string | null

Target gender (e.g. “male”, “female”, “unisex”)

string | null

Target age group (e.g. “adult”, “kids”, “toddler”, “infant”, “newborn”)

string | null

Size system used (e.g. “US”, “UK”, “EU”)

string | null

Unit for dimension values (e.g. “in”, “cm”)

string | null

Product weight value

string | null

Product height value

string | null

Product length value

string | null

Product width value

string | null

Unit for weight value (e.g. “lb”, “kg”)

array

Array of image objects.

Show Image object

string

Image URL

string | null

Alt text

array

Array of variant objects.

Show Variant object

string

Variant ID

string | null

SKU

string | null

Shipping information

string

Whether the product is eligible for search. “true” or “false”.

string

Whether the product is eligible for checkout. “true” or “false”.

number | null

Number of reviews

number | null

Average star rating (e.g. 4.8)

number | null

Rating scale (e.g. 5)

array | null

Array of review objects.

Show Review object

string | null

Review date

string | null

Review title

number | string | null

Rating

string | null

Review body

string | null

Review image URL

string | null

Reviewer name

array | null

Similar products when similar products discovery is enabled.

Show Similar product object

string

Product URL

string | null

Brand name

string

Product title

string

“high” | “medium” | “low”

object | null

Brand product detail page lookup result, identifying the original brand’s listing for this product.

Show Brand PDP object

string

Brand name

string

Brand website domain

string

URL to the product on the brand’s own website

string

Product title on the brand’s website

object | null

Product attributes when AI enrichment is enabled.

Show Attributes object

Key-value object from AI enrichment. Structure is product-dependent; no fixed schema. May include semantic attributes (e.g. color, summary, features, material, placement, durability, care_instructions, additional_attributes) and other enriched fields.

string | null

E-commerce platform (e.g. “shopify”)

string | null

Platform-specific ID

boolean | null

Whether the product is a digital/downloadable item

object | null

In-depth product research organized by dimension (e.g. ergonomics, materials, competitive analysis). Structure varies by product category.

array | null

Array of Q&A objects.

Show Q&A object

string

Question

string

Answer

string | null

Confidence level: “high”, “medium”, or “low”

string | null

Category of the question (e.g. “durability”, “compatibility”, “maintenance”, “performance”, “technical”)

string

Machine-readable reason for failure (only present when success is false and a specific reason is available)

object

Pagination metadata for the results (only present when status is “completed” and data is returned)

Show Pagination Properties

number

Current page number

number

Number of items per page

number

Total number of products returned

number

Total number of pages

boolean

Whether there is a next page

boolean

Whether there is a previous page

object

Detailed metadata about the execution

Show Meta Object

string

The search query used for this execution

object | null

Real-time progress information (only available when status is “running”)

Show Progress Object

number

Number of products processed so far

number

Total number of products to process (up to 8)

number

Percentage of completion (0-100)

string | null

ISO 8601 timestamp when the execution started

string | null

ISO 8601 timestamp when the execution stopped (only available when completed or failed)

number | null

Duration of the execution in milliseconds (only available when execution has started)

object

Result statistics (only available when status is “completed”)

Show Result Object

number

Number of products returned in the response

cURL

# Check execution status
curl -X GET "https://api.getcatalog.ai/v2/agentic-search/agentic-a1b2c3d4-1735123456789" \
  -H "x-api-key: $CATALOG_API_KEY"

// Check execution status
const executionId = 'agentic-a1b2c3d4-1735123456789';

const response = await fetch(
  `https://api.getcatalog.ai/v2/agentic-search/${executionId}`,
  {
    headers: {
      'x-api-key': 'YOUR_API_KEY'
    }
  }
);

const data = await response.json();

if (data.status === 'completed') {
  console.log(`Search completed!`);
  console.log(`Products found: ${data.meta.result?.products_returned || 0}`);
  console.log(`Duration: ${data.meta.duration_ms}ms`);
  console.log(`Products:`, data.data);
} else if (data.status === 'running') {
  console.log('Search is still running...');
  if (data.meta.progress) {
    console.log(`Progress: ${data.meta.progress.percent_complete}% complete`);
  }
  // Optionally cancel if needed: DELETE /v2/agentic-search/{executionId}
} else if (data.status === 'failed') {
  console.error(`Search failed: ${data.error}`);
}

import requests
import time

execution_id = 'agentic-a1b2c3d4-1735123456789'

# Poll for completion
while True:
    response = requests.get(
        f'https://api.getcatalog.ai/v2/agentic-search/{execution_id}',
        headers={'x-api-key': 'YOUR_API_KEY'}
    )
    
    data = response.json()
    
    if data['status'] == 'completed':
        print(f"Search completed!")
        print(f"Products found: {data['meta'].get('result', {}).get('products_returned', 0)}")
        print(f"Duration: {data['meta']['duration_ms']}ms")
        print(f"Products: {data.get('data', [])}")
        break
    elif data['status'] == 'running':
        print('Search is still running...')
        if data['meta'].get('progress'):
            progress = data['meta']['progress']
            print(f"Progress: {progress['percent_complete']}% complete")
        # Optionally cancel if needed: DELETE /v2/agentic-search/{execution_id}
        time.sleep(5)  # Wait 5 seconds before next poll
    elif data['status'] == 'failed':
        print(f"Search failed: {data['error']}")
        break

{
  "execution_id": "agentic-589b1966-1770040673820",
  "status": "completed",
  "error": null,
  "meta": {
    "query": "A Barbour jacket suitable for the office",
    "progress": {
      "products_processed": 8,
      "products_total": 8,
      "percent_complete": 100
    },
    "start_date": "2026-02-02T13:57:54.099Z",
    "stop_date": "2026-02-02T14:03:41.281Z",
    "duration_ms": 347182,
    "result": {
      "products_returned": 8
    },
    "credits_used": 25
  },
  "data": [
    {
      "url": "https://www.barbour.com/us/cropped-beadnell-waxed-jacket-LWX1403BK71.html",
      "product": {
        "id": "8a19462a-1499-4221-9fff-fca3f036cc27",
        "title": "Cropped Beadnell Waxed Jacket",
        "description": "The Beadnell waxed jacket has been a part of Barbour's signature waxed jacket selection since 2010, offering a feminine, tailored rendition of the best-selling men's Bedale waxed jacket to the collection. This season, the Beadnell takes on a modern new look as the Barbour Cropped Beadnell Waxed Jacket displays oversized details featured on the original style. With large, gold-tone, branded snap buttons and the traditional saddle pockets, this style is complete with a cord collar and exaggerated elasticated cuffs for a contemporary touch.",
        "vendor": "barbour.com",
        "brand": "Barbour",
        "url": "https://www.barbour.com/us/cropped-beadnell-waxed-jacket-LWX1403BK71.html",
        "handle": "cropped-beadnell-waxed-jacket-lwx1403bk71",
        "is_available": true,
        "attributes": {
          "additional_attributes": [
            "cropped silhouette",
            "feminine, tailored rendition of the Bedale",
            "oversized details inspired by original style",
            "large gold-tone branded snap buttons",
            "traditional saddle pockets",
            "cord collar",
            "exaggerated elasticated cuffs",
            "waxed finish"
          ],
          "age_group": "adult",
          "gender": "female",
          "summary": "Cropped, feminine waxed jacket offering a tailored take on Barbour's Bedale with oversized details and contemporary finishes.",
          "features": "Cropped silhouette with oversized detailing; large gold-tone branded snap button closure; traditional saddle pockets; cord collar; exaggerated elasticated cuffs; waxed finish.",
          "care_instructions": "null",
          "color": {
            "iscc_family": "black",
            "merchant_label": "Black-Classic"
          },
          "closure_type": "snap",
          "style": [
            "tailored",
            "heritage",
            "modern"
          ],
          "mood": [
            "feminine"
          ],
          "additional_product_information": "The Beadnell waxed jacket is a feminine, tailored rendition of the classic Bedale waxed jacket. Key features: large gold-tone branded snap buttons, traditional saddle pockets, cord collar and exaggerated elasticated cuffs for a contemporary touch. Part of Barbour's signature waxed jacket selection since 2010. SKU: LWX1403BK71. Price: $425.00 (USD). Full-product images (multiple angles and detail shots) are provided on the product page."
        },
        "price": {
          "current_value": 425,
          "compare_at_value": 425,
          "currency": "USD"
        },
        "images": [
          {
            "url": "https://www.barbour.com/dw/image/v2/BLCL_PRD/on/demandware.static/-/Sites-master-catalog/default/dw04ac0533/images/LWX1403BK71/LWX1403BK71_01front.jpg?sw=1500&q=70",
            "alt_text": "Cropped Beadnell Waxed Jacket product image (primary)",
            "position": 1,
            "width": 1500,
            "height": 1836,
            "id": "img-1770040913273-0",
            "variant_ids": [
              "variant-1770040913275-0",
              "variant-1770040913275-1",
              "variant-1770040913275-2",
              "variant-1770040913275-3",
              "variant-1770040913275-4",
              "variant-1770040913275-5",
              "variant-1770040913275-6",
              "variant-1770040913275-7"
            ],
            "attributes": null
          },
          {
            "url": "https://www.barbour.com/dw/image/v2/BLCL_PRD/on/demandware.static/-/Sites-master-catalog/default/dw3435dec4/images/LWX1403BK71/LWX1403BK71_03getthelook.jpg?sw=1500&q=70",
            "alt_text": "Cropped Beadnell Waxed Jacket product image 2",
            "position": 2,
            "width": 1500,
            "height": 1836,
            "id": "img-1770040913273-1",
            "variant_ids": [
              "variant-1770040913275-0",
              "variant-1770040913275-1",
              "variant-1770040913275-2",
              "variant-1770040913275-3",
              "variant-1770040913275-4",
              "variant-1770040913275-5",
              "variant-1770040913275-6",
              "variant-1770040913275-7"
            ],
            "attributes": null
          },
          {
            "url": "https://www.barbour.com/dw/image/v2/BLCL_PRD/on/demandware.static/-/Sites-master-catalog/default/dw433521eb/images/LWX1403BK71/LWX1403BK71_04back.jpg?sw=1500&q=70",
            "alt_text": "Cropped Beadnell Waxed Jacket product image 3",
            "position": 3,
            "width": 1500,
            "height": 1836,
            "id": "img-1770040913273-2",
            "variant_ids": [
              "variant-1770040913275-0",
              "variant-1770040913275-1",
              "variant-1770040913275-2",
              "variant-1770040913275-3",
              "variant-1770040913275-4",
              "variant-1770040913275-5",
              "variant-1770040913275-6",
              "variant-1770040913275-7"
            ],
            "attributes": null
          },
          {
            "url": "https://www.barbour.com/dw/image/v2/BLCL_PRD/on/demandware.static/-/Sites-master-catalog/default/dwb09d0c6f/images/LWX1403BK71/LWX1403BK71_05detaila.jpg?sw=1500&q=70",
            "alt_text": "Cropped Beadnell Waxed Jacket product image 4",
            "position": 4,
            "width": 1500,
            "height": 1836,
            "id": "img-1770040913273-3",
            "variant_ids": [
              "variant-1770040913275-0",
              "variant-1770040913275-1",
              "variant-1770040913275-2",
              "variant-1770040913275-3",
              "variant-1770040913275-4",
              "variant-1770040913275-5",
              "variant-1770040913275-6",
              "variant-1770040913275-7"
            ],
            "attributes": null
          },
          {
            "url": "https://www.barbour.com/dw/image/v2/BLCL_PRD/on/demandware.static/-/Sites-master-catalog/default/dwebbb5a93/images/LWX1403BK71/LWX1403BK71_05detailb.jpg?sw=1500&q=70",
            "alt_text": "Cropped Beadnell Waxed Jacket product image 5",
            "position": 5,
            "width": 1500,
            "height": 1836,
            "id": "img-1770040913273-4",
            "variant_ids": [
              "variant-1770040913275-0",
              "variant-1770040913275-1",
              "variant-1770040913275-2",
              "variant-1770040913275-3",
              "variant-1770040913275-4",
              "variant-1770040913275-5",
              "variant-1770040913275-6",
              "variant-1770040913275-7"
            ],
            "attributes": null
          },
          {
            "url": "https://www.barbour.com/dw/image/v2/BLCL_PRD/on/demandware.static/-/Sites-master-catalog/default/dw6cc4cf07/images/LWX1403BK71/LWX1403BK71_05detailc.jpg?sw=1500&q=70",
            "alt_text": "Cropped Beadnell Waxed Jacket product image 6",
            "position": 6,
            "width": 1500,
            "height": 1836,
            "id": "img-1770040913273-5",
            "variant_ids": [
              "variant-1770040913275-0",
              "variant-1770040913275-1",
              "variant-1770040913275-2",
              "variant-1770040913275-3",
              "variant-1770040913275-4",
              "variant-1770040913275-5",
              "variant-1770040913275-6",
              "variant-1770040913275-7"
            ],
            "attributes": null
          },
          {
            "url": "https://www.barbour.com/dw/image/v2/BLCL_PRD/on/demandware.static/-/Sites-master-catalog/default/dw04f04054/images/LWX1403BK71/LWX1403BK71_05detaild.jpg?sw=1500&q=70",
            "alt_text": "Cropped Beadnell Waxed Jacket product image 7",
            "position": 7,
            "width": 1500,
            "height": 1836,
            "id": "img-1770040913273-6",
            "variant_ids": [
              "variant-1770040913275-0",
              "variant-1770040913275-1",
              "variant-1770040913275-2",
              "variant-1770040913275-3",
              "variant-1770040913275-4",
              "variant-1770040913275-5",
              "variant-1770040913275-6",
              "variant-1770040913275-7"
            ],
            "attributes": null
          }
        ],
        "options": [
          {
            "name": "Color",
            "position": 1,
            "values": [
              "Black-Classic"
            ]
          },
          {
            "name": "Size",
            "position": 2,
            "values": [
              "US 2",
              "US 4",
              "US 6",
              "US 8",
              "US 10",
              "US 12",
              "US 14",
              "US 16"
            ]
          }
        ],
        "variants": [
          {
            "id": "variant-1770040913275-0",
            "title": "Cropped Beadnell Waxed Jacket - Black-Classic - Us 2",
            "is_available": true,
            "price": {
              "current_value": 425,
              "compare_at_value": null,
              "currency": "USD"
            },
            "sku": "LWX1403BK71",
            "option1": "Black-Classic",
            "option2": "US 2",
            "url": "https://www.barbour.com/us/cropped-beadnell-waxed-jacket-LWX1403BK71.html",
            "image": {
              "url": "https://www.barbour.com/dw/image/v2/BLCL_PRD/on/demandware.static/-/Sites-master-catalog/default/dw04ac0533/images/LWX1403BK71/LWX1403BK71_01front.jpg?sw=1500&q=70",
              "alt_text": "Cropped Beadnell Waxed Jacket - Black-Classic - US 2 variant image",
              "position": 1,
              "width": 1500,
              "height": 1836,
              "id": "img-variant-variant-1770040913275-0",
              "variant_ids": [
                "variant-1770040913275-0"
              ]
            }
          },
          {
            "id": "variant-1770040913275-1",
            "title": "Cropped Beadnell Waxed Jacket - Black-Classic - Us 4",
            "is_available": true,
            "price": {
              "current_value": 425,
              "compare_at_value": null,
              "currency": "USD"
            },
            "sku": "LWX1403BK71",
            "option1": "Black-Classic",
            "option2": "US 4",
            "url": "https://www.barbour.com/us/cropped-beadnell-waxed-jacket-LWX1403BK71.html",
            "image": {
              "url": "https://www.barbour.com/dw/image/v2/BLCL_PRD/on/demandware.static/-/Sites-master-catalog/default/dw04ac0533/images/LWX1403BK71/LWX1403BK71_01front.jpg?sw=1500&q=70",
              "alt_text": "Cropped Beadnell Waxed Jacket - Black-Classic - US 4 variant image",
              "position": 2,
              "width": 1500,
              "height": 1836,
              "id": "img-variant-variant-1770040913275-1",
              "variant_ids": [
                "variant-1770040913275-1"
              ]
            }
          },
          {
            "id": "variant-1770040913275-2",
            "title": "Cropped Beadnell Waxed Jacket - Black-Classic - Us 6",
            "is_available": true,
            "price": {
              "current_value": 425,
              "compare_at_value": null,
              "currency": "USD"
            },
            "sku": "LWX1403BK71",
            "option1": "Black-Classic",
            "option2": "US 6",
            "url": "https://www.barbour.com/us/cropped-beadnell-waxed-jacket-LWX1403BK71.html",
            "image": {
              "url": "https://www.barbour.com/dw/image/v2/BLCL_PRD/on/demandware.static/-/Sites-master-catalog/default/dw04ac0533/images/LWX1403BK71/LWX1403BK71_01front.jpg?sw=1500&q=70",
              "alt_text": "Cropped Beadnell Waxed Jacket - Black-Classic - US 6 variant image",
              "position": 3,
              "width": 1500,
              "height": 1836,
              "id": "img-variant-variant-1770040913275-2",
              "variant_ids": [
                "variant-1770040913275-2"
              ]
            }
          },
          {
            "id": "variant-1770040913275-3",
            "title": "Cropped Beadnell Waxed Jacket - Black-Classic - Us 8",
            "is_available": true,
            "price": {
              "current_value": 425,
              "compare_at_value": null,
              "currency": "USD"
            },
            "sku": "LWX1403BK71",
            "option1": "Black-Classic",
            "option2": "US 8",
            "url": "https://www.barbour.com/us/cropped-beadnell-waxed-jacket-LWX1403BK71.html",
            "image": {
              "url": "https://www.barbour.com/dw/image/v2/BLCL_PRD/on/demandware.static/-/Sites-master-catalog/default/dw04ac0533/images/LWX1403BK71/LWX1403BK71_01front.jpg?sw=1500&q=70",
              "alt_text": "Cropped Beadnell Waxed Jacket - Black-Classic - US 8 variant image",
              "position": 4,
              "width": 1500,
              "height": 1836,
              "id": "img-variant-variant-1770040913275-3",
              "variant_ids": [
                "variant-1770040913275-3"
              ]
            }
          },
          {
            "id": "variant-1770040913275-4",
            "title": "Cropped Beadnell Waxed Jacket - Black-Classic - Us 10",
            "is_available": true,
            "price": {
              "current_value": 425,
              "compare_at_value": null,
              "currency": "USD"
            },
            "sku": "LWX1403BK71",
            "option1": "Black-Classic",
            "option2": "US 10",
            "url": "https://www.barbour.com/us/cropped-beadnell-waxed-jacket-LWX1403BK71.html",
            "image": {
              "url": "https://www.barbour.com/dw/image/v2/BLCL_PRD/on/demandware.static/-/Sites-master-catalog/default/dw04ac0533/images/LWX1403BK71/LWX1403BK71_01front.jpg?sw=1500&q=70",
              "alt_text": "Cropped Beadnell Waxed Jacket - Black-Classic - US 10 variant image",
              "position": 5,
              "width": 1500,
              "height": 1836,
              "id": "img-variant-variant-1770040913275-4",
              "variant_ids": [
                "variant-1770040913275-4"
              ]
            }
          },
          {
            "id": "variant-1770040913275-5",
            "title": "Cropped Beadnell Waxed Jacket - Black-Classic - Us 12",
            "is_available": true,
            "price": {
              "current_value": 425,
              "compare_at_value": null,
              "currency": "USD"
            },
            "sku": "LWX1403BK71",
            "option1": "Black-Classic",
            "option2": "US 12",
            "url": "https://www.barbour.com/us/cropped-beadnell-waxed-jacket-LWX1403BK71.html",
            "image": {
              "url": "https://www.barbour.com/dw/image/v2/BLCL_PRD/on/demandware.static/-/Sites-master-catalog/default/dw04ac0533/images/LWX1403BK71/LWX1403BK71_01front.jpg?sw=1500&q=70",
              "alt_text": "Cropped Beadnell Waxed Jacket - Black-Classic - US 12 variant image",
              "position": 6,
              "width": 1500,
              "height": 1836,
              "id": "img-variant-variant-1770040913275-5",
              "variant_ids": [
                "variant-1770040913275-5"
              ]
            }
          },
          {
            "id": "variant-1770040913275-6",
            "title": "Cropped Beadnell Waxed Jacket - Black-Classic - Us 14",
            "is_available": true,
            "price": {
              "current_value": 425,
              "compare_at_value": null,
              "currency": "USD"
            },
            "sku": "LWX1403BK71",
            "option1": "Black-Classic",
            "option2": "US 14",
            "url": "https://www.barbour.com/us/cropped-beadnell-waxed-jacket-LWX1403BK71.html",
            "image": {
              "url": "https://www.barbour.com/dw/image/v2/BLCL_PRD/on/demandware.static/-/Sites-master-catalog/default/dw04ac0533/images/LWX1403BK71/LWX1403BK71_01front.jpg?sw=1500&q=70",
              "alt_text": "Cropped Beadnell Waxed Jacket - Black-Classic - US 14 variant image",
              "position": 7,
              "width": 1500,
              "height": 1836,
              "id": "img-variant-variant-1770040913275-6",
              "variant_ids": [
                "variant-1770040913275-6"
              ]
            }
          },
          {
            "id": "variant-1770040913275-7",
            "title": "Cropped Beadnell Waxed Jacket - Black-Classic - Us 16",
            "is_available": true,
            "price": {
              "current_value": 425,
              "compare_at_value": null,
              "currency": "USD"
            },
            "sku": "LWX1403BK71",
            "option1": "Black-Classic",
            "option2": "US 16",
            "url": "https://www.barbour.com/us/cropped-beadnell-waxed-jacket-LWX1403BK71.html",
            "image": {
              "url": "https://www.barbour.com/dw/image/v2/BLCL_PRD/on/demandware.static/-/Sites-master-catalog/default/dw04ac0533/images/LWX1403BK71/LWX1403BK71_01front.jpg?sw=1500&q=70",
              "alt_text": "Cropped Beadnell Waxed Jacket - Black-Classic - US 16 variant image",
              "position": 8,
              "width": 1500,
              "height": 1836,
              "id": "img-variant-variant-1770040913275-7",
              "variant_ids": [
                "variant-1770040913275-7"
              ]
            }
          }
        ],
        "store_canonical_url": "https://www.barbour.com/",
        "store_domain": "www.barbour.com",
        "platform": null,
        "platform_id": "LWX1403BK71",
        "description_html": "*content*"
        "product_type": "JACKETS",
        "google_product_category_id": "5598",
        "google_product_category_path": "Apparel & Accessories > Clothing > Outerwear > Coats & Jackets",
        "tags": [
          "JACKETS"
        ],
        "video_url": null,
        "review_count": null,
        "average_rating": null,
        "rating_scale": 5,
        "faqs": null,
        "reviews": null,
        "updated_at": "2026-02-02T14:02:32.789Z",
        "enable_enrichment": true,
        "enable_reviews": false,
        "enable_image_tags": false,
        "enable_full_html": false,
        "similar_products": null,
        "enable_similar_products": false
      }
    },
    ...
  ],
  "pagination": {
    "page": 1,
    "page_size": 50,
    "total_items": 8,
    "total_pages": 1,
    "has_next": false,
    "has_prev": false
  }
}

{
  "execution_id": "agentic-a1b2c3d4-1735123456789",
  "status": "running",
  "error": null,
  "meta": {
    "query": "A Barbour jacket suitable for the office",
    "progress": {
      "products_processed": 0,
      "products_total": 8,
      "percent_complete": 0
    },
    "start_date": "2025-01-15T10:30:00.000Z",
    "stop_date": null,
    "duration_ms": 15000
  }
}

{
  "execution_id": "agentic-a1b2c3d4-1735123456789",
  "status": "failed",
  "error": "Execution failed. Please check the execution details or contact support.",
  "meta": {
    "query": "A Barbour jacket suitable for the office",
    "progress": null,
    "start_date": "2025-01-15T10:30:00.000Z",
    "stop_date": "2025-01-15T10:31:15.000Z",
    "duration_ms": 75000
  }
}

Polling Strategy

For best results when waiting for completion:

Initial Poll: Check status immediately after receiving execution_id
Polling Interval: Wait 5-10 seconds between polls for running executions
Exponential Backoff: Consider increasing wait time for long-running searches
Timeout: Set a maximum wait time based on your application’s requirements
Progress Tracking: Monitor meta.progress to see real-time progress
Cancellation: If a search is taking too long or you need to stop it, use DELETE /v2/agentic-search/{execution_id} to stop running executions

Get Started

API Reference

Guides

Resources

Migration Guides

Request

Query Parameters

Response

Polling Strategy

​Request

​Query Parameters

​Response

​Polling Strategy

Request

Query Parameters

Response

Polling Strategy