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
}

Documentation Index

Fetch the complete documentation index at: https://productlasso.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

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
}