Enrich products

POST

enrich

const result = await client.enrich({
  items: [
    { data: { name: "Sony WF-1000XM5", sku: "WF1000XM5/B" } },
    { data: { name: "AirPods Pro 2", brand: "Apple" } },
  ],
  columns: [
    { key: "name", label: "Product Name", type: "text" },
    { key: "brand", label: "Brand", type: "text" },
    { key: "price", label: "Price", type: "number" },
    { key: "description", label: "Description", type: "text" },
    { key: "features", label: "Features", type: "tags" },
  ],
  context: "Consumer electronics for an e-commerce catalog",
});

for (const item of result.items) {
  console.log(item.data.name, "—", item.data.price);
  for (const b of item.basis) {
    console.log(`  ${b.field}: ${b.confidence} (${b.citations.length} sources)`);
  }
}

result = client.enrich(
    items=[
        {"data": {"name": "Sony WF-1000XM5", "sku": "WF1000XM5/B"}},
        {"data": {"name": "AirPods Pro 2", "brand": "Apple"}},
    ],
    columns=[
        {"key": "name", "label": "Product Name", "type": "text"},
        {"key": "brand", "label": "Brand", "type": "text"},
        {"key": "price", "label": "Price", "type": "number"},
        {"key": "description", "label": "Description", "type": "text"},
        {"key": "features", "label": "Features", "type": "tags"},
    ],
    context="Consumer electronics for an e-commerce catalog",
)

for item in result["items"]:
    print(item["data"]["name"], "—", item["data"]["price"])
    for b in item["basis"]:
        print(f"  {b['field']}: {b['confidence']} ({len(b['citations'])} sources)")

curl -X POST "https://hub.banditshq.com/api/v1/enrich" \
  -H "Authorization: Bearer lasso_..." \
  -H "Content-Type: application/json" \
  -d '{
    "items": [
      { "data": { "name": "Sony WF-1000XM5", "sku": "WF1000XM5/B" } }
    ],
    "columns": [
      { "key": "name", "label": "Product Name", "type": "text" },
      { "key": "brand", "label": "Brand", "type": "text" },
      { "key": "price", "label": "Price", "type": "number" },
      { "key": "description", "label": "Description", "type": "text" }
    ]
  }'

{
  "id": "enrich_abc123",
  "status": "completed",
  "items": [
    {
      "data": {
        "name": "Sony WF-1000XM5",
        "brand": "Sony",
        "price": 179.99,
        "description": "Premium truly wireless earbuds with industry-leading noise cancellation, LDAC codec support, and 30-hour battery life.",
        "features": ["noise cancelling", "LDAC", "30h battery", "IPX4"]
      },
      "basis": [
        {
          "field": "price",
          "citations": [
            {
              "url": "https://www.sony.com/en/headphones/wf-1000xm5",
              "title": "Sony WF-1000XM5",
              "excerpt": "Buy WF-1000XM5 Wireless Noise Cancelling Earbuds — $179.99"
            }
          ],
          "reasoning": "Price confirmed across Sony official store and major retailers.",
          "confidence": "high"
        },
        {
          "field": "features",
          "citations": [
            {
              "url": "https://www.rtings.com/headphones/reviews/sony/wf-1000xm5",
              "title": "Sony WF-1000XM5 Review - RTINGS",
              "excerpt": "Features include active noise cancellation, LDAC codec, 30h battery, IPX4 water resistance."
            }
          ],
          "reasoning": "Feature list compiled from manufacturer specs and third-party reviews.",
          "confidence": "high"
        }
      ]
    }
  ],
  "credits_used": 2
}

Enrich takes partial product records and fills in missing fields using Lasso’s product intelligence. Each enriched field comes with a basis — citations, reasoning, and confidence — so you know exactly where the data came from. No tables or files needed. Pass in what you have, get back complete product records.

Request body

object[]

required

Array of partial product records to enrich (max 50).

Show child attributes

object

required

Key-value pairs of known product data, e.g. { "name": "Sony WF-1000XM5", "sku": "WF1000XM5/B" }.

string

Reference an existing schema created via POST /v1/schemas. Mutually exclusive with columns.

object[]

Inline column definitions for the target schema. Mutually exclusive with schema_id. If neither is provided, Lasso uses a default product schema.

Show child attributes

string

required

Unique column key.

string

required

Display label.

string

required

Column type (text, number, url, tags, etc.).

