Public API

Developers & AI agents

Siyarat exposes a read-only JSON search API for public vehicle listings. It returns the same approved, active listings shown on siyarat.me/listings, including an exact match count in the total field.

Search listings (JSON)

Use this for filtered queries — for example, count all Porsches in one request instead of paginating HTML browse pages.

GET https://siyarat.me/api/public/v1/listings/search?make=Porsche&category=car

More examples:

Free text: https://siyarat.me/api/public/v1/listings/search?q=porsche&category=car
Make + model: https://siyarat.me/api/public/v1/listings/search?make=Porsche&model=Cayenne&category=car
Price range: https://siyarat.me/api/public/v1/listings/search?category=car&min_price=10000&max_price=50000

Parameters

q, make, model, category (car, motorcycle, boat, parts, accessories), min_price, max_price, min_year, max_year, page, limit (max 50), sort, dir

Each result includes url (link to the full HTML detail page with JSON-LD), price, make, model, and location.

HTML browse

Filtered browse pages accept the same query parameters and show the result count in the page body, for example /listings/car?make=Porsche.

More docs

llms.txt — agent navigation map
OpenAPI 3.1 spec
Sitemap — discover all public listing URLs

Limits

Public read-only access. Rate limit: 60 requests per minute per IP. No API key required. Authenticated app features (messaging, posting, bookings) are app-only and not available via this API.

Ready to browse listings, book services, or join the community?

Get the Siyarat app