{"openapi":"3.1.0","info":{"title":"ksmotors.kz — поиск автозапчастей / car parts search","version":"1.0.0","description":"Public search over the ksmotors.kz catalogue of Hyundai, Kia and Genesis car parts (Astana, Kazakhstan). Prices in KZT, live warehouse stock, OEM numbers. Queries may be natural language in Russian or English, or a raw OEM number. Results are ranked by an AI model by default.","contact":{"name":"ksmotors.kz","url":"https://ks-motors.kz"}},"servers":[{"url":"https://ks-motors.kz"}],"paths":{"/shop-api/parts-search":{"get":{"operationId":"searchParts","summary":"Search car parts by name, OEM number, car model or a natural-language question","parameters":[{"name":"q","in":"query","required":true,"description":"Search query: 'тормозные колодки Rio 2015', 'front brake pads Kia Rio', or an OEM number like 865B4S8BA0.","schema":{"type":"string"}},{"name":"category","in":"query","required":false,"description":"Category slug, as listed in /llms.txt.","schema":{"type":"string"}},{"name":"ai","in":"query","required":false,"description":"1 = force AI ranking (default for people and AI assistants), 0 = plain substring search.","schema":{"type":"string","enum":["0","1"]}}],"responses":{"200":{"description":"Ranked search results","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchResponse"}}}}}}}},"components":{"schemas":{"SearchResponse":{"type":"object","properties":{"ok":{"type":"boolean"},"results":{"type":"array","items":{"$ref":"#/components/schemas/Part"}},"ai":{"type":"object","description":"How the query was understood.","properties":{"enabled":{"type":"boolean"},"used":{"type":"boolean","description":"true if the model ranked these results"},"mode":{"type":"string","enum":["ranked","parsed","literal","empty"]},"interpretation":{"type":"string","description":"Short Russian phrase: what the customer is looking for"},"bestMatchId":{"type":["integer","null"]},"bestMatchReason":{"type":"string"}}}}},"Part":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string","description":"Part name in Russian"},"slug":{"type":"string","description":"Detail page: https://ks-motors.kz/ru/parts/{slug}"},"oem":{"type":"string","description":"OEM / catalogue number"},"description":{"type":"string"},"fromPrice":{"type":"number","description":"Price, KZT, at the first warehouse (in the shop's own order) that has the part in stock"},"totalQuantity":{"type":"integer","description":"Units in stock across warehouses"},"isOnOrder":{"type":"boolean","description":"true = not in stock, supplied on order"},"category_name":{"type":"string"},"manufacturer_name":{"type":"string"},"marks":{"type":"array","items":{"type":"object"},"description":"Car makes it fits"},"car_models":{"type":"array","items":{"type":"object"},"description":"Car models it fits"},"years":{"type":"array","items":{"type":"object"},"description":"Model years it fits"},"imageUrl":{"type":["string","null"]},"isBestMatch":{"type":"boolean"},"matchScore":{"type":["integer","null"],"description":"AI relevance score, 0-100"}}}}}}