Extract Product Catalog Entry

Extract product name, SKU, price, and specifications from a catalog document into structured JSON for e-commerce workflows.

Who this is for

E-commerce teams and marketplace operators use this recipe to digitize a supplier catalog entry. Upload a catalog PDF and receive structured JSON with product name, SKU, price, and description — ready for import into your product database or storefront.

Request
curl -X POST https://api.iterationlayer.com/document-extraction/v1/extract \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "files": [
      {
        "type": "url",
        "name": "catalog.pdf",
        "url": "https://example.com/catalogs/supplier-catalog.pdf"
      }
    ],
    "schema": {
      "fields": [
        {
          "name": "products",
          "type": "ARRAY",
          "description": "List of products in the catalog",
          "fields": [
            {
              "name": "name",
              "type": "TEXT",
              "description": "Product name"
            },
            {
              "name": "sku",
              "type": "TEXT",
              "description": "Stock keeping unit identifier"
            },
            {
              "name": "price",
              "type": "CURRENCY_AMOUNT",
              "description": "Product price"
            },
            {
              "name": "description",
              "type": "TEXTAREA",
              "description": "Product description"
            }
          ]
        }
      ]
    }
  }'
Response
{
  "success": true,
  "data": {
    "products": {
      "value": [
        {
          "name": {
            "value": "ProGrip Wireless Mouse",
            "confidence": 0.97,
            "citations": [
              "ProGrip Wireless Mouse"
            ]
          },
          "sku": {
            "value": "PG-WM-2026",
            "confidence": 0.99,
            "citations": ["SKU: PG-WM-2026"]
          },
          "price": {
            "value": {
              "amount": "34.99",
              "currency": "USD"
            },
            "confidence": 0.98,
            "citations": ["$34.99"]
          },
          "description": {
            "value": "Ergonomic wireless mouse with 2.4GHz connectivity, 1600 DPI sensor, and rechargeable battery lasting up to 90 days.",
            "confidence": 0.94,
            "citations": [
              "Ergonomic wireless mouse with 2.4GHz connectivity"
            ]
          }
        },
        {
          "name": {
            "value": "UltraType Mechanical Keyboard",
            "confidence": 0.96,
            "citations": [
              "UltraType Mechanical Keyboard"
            ]
          },
          "sku": {
            "value": "UT-MK-1050",
            "confidence": 0.99,
            "citations": ["SKU: UT-MK-1050"]
          },
          "price": {
            "value": {
              "amount": "89.00",
              "currency": "USD"
            },
            "confidence": 0.97,
            "citations": ["$89.00"]
          },
          "description": {
            "value": "Full-size mechanical keyboard with Cherry MX Brown switches, RGB backlighting, and detachable USB-C cable.",
            "confidence": 0.93,
            "citations": [
              "Full-size mechanical keyboard with Cherry MX Brown switches"
            ]
          }
        }
      ],
      "confidence": 0.95,
      "citations": []
    }
  }
}
Request
import { IterationLayer } from "iterationlayer";
const client = new IterationLayer({ apiKey: "YOUR_API_KEY" });

const result = await client.extract({
  files: [
    {
      type: "url",
      name: "catalog.pdf",
      url: "https://example.com/catalogs/supplier-catalog.pdf",
    },
  ],
  schema: {
    fields: [
      {
        name: "products",
        type: "ARRAY",
        description: "List of products in the catalog",
        fields: [
          {
            name: "name",
            type: "TEXT",
            description: "Product name",
          },
          {
            name: "sku",
            type: "TEXT",
            description: "Stock keeping unit identifier",
          },
          {
            name: "price",
            type: "CURRENCY_AMOUNT",
            description: "Product price",
          },
          {
            name: "description",
            type: "TEXTAREA",
            description: "Product description",
          },
        ],
      },
    ],
  },
});

console.log(result);
Response
{
  "success": true,
  "data": {
    "products": {
      "value": [
        {
          "name": {
            "value": "ProGrip Wireless Mouse",
            "confidence": 0.97,
            "citations": [
              "ProGrip Wireless Mouse"
            ]
          },
          "sku": {
            "value": "PG-WM-2026",
            "confidence": 0.99,
            "citations": ["SKU: PG-WM-2026"]
          },
          "price": {
            "value": {
              "amount": "34.99",
              "currency": "USD"
            },
            "confidence": 0.98,
            "citations": ["$34.99"]
          },
          "description": {
            "value": "Ergonomic wireless mouse with 2.4GHz connectivity, 1600 DPI sensor, and rechargeable battery lasting up to 90 days.",
            "confidence": 0.94,
            "citations": [
              "Ergonomic wireless mouse with 2.4GHz connectivity"
            ]
          }
        },
        {
          "name": {
            "value": "UltraType Mechanical Keyboard",
            "confidence": 0.96,
            "citations": [
              "UltraType Mechanical Keyboard"
            ]
          },
          "sku": {
            "value": "UT-MK-1050",
            "confidence": 0.99,
            "citations": ["SKU: UT-MK-1050"]
          },
          "price": {
            "value": {
              "amount": "89.00",
              "currency": "USD"
            },
            "confidence": 0.97,
            "citations": ["$89.00"]
          },
          "description": {
            "value": "Full-size mechanical keyboard with Cherry MX Brown switches, RGB backlighting, and detachable USB-C cable.",
            "confidence": 0.93,
            "citations": [
              "Full-size mechanical keyboard with Cherry MX Brown switches"
            ]
          }
        }
      ],
      "confidence": 0.95,
      "citations": []
    }
  }
}
Request
from iterationlayer import IterationLayer
client = IterationLayer(api_key="YOUR_API_KEY")

