Obohacení produktů

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

Poznámky k použití

Odešlete buď schema_id, nebo columns, nikdy obojí. Když vynecháte obě pole, Lasso použije výchozí Product Schema.
Požadavek může obsahovat nejvýše 50 produktů. Pro synchronní odpověď odešlete 1 až 5 produktů. Pro 6 až 50 produktů musíte zadat webhook_url, protože veřejný endpoint pro načtení výsledku Enrich úlohy neexistuje.
thinking stojí 4 kredity za produkt pro hard, 2 pro medium a 1 pro low.
S web_search: false Lasso používá znalosti modelu a v poli basis nevrací citace.
Pole context použijte pro pokyny, které platí pro všechny položky požadavku.
model je zastaralé kompatibilní pole. Služba ho ignoruje; úroveň thinking vybírá modelový tier řízený službou.
Při nedostatku kreditů synchronní režim aktuálně vrátí HTTP 200 s error: "Insufficient credits", bez obohacených položek a s credits_used: 0.

Bez webhook_url neposílejte více než 5 položek. Aktuální handler požadavek přijme a vrátí 202, ale pro dané ID neposkytuje cestu k načtení výsledku.

Příklady

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
}

Autorizace

Authorization

string

header

povinné

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

Tělo

application/json

items

object[]

povinné

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

zastaralé

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

use_glossary

boolean

výchozí:false

web_search

boolean

výchozí: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>

výchozí: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.

Dostupné možnosti:

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.

Odpověď

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>

Dostupné možnosti:

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

Přehled

Vyhledávání

Obohacení dat

Tabulky

Řádky

Obohacení

Schémata

Atributy

Soubory

Slovník

Kredity

Produktová analytika

Katalog

Webhooky katalogu

Obohacení produktů

Poznámky k použití

Příklady

Autorizace

Tělo

Odpověď

​Poznámky k použití

​Příklady

Autorizace

Tělo

Odpověď

Poznámky k použití

Příklady