string

Additional context for the AI, e.g. "These are consumer electronics for a European e-commerce catalog".

string

default:"auto"

AI model to use.

boolean

default:"false"

Apply your company glossary terms during enrichment for consistent terminology.

boolean

default:"true"

Whether to use web search for enrichment. When false, the AI fills fields from its own knowledge and no basis/citations are returned in the response. Useful for fast, low-cost enrichment when sourcing isn’t needed.

string

default:"medium"

Controls the depth of AI reasoning. Affects both quality and credit cost per item.

hard — Most capable model, best for complex or ambiguous products. 4 credits/item.
medium — Balanced speed and quality. 2 credits/item. (default)
low — Fastest, suitable for straightforward lookups. 1 credit/item.

string

If provided, Lasso returns 202 immediately and delivers results via webhook. Also triggered automatically for batches larger than 5 items.

Response

string

Enrichment job identifier.

string

completed for sync, processing for async.

object[]

Array of enriched product records.

Show child attributes

object

Complete product data with all schema columns filled in.

object[]

Per-field citations and reasoning for each enriched value. Only present when web_search is true.

Show child attributes

string

The column key this basis applies to.

object[]

Sources used: { url, title, excerpt }.

string

AI explanation of how it determined the value.

string

high, medium, or low.

number

Credits consumed. Cost per item depends on thinking: hard = 4, medium = 2, low = 1.

const result = await client.enrich({
  items: [
    { data: { name: "Sony WF-1000XM5", sku: "WF1000XM5/B" } },
    { data: { name: "AirPods Pro 2", brand: "Apple" } },
  ],
  columns: [
    { key: "name", label: "Product Name", type: "text" },
    { key: "brand", label: "Brand", type: "text" },
    { key: "price", label: "Price", type: "number" },
    { key: "description", label: "Description", type: "text" },
    { key: "features", label: "Features", type: "tags" },
  ],
  context: "Consumer electronics for an e-commerce catalog",
});

for (const item of result.items) {
  console.log(item.data.name, "—", item.data.price);
  for (const b of item.basis) {
    console.log(`  ${b.field}: ${b.confidence} (${b.citations.length} sources)`);
  }
}

result = client.enrich(
    items=[
        {"data": {"name": "Sony WF-1000XM5", "sku": "WF1000XM5/B"}},
        {"data": {"name": "AirPods Pro 2", "brand": "Apple"}},
    ],
    columns=[
        {"key": "name", "label": "Product Name", "type": "text"},
        {"key": "brand", "label": "Brand", "type": "text"},
        {"key": "price", "label": "Price", "type": "number"},
        {"key": "description", "label": "Description", "type": "text"},
        {"key": "features", "label": "Features", "type": "tags"},
    ],
    context="Consumer electronics for an e-commerce catalog",
)

for item in result["items"]:
    print(item["data"]["name"], "—", item["data"]["price"])
    for b in item["basis"]:
        print(f"  {b['field']}: {b['confidence']} ({len(b['citations'])} sources)")

curl -X POST "https://hub.banditshq.com/api/v1/enrich" \
  -H "Authorization: Bearer lasso_..." \
  -H "Content-Type: application/json" \
  -d '{
    "items": [
      { "data": { "name": "Sony WF-1000XM5", "sku": "WF1000XM5/B" } }
    ],
    "columns": [
      { "key": "name", "label": "Product Name", "type": "text" },
      { "key": "brand", "label": "Brand", "type": "text" },
      { "key": "price", "label": "Price", "type": "number" },
      { "key": "description", "label": "Description", "type": "text" }
    ]
  }'

{
  "id": "enrich_abc123",
  "status": "completed",
  "items": [
    {
      "data": {
        "name": "Sony WF-1000XM5",
        "brand": "Sony",
        "price": 179.99,
        "description": "Premium truly wireless earbuds with industry-leading noise cancellation, LDAC codec support, and 30-hour battery life.",
        "features": ["noise cancelling", "LDAC", "30h battery", "IPX4"]
      },
      "basis": [
        {
          "field": "price",
          "citations": [
            {
              "url": "https://www.sony.com/en/headphones/wf-1000xm5",
              "title": "Sony WF-1000XM5",
              "excerpt": "Buy WF-1000XM5 Wireless Noise Cancelling Earbuds — $179.99"
            }
          ],
          "reasoning": "Price confirmed across Sony official store and major retailers.",
          "confidence": "high"
        },
        {
          "field": "features",
          "citations": [
            {
              "url": "https://www.rtings.com/headphones/reviews/sony/wf-1000xm5",
              "title": "Sony WF-1000XM5 Review - RTINGS",
              "excerpt": "Features include active noise cancellation, LDAC codec, 30h battery, IPX4 water resistance."
            }
          ],
          "reasoning": "Feature list compiled from manufacturer specs and third-party reviews.",
          "confidence": "high"
        }
      ]
    }
  ],
  "credits_used": 2
}