result = client.extract(
    files=[
        {
            "type": "url",
            "name": "catalog.pdf",
            "url": "https://example.com/catalogs/supplier-catalog.pdf",
        }
    ],
    schema={
        "fields": [
            {
                "name": "products",
                "type": "ARRAY",
                "description": "List of products in the catalog",
                "fields": [
                    {
                        "name": "name",
                        "type": "TEXT",
                        "description": "Product name",
                    },
                    {
                        "name": "sku",
                        "type": "TEXT",
                        "description": "Stock keeping unit identifier",
                    },
                    {
                        "name": "price",
                        "type": "CURRENCY_AMOUNT",
                        "description": "Product price",
                    },
                    {
                        "name": "description",
                        "type": "TEXTAREA",
                        "description": "Product description",
                    },
                ],
            },
        ]
    },
)

print(result)
Response
{
  "success": true,
  "data": {
    "products": {
      "value": [
        {
          "name": {
            "value": "ProGrip Wireless Mouse",
            "confidence": 0.97,
            "citations": [
              "ProGrip Wireless Mouse"
            ]
          },
          "sku": {
            "value": "PG-WM-2026",
            "confidence": 0.99,
            "citations": ["SKU: PG-WM-2026"]
          },
          "price": {
            "value": {
              "amount": "34.99",
              "currency": "USD"
            },
            "confidence": 0.98,
            "citations": ["$34.99"]
          },
          "description": {
            "value": "Ergonomic wireless mouse with 2.4GHz connectivity, 1600 DPI sensor, and rechargeable battery lasting up to 90 days.",
            "confidence": 0.94,
            "citations": [
              "Ergonomic wireless mouse with 2.4GHz connectivity"
            ]
          }
        },
        {
          "name": {
            "value": "UltraType Mechanical Keyboard",
            "confidence": 0.96,
            "citations": [
              "UltraType Mechanical Keyboard"
            ]
          },
          "sku": {
            "value": "UT-MK-1050",
            "confidence": 0.99,
            "citations": ["SKU: UT-MK-1050"]
          },
          "price": {
            "value": {
              "amount": "89.00",
              "currency": "USD"
            },
            "confidence": 0.97,
            "citations": ["$89.00"]
          },
          "description": {
            "value": "Full-size mechanical keyboard with Cherry MX Brown switches, RGB backlighting, and detachable USB-C cable.",
            "confidence": 0.93,
            "citations": [
              "Full-size mechanical keyboard with Cherry MX Brown switches"
            ]
          }
        }
      ],
      "confidence": 0.95,
      "citations": []
    }
  }
}
Request
package main

import (
    "fmt"
    il "github.com/iterationlayer/sdk-go"
)

func main() {
    client := il.NewClient("YOUR_API_KEY")

    result, err := client.Extract(il.ExtractRequest{
        Files: []il.FileInput{
            il.NewFileFromURL(
                "catalog.pdf",
                "https://example.com/catalogs/supplier-catalog.pdf",
            ),
        },
        Schema: il.ExtractionSchema{
            "products": il.NewArrayFieldConfig(
                "products",
                "List of products in the catalog",
                il.ExtractionSchema{
                    "name": il.NewTextFieldConfig(
                        "name", "Product name",
                    ),
                    "sku": il.NewTextFieldConfig(
                        "sku", "Stock keeping unit identifier",
                    ),
                    "price": il.NewCurrencyAmountFieldConfig(
                        "price", "Product price",
                    ),
                    "description": il.NewTextFieldConfig(
                        "description", "Product description",
                    ),
                },
            ),
        },
    })
    if err != nil {
        panic(err)
    }

    fmt.Println(result)
}
Response
{
  "success": true,
  "data": {
    "products": {
      "value": [
        {
          "name": {
            "value": "ProGrip Wireless Mouse",
            "confidence": 0.97,
            "citations": [
              "ProGrip Wireless Mouse"
            ]
          },
          "sku": {
            "value": "PG-WM-2026",
            "confidence": 0.99,
            "citations": ["SKU: PG-WM-2026"]
          },
          "price": {
            "value": {
              "amount": "34.99",
              "currency": "USD"
            },
            "confidence": 0.98,
            "citations": ["$34.99"]
          },
          "description": {
            "value": "Ergonomic wireless mouse with 2.4GHz connectivity, 1600 DPI sensor, and rechargeable battery lasting up to 90 days.",
            "confidence": 0.94,
            "citations": [
              "Ergonomic wireless mouse with 2.4GHz connectivity"
            ]
          }
        },
        {
          "name": {
            "value": "UltraType Mechanical Keyboard",
            "confidence": 0.96,
            "citations": [
              "UltraType Mechanical Keyboard"
            ]
          },
          "sku": {
            "value": "UT-MK-1050",
            "confidence": 0.99,
            "citations": ["SKU: UT-MK-1050"]
          },
          "price": {
            "value": {
              "amount": "89.00",
              "currency": "USD"
            },
            "confidence": 0.97,
            "citations": ["$89.00"]
          },
          "description": {
            "value": "Full-size mechanical keyboard with Cherry MX Brown switches, RGB backlighting, and detachable USB-C cable.",
            "confidence": 0.93,
            "citations": [
              "Full-size mechanical keyboard with Cherry MX Brown switches"
            ]
          }
        }
      ],
      "confidence": 0.95,
      "citations": []
    }
  }
}

Related Recipes

Start building in minutes

Free trial credits included. No credit card required.