{"openapi":"3.0.3","info":{"title":"Poceni deli — katalog rabljenih avtodelov","version":"1.2","description":"Public API of the used car parts stock of AVTODELI Bojan Gaberšek s.p. (Slovenia). No authentication, CORS open, please max ~2 requests/s. Stock is synced every 2 hours from bolha.com; every listed part is in stock (quantity 1). Field values are Slovene (levo/desno = left/right, spredaj/zadaj = front/rear); `name_en` gives an English name. Purchase by phone 040 376 522. Docs: https://poceni-deli.com/za-ai/"},"servers":[{"url":"https://poceni-deli.com"}],"paths":{"/api/search/":{"get":{"operationId":"searchParts","summary":"Search used car parts in stock","description":"Free text in Slovene/English/German/Croatian, OEM numbers or ad id; optional make/model/category filters. Results are ranked; page with offset (or page) + limit, follow `next`.","parameters":[{"name":"q","in":"query","schema":{"type":"string"},"description":"Free text, e.g. 'peugeot 508 zadnja leva luč', 'rear left tail light 508', an OEM number or ad id.","example":"peugeot 508 zadnja luc"},{"name":"make","in":"query","schema":{"type":"string"},"description":"Make slug from /api/makes.json, e.g. peugeot.","example":"peugeot"},{"name":"model","in":"query","schema":{"type":"string"},"description":"Model slug from /api/makes.json, e.g. 508.","example":"508"},{"name":"category","in":"query","schema":{"type":"string","enum":["karoserija","luci","stekla-ogledala","motor","menjalnik-pogon","podvozje-vzmetenje","zavore","elektrika-elektronika","notranjost","hlajenje-ogrevanje-klima","izpuh","gorivo","platisca-pnevmatike","vozilo-po-delih","ostalo"]},"description":"Category slug."},{"name":"limit","in":"query","schema":{"type":"integer","default":20,"minimum":1,"maximum":100},"description":"Results per page."},{"name":"offset","in":"query","schema":{"type":"integer","default":0,"minimum":0},"description":"Skip this many results (pagination)."},{"name":"page","in":"query","schema":{"type":"integer","minimum":1},"description":"1-based page number (alternative to offset)."}],"responses":{"200":{"description":"Search results","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchResponse"},"example":{"query":"rear left tail light peugeot 508","total":5,"offset":0,"limit":1,"has_more":true,"next":"https://poceni-deli.com/api/search/?q=rear+left+tail+light+peugeot+508&limit=1&offset=1","results":[{"id":"16683772","name":"Peugeot 508 SW 2010–2018 — zadnja leva luč","price_eur":50,"price_text":"50 €","availability":"in_stock","quantity":1}]}}}}}}},"/api/parts/{id}.json":{"get":{"operationId":"getPart","summary":"One part by id (= bolha.com ad id), incl. full description","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"example":"16683772"}],"responses":{"200":{"description":"Part","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Part"}}}},"404":{"description":"Not found — for parts: sold or never existed (HTML page)."}}}},"/api/makes.json":{"get":{"operationId":"listMakes","summary":"Makes and models in stock with counts and slugs","responses":{"200":{"description":"Makes","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Makes"}}}}}}},"/api/catalog.json":{"get":{"operationId":"fullCatalog","summary":"Full catalogue (all parts, ~2 MB)","responses":{"200":{"description":"All parts","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Catalog"}}}}}}}},"components":{"schemas":{"Part":{"type":"object","required":["id","name","title","url","price_text","condition","availability","quantity","category","images","contact_phone","bolha_url"],"properties":{"id":{"type":"string","description":"Part id = bolha.com ad id (šifra). Quote it when ordering by phone.","example":"16683772"},"name":{"type":"string","description":"Consistent Slovene name built from structured fields: make model variant years — part.","example":"Peugeot 508 SW 2010–2018 — zadnja leva luč"},"title":{"type":"string","description":"Original seller title from bolha.com (free-form, may contain typos/caps)."},"url":{"type":"string","format":"uri","description":"Part page with photos, full description and schema.org Product data."},"price_eur":{"type":"number","nullable":true,"description":"Price in EUR (VAT not charged, shipping not included). null = price on request."},"price_text":{"type":"string","description":"Human-readable price, e.g. '50 €' or 'Cena po dogovoru' (price on request)."},"condition":{"type":"string","enum":["used"],"description":"Always used (parts from dismantled vehicles)."},"availability":{"type":"string","enum":["in_stock"],"description":"Every listed part is in stock; sold parts disappear within 2 h."},"quantity":{"type":"integer","description":"Units available (used parts are unique: 1)."},"make":{"type":"string","nullable":true,"description":"Vehicle make, e.g. Peugeot."},"model":{"type":"string","nullable":true,"description":"Vehicle model, e.g. 508."},"variant":{"type":"string","nullable":true,"description":"Body/generation if stated, e.g. SW, karavan, Phase 2."},"year_from":{"type":"integer","nullable":true,"description":"First model year the part fits (from the listing)."},"year_to":{"type":"integer","nullable":true,"description":"Last model year the part fits (from the listing)."},"part":{"type":"string","nullable":true,"description":"Normalized Slovene part name, e.g. 'zadnja leva luč' (rear left tail light)."},"category":{"type":"string","description":"Part category (Slovene display name)."},"side":{"type":"string","enum":["levo","desno"],"nullable":true,"description":"Vehicle side: levo = left, desno = right."},"position":{"type":"string","enum":["spredaj","zadaj"],"nullable":true,"description":"Position: spredaj = front, zadaj = rear."},"oem_numbers":{"type":"array","items":{"type":"string"},"description":"OEM / manufacturer part numbers when stated by the seller (about 1 in 4 parts); empty if unknown."},"engine":{"type":"string","nullable":true,"description":"Engine if relevant, e.g. '1.6 HDi' or engine code."},"fits_also":{"type":"array","items":{"type":"string"},"description":"Other vehicles the seller states the part also fits; empty if not stated."},"name_en":{"type":"string","nullable":true,"description":"English name incl. vehicle."},"damage":{"type":"string","nullable":true,"description":"Defects mentioned by the seller (Slovene)."},"images":{"type":"array","items":{"type":"string","format":"uri"},"description":"Photo URLs (JPEG)."},"location":{"type":"string","nullable":true,"description":"Pick-up region."},"published":{"type":"string","format":"date-time","nullable":true,"description":"When the listing was published/renewed on bolha.com."},"contact_phone":{"type":"string","description":"Phone to order/verify stock (calls only, no SMS)."},"bolha_url":{"type":"string","format":"uri","description":"Same part on bolha.com."},"description":{"type":"string","nullable":true,"description":"Full seller description (only in /api/parts/{id}.json)."},"summary":{"type":"string","nullable":true,"description":"One-sentence Slovene summary (only in /api/parts/{id}.json)."}}},"SearchResponse":{"type":"object","required":["query","total","offset","limit","has_more","results"],"properties":{"query":{"type":"string"},"total":{"type":"integer","description":"All matches (use offset/page to get more than limit)."},"offset":{"type":"integer"},"limit":{"type":"integer"},"has_more":{"type":"boolean"},"next":{"type":"string","format":"uri","nullable":true,"description":"URL of the next page, null on the last page."},"results":{"type":"array","items":{"$ref":"#/components/schemas/Part"}},"search_page":{"type":"string","format":"uri"},"contact_phone":{"type":"string"}}},"Makes":{"type":"array","items":{"type":"object","required":["make","slug","count","url","models"],"properties":{"make":{"type":"string"},"slug":{"type":"string","description":"Use as `make` in /api/search/."},"count":{"type":"integer"},"url":{"type":"string","format":"uri"},"models":{"type":"array","items":{"type":"object","properties":{"model":{"type":"string"},"slug":{"type":"string","description":"Use as `model` in /api/search/."},"count":{"type":"integer"},"url":{"type":"string","format":"uri"}}}}}}},"Catalog":{"type":"object","required":["total","parts"],"properties":{"store":{"type":"string"},"updated":{"type":"string","format":"date-time"},"total":{"type":"integer"},"parts":{"type":"array","items":{"$ref":"#/components/schemas/Part"}}}}}}}