const result = await client.enrich({
  items: [
    { data: { name: "Sony WF-1000XM5", sku: "WF1000XM5/B" } },
    { data: { name: "AirPods Pro 2", brand: "Apple" } },
  ],
  columns: [
    { key: "name", label: "Product Name", type: "text" },
    { key: "brand", label: "Brand", type: "text" },
    { key: "price", label: "Price", type: "number" },
    { key: "description", label: "Description", type: "text" },
    { key: "features", label: "Features", type: "tags" },
  ],
  context: "Consumer electronics for an e-commerce catalog",
});

for (const item of result.items) {
  console.log(item.data.name, "—", item.data.price);
  for (const b of item.basis) {
    console.log(`  ${b.field}: ${b.confidence} (${b.citations.length} sources)`);
  }
}

result = client.enrich(
    items=[
        {"data": {"name": "Sony WF-1000XM5", "sku": "WF1000XM5/B"}},
        {"data": {"name": "AirPods Pro 2", "brand": "Apple"}},
    ],
    columns=[
        {"key": "name", "label": "Product Name", "type": "text"},
        {"key": "brand", "label": "Brand", "type": "text"},
        {"key": "price", "label": "Price", "type": "number"},
        {"key": "description", "label": "Description", "type": "text"},
        {"key": "features", "label": "Features", "type": "tags"},
    ],
    context="Consumer electronics for an e-commerce catalog",
)

for item in result["items"]:
    print(item["data"]["name"], "—", item["data"]["price"])
    for b in item["basis"]:
        print(f"  {b['field']}: {b['confidence']} ({len(b['citations'])} sources)")

curl -X POST "https://hub.banditshq.com/api/v1/enrich" \
  -H "Authorization: Bearer lasso_..." \
  -H "Content-Type: application/json" \
  -d '{
    "items": [
      { "data": { "name": "Sony WF-1000XM5", "sku": "WF1000XM5/B" } }
    ],
    "columns": [
      { "key": "name", "label": "Product Name", "type": "text" },
      { "key": "brand", "label": "Brand", "type": "text" },
      { "key": "price", "label": "Price", "type": "number" },
      { "key": "description", "label": "Description", "type": "text" }
    ]
  }'

{
  "id": "enrich_abc123",
  "status": "completed",
  "items": [
    {
      "data": {
        "name": "Sony WF-1000XM5",
        "brand": "Sony",
        "price": 179.99,
        "description": "Premium truly wireless earbuds with industry-leading noise cancellation, LDAC codec support, and 30-hour battery life.",
        "features": ["noise cancelling", "LDAC", "30h battery", "IPX4"]
      },
      "basis": [
        {
          "field": "price",
          "citations": [
            {
              "url": "https://www.sony.com/en/headphones/wf-1000xm5",
              "title": "Sony WF-1000XM5",
              "excerpt": "Buy WF-1000XM5 Wireless Noise Cancelling Earbuds — $179.99"
            }
          ],
          "reasoning": "Price confirmed across Sony official store and major retailers.",
          "confidence": "high"
        },
        {
          "field": "features",
          "citations": [
            {
              "url": "https://www.rtings.com/headphones/reviews/sony/wf-1000xm5",
              "title": "Sony WF-1000XM5 Review - RTINGS",
              "excerpt": "Features include active noise cancellation, LDAC codec, 30h battery, IPX4 water resistance."
            }
          ],
          "reasoning": "Feature list compiled from manufacturer specs and third-party reviews.",
          "confidence": "high"
        }
      ]
    }
  ],
  "credits_used": 2
}

Overview

Search

Enrich

Tables

Rows

Enhance

Schemas

Attributes

Files

Glossary

Credits

Catalog

Catalog Webhooks

Enrich products

Request body

Response

​Request body

​Response

Request body

Response