Enrich partial product data

POST

enrich

cURL

curl --request POST \
  --url https://app.productlasso.com/api/v1/enrich \
  --header "Authorization: Bearer $LASSO_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "items": [{"data": {"sku": "WH-1000XM5-B", "product_name": "Sony WH-1000XM5"}}],
    "columns": [
      {"key": "brand", "label": "Brand", "type": "text"},
      {"key": "color", "label": "Color", "type": "text"}
    ],
    "thinking": "medium",
    "web_search": true
  }'

const response = await fetch("https://app.productlasso.com/api/v1/enrich", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.LASSO_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    items: [{ data: { sku: "WH-1000XM5-B", product_name: "Sony WH-1000XM5" } }],
    columns: [
      { key: "brand", label: "Brand", type: "text" },
      { key: "color", label: "Color", type: "text" },
    ],
    thinking: "medium",
    web_search: true,
  }),
});

if (!response.ok) throw new Error(await response.text());
const result = await response.json();

import os
import requests

response = requests.post(
    "https://app.productlasso.com/api/v1/enrich",
    headers={"Authorization": f"Bearer {os.environ['LASSO_API_KEY']}"},
    json={
        "items": [{"data": {"sku": "WH-1000XM5-B", "product_name": "Sony WH-1000XM5"}}],
        "columns": [
            {"key": "brand", "label": "Brand", "type": "text"},
            {"key": "color", "label": "Color", "type": "text"},
        ],
        "thinking": "medium",
        "web_search": True,
    },
    timeout=120,
)
response.raise_for_status()
result = response.json()

{
  "id": "47af2c6b-3429-4da5-b8ea-6580bc13acd4",
  "status": "completed",
  "items": [
    {
      "data": {
        "sku": "WH-1000XM5-B",
        "product_name": "Sony WH-1000XM5",
        "brand": "Sony",
        "color": "Black"
      },
      "basis": [
        {
          "field": "color",
          "citations": [
            {
              "url": "https://example.com/products/sony-wh-1000xm5",
              "title": "Sony WH-1000XM5 product page",
              "excerpt": "Available in black."
            }
          ],
          "reasoning": "The product page identifies the black variant.",
          "confidence": "high"
        }
      ]
    }
  ],
  "credits_used": 2
}

{
  "id": "<string>",
  "status": "processing",
  "estimated_credits": 123
}

{
  "status_code": 123,
  "error_type": "invalid_request",
  "message": "<string>",
  "request_id": "<string>",
  "code": "<string>",
  "retryable": true,
  "attribute_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "attribute_key": "<string>",
  "details": {},
  "current_updated_at": "2023-11-07T05:31:56Z"
}

{
  "status_code": 123,
  "error_type": "invalid_request",
  "message": "<string>",
  "request_id": "<string>",
  "code": "<string>",
  "retryable": true,
  "attribute_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "attribute_key": "<string>",
  "details": {},
  "current_updated_at": "2023-11-07T05:31:56Z"
}

Usage notes

Send either schema_id or columns, not both. Lasso uses the default Product Schema when you omit both.
A request may contain up to 50 products. Send 1 to 5 products for a synchronous response. For 6 to 50 products, you must provide webhook_url because there is no public endpoint for retrieving an Enrich job result.
thinking costs 4 credits per product for hard, 2 for medium, and 1 for low.
With web_search: false, Lasso uses model knowledge and does not return citations in basis.
Use context for instructions that apply to every item in the request.
model is a deprecated compatibility field. The service ignores it; thinking selects the service-controlled model tier.
In synchronous mode, insufficient credits currently produce HTTP 200 with error: "Insufficient credits", no enriched items, and credits_used: 0.

Do not send more than 5 items without webhook_url. The current handler accepts the request and returns 202, but it exposes no result-retrieval route for that job ID.

Examples

curl --request POST \
  --url https://app.productlasso.com/api/v1/enrich \
  --header "Authorization: Bearer $LASSO_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "items": [{"data": {"sku": "WH-1000XM5-B", "product_name": "Sony WH-1000XM5"}}],
    "columns": [
      {"key": "brand", "label": "Brand", "type": "text"},
      {"key": "color", "label": "Color", "type": "text"}
    ],
    "thinking": "medium",
    "web_search": true
  }'

const response = await fetch("https://app.productlasso.com/api/v1/enrich", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.LASSO_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    items: [{ data: { sku: "WH-1000XM5-B", product_name: "Sony WH-1000XM5" } }],
    columns: [
      { key: "brand", label: "Brand", type: "text" },
      { key: "color", label: "Color", type: "text" },
    ],
    thinking: "medium",
    web_search: true,
  }),
});

if (!response.ok) throw new Error(await response.text());
const result = await response.json();

import os
import requests

response = requests.post(
    "https://app.productlasso.com/api/v1/enrich",
    headers={"Authorization": f"Bearer {os.environ['LASSO_API_KEY']}"},
    json={
        "items": [{"data": {"sku": "WH-1000XM5-B", "product_name": "Sony WH-1000XM5"}}],
        "columns": [
            {"key": "brand", "label": "Brand", "type": "text"},
            {"key": "color", "label": "Color", "type": "text"},
        ],
        "thinking": "medium",
        "web_search": True,
    },
    timeout=120,
)
response.raise_for_status()
result = response.json()

