Get Multiple Products by URLs

Process multiple product URLs in parallel to retrieve detailed product information

Retrieve comprehensive details for multiple products by providing an array of URLs. This endpoint processes up to 50 URLs concurrently, making it ideal for bulk product data extraction and processing.

Request

x-api-key · string · required

Your API key for authentication

Request Body

urls · array · required

Array of product URLs to process (maximum 50 URLs per request)

Example:

[
  "https://www.nike.com/t/air-force-1-07-mens-shoes-5QFp5Z/CW2288-111",
  "https://www.adidas.com/us/gazelle-shoes/BB5476.html",
  "https://www.example-store.com/product/123"
]

enable_enrichment · boolean · default: "true"

Whether to enable AI enrichment for products. When enabled, products are enhanced with additional attributes and categorization.

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

products · array

Array of product results, one for each input URL

Show Product Result

url · string

Original URL that was processed

success · boolean

Whether the product was successfully processed

product · object | null

Product data (null if processing failed)

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

Show Variant Image Properties

id · string

Image identifier

url · string

Image URL

width · number

Image width in pixels

height · number

Image height in pixels

altText · string

Alt text for the variant image

position · number

Image position

variantIDs · array

Array of variant IDs using this image

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)

meta · object

Processing metadata and summary statistics

Show Meta Properties

total_requested · number

Total number of URLs requested for processing

total_successful · number

Number of URLs successfully processed

total_failed · number

Number of URLs that failed to process

urls_processed · array

List of all URLs that were processed (for reference)

cURL

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

Success Response

{
  "products": [
    {
      "url": "https://www.net-a-porter.com/en-us/shop/product/loeffler-randall/shoes/loafers/franco-leather-boat-shoes/46376663162925963",
      "success": true,
      "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"
      }
    },
    {
      "url": "https://www.example-store.com/invalid-product",
      "success": false,
      "product": null
    }
  ],
  "meta": {
    "total_requested": 2,
    "total_successful": 1,
    "total_failed": 1,
    "urls_processed": [
      "https://www.net-a-porter.com/en-us/shop/product/loeffler-randall/shoes/loafers/franco-leather-boat-shoes/46376663162925963",
      "https://www.example-store.com/invalid-product"
    ]
  }
}

Features

• High concurrency - Processes up to 50 URLs simultaneously
• Optimized performance - Batch processing reduces total processing time
• Partial failures - Individual URL failures don’t affect other URLs in the batch