Vyhledávání produktů

POST

cURL

curl --request POST \
  --url https://app.productlasso.com/api/v1/search \
  --header "Authorization: Bearer $LASSO_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "query": "Sony wireless earbuds under $200 with USB-C charging",
    "columns": [
      {"key": "product_name", "label": "Product name", "type": "text"},
      {"key": "price", "label": "Price", "type": "number"}
    ],
    "max_results": 3
  }'

const response = await fetch("https://app.productlasso.com/api/v1/search", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.LASSO_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    query: "Sony wireless earbuds under $200 with USB-C charging",
    columns: [
      { key: "product_name", label: "Product name", type: "text" },
      { key: "price", label: "Price", type: "number" },
    ],
    max_results: 3,
  }),
});

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/search",
    headers={"Authorization": f"Bearer {os.environ['LASSO_API_KEY']}"},
    json={
        "query": "Sony wireless earbuds under $200 with USB-C charging",
        "columns": [
            {"key": "product_name", "label": "Product name", "type": "text"},
            {"key": "price", "label": "Price", "type": "number"},
        ],
        "max_results": 3,
    },
    timeout=120,
)
response.raise_for_status()
result = response.json()

{
  "id": "6caa3d91-4ba7-4c14-8b31-9a7d92693ac9",
  "status": "completed",
  "query": "Sony wireless earbuds under $200 with USB-C charging",
  "results": [
    {
      "data": {
        "product_name": "Sony WF-C700N",
        "price": 119.99
      },
      "source_url": "https://example.com/products/sony-wf-c700n",
      "source_title": "Sony WF-C700N product page",
      "confidence": 0.94
    }
  ],
  "total_results": 1,
  "credits_used": 5
}

{
  "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.
max_results přijímá hodnoty 1 až 7 a výchozí hodnota je 7.
Jedno vyhledávání stojí 5 kreditů bez ohledu na počet vrácených produktů.
Bez webhook_url požadavek čeká na odpověď 200. S webhook_url Lasso vrátí 202 a dokončený výsledek odešle na vaši URL.
model je zastaralé kompatibilní pole. Služba jeho hodnotu ignoruje a používá nakonfigurovaný Gemini provider.
Při nedostatku kreditů synchronní režim aktuálně vrátí HTTP 200 s error: "Insufficient credits", prázdným polem results a credits_used: 0.

Filtry produktů zapisujte přímo do query, například Sony sluchátka do 5 000 Kč s nabíjením USB-C.

Příklady

curl --request POST \
  --url https://app.productlasso.com/api/v1/search \
  --header "Authorization: Bearer $LASSO_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "query": "Sony wireless earbuds under $200 with USB-C charging",
    "columns": [
      {"key": "product_name", "label": "Product name", "type": "text"},
      {"key": "price", "label": "Price", "type": "number"}
    ],
    "max_results": 3
  }'

const response = await fetch("https://app.productlasso.com/api/v1/search", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.LASSO_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    query: "Sony wireless earbuds under $200 with USB-C charging",
    columns: [
      { key: "product_name", label: "Product name", type: "text" },
      { key: "price", label: "Price", type: "number" },
    ],
    max_results: 3,
  }),
});

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/search",
    headers={"Authorization": f"Bearer {os.environ['LASSO_API_KEY']}"},
    json={
        "query": "Sony wireless earbuds under $200 with USB-C charging",
        "columns": [
            {"key": "product_name", "label": "Product name", "type": "text"},
            {"key": "price", "label": "Price", "type": "number"},
        ],
        "max_results": 3,
    },
    timeout=120,
)
response.raise_for_status()
result = response.json()

Example response

{
  "id": "6caa3d91-4ba7-4c14-8b31-9a7d92693ac9",
  "status": "completed",
  "query": "Sony wireless earbuds under $200 with USB-C charging",
  "results": [
    {
      "data": {"product_name": "Sony WF-C700N", "price": 119.99},
      "source_url": "https://example.com/products/sony-wf-c700n",
      "source_title": "Sony WF-C700N product page",
      "confidence": 0.94
    }
  ],
  "total_results": 1,
  "credits_used": 5
}

Autorizace

Authorization

string

header

povinné

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

Tělo

application/json

query

string

povinné

Natural language search objective

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

max_results

integer

výchozí:7

Požadovaný rozsah: 1 <= x <= 7

model

string

zastaralé

Legacy compatibility field. The service ignores the requested value and uses its configured Gemini provider.

webhook_url

string<uri>

If provided, results are delivered via webhook and 202 is returned immediately.

Odpověď

Search results in synchronous mode. Worker failures such as insufficient credits can currently appear as an error field in this HTTP 200 response.

string

status

enum<string>

Dostupné možnosti:

completed

query

string

results

object[]

Show child attributes

total_results

integer

credits_used

number

error

string

Present when the worker could not complete the search, including insufficient-credit outcomes. The current synchronous handler can still return this payload with HTTP 200.

cURL

curl --request POST \
  --url https://app.productlasso.com/api/v1/search \
  --header "Authorization: Bearer $LASSO_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "query": "Sony wireless earbuds under $200 with USB-C charging",
    "columns": [
      {"key": "product_name", "label": "Product name", "type": "text"},
      {"key": "price", "label": "Price", "type": "number"}
    ],
    "max_results": 3
  }'

const response = await fetch("https://app.productlasso.com/api/v1/search", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.LASSO_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    query: "Sony wireless earbuds under $200 with USB-C charging",
    columns: [
      { key: "product_name", label: "Product name", type: "text" },
      { key: "price", label: "Price", type: "number" },
    ],
    max_results: 3,
  }),
});

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/search",
    headers={"Authorization": f"Bearer {os.environ['LASSO_API_KEY']}"},
    json={
        "query": "Sony wireless earbuds under $200 with USB-C charging",
        "columns": [
            {"key": "product_name", "label": "Product name", "type": "text"},
            {"key": "price", "label": "Price", "type": "number"},
        ],
        "max_results": 3,
    },
    timeout=120,
)
response.raise_for_status()
result = response.json()

{
  "id": "6caa3d91-4ba7-4c14-8b31-9a7d92693ac9",
  "status": "completed",
  "query": "Sony wireless earbuds under $200 with USB-C charging",
  "results": [
    {
      "data": {
        "product_name": "Sony WF-C700N",
        "price": 119.99
      },
      "source_url": "https://example.com/products/sony-wf-c700n",
      "source_title": "Sony WF-C700N product page",
      "confidence": 0.94
    }
  ],
  "total_results": 1,
  "credits_used": 5
}

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

Vyhledávání 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