Skip to main content
POST
/
v1
/
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)`);
  }
}

{
  "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

​
items
object[]
required
Array of partial product records to enrich (max 50).
​
schema_id
string
Reference an existing schema created via POST /v1/schemas. Mutually exclusive with columns.
​
columns
object[]
Inline column definitions for the target schema. Mutually exclusive with schema_id. If neither is provided, Lasso uses a default product schema.
​
context
string
Additional context for the AI, e.g. "These are consumer electronics for a European e-commerce catalog".
​
model
string
default:"auto"
AI model to use.
​
use_glossary
boolean
default:"false"
Apply your company glossary terms during enrichment for consistent terminology.
​
web_search
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.
​
thinking
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.
​
webhook_url
string
If provided, Lasso returns 202 immediately and delivers results via webhook. Also triggered automatically for batches larger than 5 items.

​
Response

​
id
string
Enrichment job identifier.
​
status
string
completed for sync, processing for async.
​
items
object[]
Array of enriched product records.
​
credits_used
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)`);
  }
}

{
  "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
}