Přejít na hlavní obsah
POST
/
v1
/
search
const results = await client.search({
  query: "Sony bezdrátová sluchátka s potlačením hluku",
  max_results: 3,
});
{
  "id": "<string>",
  "status": "<string>",
  "results": [
    {}
  ],
  "total_results": 123,
  "credits_used": 123
}
Vyhledávejte v databázi Lasso produkty odpovídající dotazu v přirozeném jazyce. Lasso najde odpovídající produkty a strukturuje výsledky do vašeho schématu — vrací typovaná, normalizovaná data se zdrojovými URL a skóre spolehlivosti. Není potřeba žádná tabulka ani soubory. Jedno volání, strukturovaná produktová data zpět.

Tělo požadavku

query
string
povinné
Vyhledávací dotaz v přirozeném jazyce. Filtry vložte přímo do textu, např. "Sony bezdrátová sluchátka s potlačením hluku do 5000 Kč".
schema_id
string
Odkaz na existující schéma vytvořené přes POST /v1/schemas. Vzájemně se vylučuje s columns.
columns
object[]
Inline definice sloupců popisující výstupní tvar. Vzájemně se vylučuje se schema_id. Pokud není zadáno ani jedno, Lasso použije výchozí produktové schéma.
max_results
integer
výchozí:"7"
Maximální počet produktů k vrácení (1–7).
model
string
výchozí:"auto"
AI model pro strukturování výsledků.
webhook_url
string
Pokud je zadáno, Lasso vrátí 202 okamžitě a výsledky doručí přes webhook.

Odpověď

id
string
Identifikátor vyhledávací úlohy.
status
string
completed pro synchronní, processing pro asynchronní režim.
results
object[]
Pole strukturovaných produktových výsledků.
total_results
integer
Počet vrácených produktů.
credits_used
number
Spotřebované kredity (5 za vyhledávání).
const results = await client.search({
  query: "Sony bezdrátová sluchátka s potlačením hluku",
  max_results: 3,
});