{"openapi":"3.1.0","info":{"title":"Siyarat Public Listings API","version":"1.0.0","description":"Read-only search over public vehicle listings on Siyarat (Lebanon). Same data as the /listings web pages."},"servers":[{"url":"https://siyarat.me/"}],"paths":{"/api/public/v1/listings/search":{"get":{"operationId":"searchListings","summary":"Search public listings","description":"Search and filter approved active listings. Each result includes a url to the full HTML detail page with JSON-LD.","parameters":[{"name":"q","in":"query","schema":{"type":"string"},"description":"Free-text search (make, model, keywords)"},{"name":"make","in":"query","schema":{"type":"string"},"description":"Vehicle make name or numeric make ID"},{"name":"model","in":"query","schema":{"type":"string"},"description":"Vehicle model name or numeric model ID"},{"name":"category","in":"query","schema":{"type":"string","enum":["car","motorcycle","boat","parts","accessories"],"default":"car"}},{"name":"min_price","in":"query","schema":{"type":"integer"}},{"name":"max_price","in":"query","schema":{"type":"integer"}},{"name":"min_year","in":"query","schema":{"type":"integer"}},{"name":"max_year","in":"query","schema":{"type":"integer"}},{"name":"page","in":"query","schema":{"type":"integer","minimum":1,"default":1}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":50,"default":20}},{"name":"sort","in":"query","schema":{"type":"string","enum":["newest","price","year","mileage"],"default":"newest"}},{"name":"dir","in":"query","schema":{"type":"string","enum":["asc","desc"],"default":"desc"}}],"responses":{"200":{"description":"Search results","content":{"application/json":{"schema":{"type":"object","required":["query","total","hasMore","results"],"properties":{"query":{"type":"object"},"total":{"type":"integer"},"hasMore":{"type":"boolean"},"results":{"type":"array","items":{"type":"object","required":["id","title","price","currency","category","url"],"properties":{"id":{"type":"string","format":"uuid"},"title":{"type":"string"},"make":{"type":"string","nullable":true},"model":{"type":"string","nullable":true},"year":{"type":"integer","nullable":true},"price":{"type":"number"},"currency":{"type":"string"},"mileage":{"type":"integer","nullable":true},"mileageUnit":{"type":"string","enum":["km","mi"],"nullable":true},"location":{"type":"string","nullable":true},"category":{"type":"string"},"imageUrl":{"type":"string","nullable":true},"url":{"type":"string","format":"uri"}}}}}},"example":{"query":{"q":null,"make":"Porsche","model":null,"category":"car","page":1,"limit":20},"total":14,"hasMore":false,"results":[{"id":"34f490d3-9f78-4165-ae00-e8bd2899af15","title":"1999 Porsche 718 Boxster","make":"Porsche","model":"718 Boxster","year":1999,"price":6300,"currency":"USD","mileage":75000,"mileageUnit":"km","location":"Zgharta","category":"car","imageUrl":"https://siyarat.me/images/ogimage.png","url":"https://siyarat.me/listing/34f490d3-9f78-4165-ae00-e8bd2899af15"}]}}}},"400":{"description":"Invalid query parameters"},"429":{"description":"Rate limit exceeded"},"503":{"description":"Search temporarily unavailable"}}}}},"externalDocs":{"description":"Agent navigation map","url":"https://siyarat.me/llms.txt"},"x-search-url":"https://siyarat.me/api/public/v1/listings/search"}