Example response

{
  "id": "47af2c6b-3429-4da5-b8ea-6580bc13acd4",
  "status": "completed",
  "items": [
    {
      "data": {
        "sku": "WH-1000XM5-B",
        "product_name": "Sony WH-1000XM5",
        "brand": "Sony",
        "color": "Black"
      },
      "basis": [
        {
          "field": "color",
          "citations": [{"url": "https://example.com/products/sony-wh-1000xm5", "title": "Product page"}],
          "reasoning": "The product page identifies the black variant.",
          "confidence": "high"
        }
      ]
    }
  ],
  "credits_used": 2
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

items

object[]

required

Send at most 5 items for a synchronous response. Requests with 6 to 50 items require webhook_url to make the completed result retrievable.

Required array length: 1 - 50 elements

Show child attributes

schema_id

string

ID of an existing schema. Mutually exclusive with columns.

columns

object[]

Inline column definitions. Mutually exclusive with schema_id.

Show child attributes

context

string

Additional context for the AI enrichment

model

string

deprecated

Legacy compatibility field. The service ignores the requested value; thinking selects the service-controlled model tier.

use_glossary

boolean

default:false

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.

thinking

enum<string>

default:medium

Controls the depth of AI reasoning. hard — most capable model, best for complex or ambiguous products. medium — balanced speed and quality (default). low — fastest, suitable for straightforward lookups.

Available options:

hard,

medium,

low

webhook_url

string<uri>

Delivers results asynchronously and returns 202. Required for 6 to 50 items because there is no public Enrich job-result endpoint.

Response

Enrichment results for 1 to 5 items in synchronous mode. A request-wide failure such as insufficient credits can currently appear as an error field in this HTTP 200 response.

string

status

enum<string>

Available options:

completed

items

object[]

Show child attributes

credits_used

number

error

string

Present for a request-wide worker failure such as insufficient credits. The current synchronous handler can still return this payload with HTTP 200.

cURL

curl --request POST \
  --url https://app.productlasso.com/api/v1/enrich \
  --header "Authorization: Bearer $LASSO_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "items": [{"data": {"sku": "WH-1000XM5-B", "product_name": "Sony WH-1000XM5"}}],
    "columns": [
      {"key": "brand", "label": "Brand", "type": "text"},
      {"key": "color", "label": "Color", "type": "text"}
    ],
    "thinking": "medium",
    "web_search": true
  }'

const response = await fetch("https://app.productlasso.com/api/v1/enrich", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.LASSO_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    items: [{ data: { sku: "WH-1000XM5-B", product_name: "Sony WH-1000XM5" } }],
    columns: [
      { key: "brand", label: "Brand", type: "text" },
      { key: "color", label: "Color", type: "text" },
    ],
    thinking: "medium",
    web_search: true,
  }),
});

if (!response.ok) throw new Error(await response.text());
const result = await response.json();

import os
import requests

response = requests.post(
    "https://app.productlasso.com/api/v1/enrich",
    headers={"Authorization": f"Bearer {os.environ['LASSO_API_KEY']}"},
    json={
        "items": [{"data": {"sku": "WH-1000XM5-B", "product_name": "Sony WH-1000XM5"}}],
        "columns": [
            {"key": "brand", "label": "Brand", "type": "text"},
            {"key": "color", "label": "Color", "type": "text"},
        ],
        "thinking": "medium",
        "web_search": True,
    },
    timeout=120,
)
response.raise_for_status()
result = response.json()

{
  "id": "47af2c6b-3429-4da5-b8ea-6580bc13acd4",
  "status": "completed",
  "items": [
    {
      "data": {
        "sku": "WH-1000XM5-B",
        "product_name": "Sony WH-1000XM5",
        "brand": "Sony",
        "color": "Black"
      },
      "basis": [
        {
          "field": "color",
          "citations": [
            {
              "url": "https://example.com/products/sony-wh-1000xm5",
              "title": "Sony WH-1000XM5 product page",
              "excerpt": "Available in black."
            }
          ],
          "reasoning": "The product page identifies the black variant.",
          "confidence": "high"
        }
      ]
    }
  ],
  "credits_used": 2
}

{
  "id": "<string>",
  "status": "processing",
  "estimated_credits": 123
}

{
  "status_code": 123,
  "error_type": "invalid_request",
  "message": "<string>",
  "request_id": "<string>",
  "code": "<string>",
  "retryable": true,
  "attribute_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "attribute_key": "<string>",
  "details": {},
  "current_updated_at": "2023-11-07T05:31:56Z"
}

{
  "status_code": 123,
  "error_type": "invalid_request",
  "message": "<string>",
  "request_id": "<string>",
  "code": "<string>",
  "retryable": true,
  "attribute_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "attribute_key": "<string>",
  "details": {},
  "current_updated_at": "2023-11-07T05:31:56Z"
}

Overview

Search

Enrich

Tables

Rows

Enhance

Schemas

Attributes

Files

Glossary

Credits

Product analytics

Catalog

Catalog Webhooks

Enrich partial product data

Usage notes

Examples

Authorizations

Body

Response

​Usage notes

​Examples

Authorizations

Body

Response

Usage notes

Examples