Get Product by URL

Get detailed information about a specific product by URL

Retrieve comprehensive details about a specific product by providing its URL. This endpoint can also detect new vendors and automatically trigger scraping for Shopify stores.

Request

x-api-key · string · required

Your API key for authentication

Request Body

url · string · required

The product URL to search for

enable_enrichment · boolean · default: "true"

Whether to enable AI enrichment for single products

country_code · string · default: "us"

ISO 2-letter country code for localization (e.g., “us”, “ca”, “gb”, “de”)

Supported Country Codes: nl, ca, si, co, by, ee, no, br, us, de, es, vn, il, th, gb, ph, kg, in, ru, fr, hk, ua, jp, at, mm, my, pl, au, nz, ro, tw, mx, id, dk, ng, ch, hu, sg, sa, ae, cn, ar, cl, it, tr, lv, gh, sk, gr, eg, lu, bg, se, lt, lk, kz, hr, bd, kr, cz, fi, ie, be, pt, za

Response

product · object | null

Detailed product information (null if not found)

Show Product Properties

id · string

Unique product identifier

title · string

Product title

description · string

Detailed product description

vendor · string

Store/retailer name (e.g., “net-a-porter”, “Nike”)

brand · string | null

Product brand name (e.g., “LOEFFLER RANDALL”, “Nike”)

url · string

Product URL

handle · string

Product handle/slug

is_available · boolean

Product availability status

price_amount · number | null

Price in dollars

price_currency · string | null

Currency code (e.g., “USD”)

min_price · number | null

Minimum price for variants

max_price · number | null

Maximum price for variants

images · array

Array of product images

Show Image Properties

id · string

Unique image identifier

url · string

Image URL

width · number

Image width in pixels

height · number

Image height in pixels

altText · string

Alt text for the image

position · number

Display position/order of the image

variantIDs · array

Array of variant IDs that use this image

options · array

Array of product options (size, color, etc.)

Show Option Properties

name · string

Option name (e.g., “Size”, “Color”)

values · array

Array of available values for this option

position · number

Display position of the option

variants · array

Array of product variants with detailed information

Show Variant Properties

id · string

Unique variant identifier

SKU · string

Stock Keeping Unit identifier

image · object

Variant-specific image information

price · string

Variant price as string

title · string

Full variant title including options

option1 · string

First option value (e.g., size)

isAvailable · boolean

Variant availability status

compareAtPrice · string

Compare at price (original/MSRP price)

store_canonical_url · string | null

Canonical store URL

store_domain · string

Store domain

platform · string | null

E-commerce platform (null if not identified)

platform_id · string | null

Platform-specific ID

description_html · string | null

HTML-formatted description

product_type · string | null

Product type/category

google_product_category_id · string | null

Google product category identifier

google_product_category_path · string | null

Full Google product category path

tags · array

Array of product tags/categories

video_url · string | null

Product video URL (if available)

updated_at · string

Last update timestamp (ISO 8601)

attributes · object

Comprehensive product attributes (when AI enrichment is enabled)

Show Available Attributes

color · string

Primary product color

material · string

Primary material

category · string

Product category hierarchy

gender · string

Target gender (e.g., “unisex”, “men”, “women”)

season · string

Seasonal appropriateness

occasion · string

Suitable occasion

size_range · array

Available sizes

meta · object

Response metadata

Show Meta Properties

found · boolean

Whether the product was found

url · string

Echo back the requested URL

cURL

curl -X POST https://api.getcatalog.ai/api/product \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "url": "https://www.nike.com/t/air-force-1-07-mens-shoes-5QFp5Z/CW2288-111",
    "enable_enrichment": true,
    "country_code": "us"
  }'

Product Found

{
  "product": {
    "id": "fec26b49-66f8-480e-8cbb-cfc823af1d33",
    "url": "https://www.net-a-porter.com/en-us/shop/product/loeffler-randall/shoes/loafers/franco-leather-boat-shoes/46376663162925963",
    "tags": ["SHOES"],
    "brand": "LOEFFLER RANDALL",
    "title": "Franco Leather Boat Shoes",
    "handle": "46376663162925963",
    "images": [
      {
        "id": "img-1756348783902-0",
        "url": "https://www.net-a-porter.com/variants/images/46376663162925963/in/w2000_q60.jpg",
        "width": 2000,
        "height": 2667,
        "altText": "Franco leather boat shoes product image (primary)",
        "position": 1,
        "variantIDs": [
          "variant-1756348783903-0",
          "variant-1756348783903-1"
        ]
      }
    ],
    "vendor": "net-a-porter",
    "options": [
      {
        "name": "Size",
        "values": ["US5", "US5.5", "US6", "US6.5", "US7", "US7.5", "US8", "US8.5", "US9", "US9.5", "US10", "US10.5", "US11"],
        "position": 1
      }
    ],
    "platform": null,
    "variants": [
      {
        "id": "variant-1756348783903-0",
        "SKU": "0400666700588",
        "image": {
          "id": "img-variant-variant-1756348783903-0",
          "url": "https://www.net-a-porter.com/variants/images/46376663162925963/in/w2000_q60.jpg",
          "width": 2000,
          "height": 2667,
          "altText": "Franco leather boat shoes - US5 variant image",
          "position": 1,
          "variantIDs": ["variant-1756348783903-0"]
        },
        "price": "325",
        "title": "Franco Leather Boat Shoes - Us5",
        "option1": "US5",
        "isAvailable": true,
        "compareAtPrice": "325"
      }
    ],
    "max_price": 325,
    "min_price": 325,
    "video_url": null,
    "attributes": {
      "mood": ["elegant", "relaxed"],
      "color": {
        "iscc_family": "brown",
        "merchant_label": "Espresso"
      },
      "style": ["casual", "classic"],
      "gender": "unisex",
      "season": ["spring", "summer", "fall"],
      "summary": "Modern leather boat shoes with classic design elements",
      "features": "Soft leather construction, unique patina develops over time",
      "material": {
        "primary": "leather",
        "merchant_label": "Soft leather"
      },
      "occasion": ["casual", "weekend", "work"],
      "closure_type": "lace-up",
      "care_instructions": "Wipe clean with a damp cloth, store in a cool dry place",
      "additional_attributes": ["handmade", "contrasting stitching", "striped cord laces"]
    },
    "updated_at": "2025-08-28T02:39:49.827+00:00",
    "description": "Loeffler Randall's 'Franco' boat shoes are traced with contrasting stitching and striped cord laces, giving the classic style a modern feel.",
    "platform_id": "46376663162925963",
    "is_available": true,
    "price_amount": 325,
    "product_type": "SHOES",
    "store_domain": "www.net-a-porter.com",
    "price_currency": "USD",
    "description_html": "<p>Loeffler Randall's 'Franco' boat shoes are traced with contrasting stitching and striped cord laces, giving the classic style a modern feel.</p>",
    "store_canonical_url": "https://www.net-a-porter.com/",
    "google_product_category_id": "187",
    "google_product_category_path": "Apparel & Accessories > Shoes"
  },
  "meta": {
    "found": true,
    "url": "https://www.net-a-porter.com/en-us/shop/product/loeffler-randall/shoes/loafers/franco-leather-boat-shoes/46376663162925963"
  }
}