# Siyarat

> Lebanon's automotive hub — buy, sell, rent, and discover vehicles, garages, insurance, car clubs, and events.

## Public search API (JSON) — use this first

Read-only. Same public listing data as `/listings` pages. **For filtered counts (e.g. all Porsches), call the search API — the response includes `total`. Do not paginate HTML browse pages to count results.**

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

Example response shape:

```json
{
  "total": 149,
  "hasMore": true,
  "results": [{ "title": "2018 Porsche Macan", "price": 32500, "url": "https://siyarat.me/listing/..." }]
}
```

Parameters: `q`, `make`, `model`, `category`, `min_price`, `max_price`, `min_year`, `max_year`, `page`, `limit` (max 50), `sort`, `dir`

- OpenAPI: https://siyarat.me/api/public/v1/openapi.json
- Human-readable docs: https://siyarat.me/developers
- Agent map (this file): https://siyarat.me/llms.txt

Each result includes `url`, `price`, `make`, `model`, and `location`. Fetch `url` for full description and JSON-LD.

HTML browse also accepts `?q=`, `?make=`, and `?model=` and shows the result count when filtered.

## Browse and hubs

- [Home](https://siyarat.me/)
- [All listings](https://siyarat.me/listings)
- [Garages / dealerships](https://siyarat.me/garages)
- [Rentals](https://siyarat.me/rentals)
- [Insurance](https://siyarat.me/insurance)
- [Car clubs](https://siyarat.me/clubs)
- [About](https://siyarat.me/about)
- [Developers & AI agents](https://siyarat.me/developers)

## Listing categories

- [car](https://siyarat.me/listings/car)
- [motorcycle](https://siyarat.me/listings/motorcycle)
- [boat](https://siyarat.me/listings/boat)
- [parts](https://siyarat.me/listings/parts)
- [accessories](https://siyarat.me/listings/accessories)

## Detail URL patterns

- Vehicle listing: `/listing/{uuid}` — full specs, price, description, seller
- Dealership / garage: `/dealership/{slug}`
- Car club: `/club/{slug}`
- Insurance company: `/insurance/{slug}`
- Event: `/events/{uuid}`
- Seller profile: `/user/{username}`

## Sitemap

- [Main sitemap](https://siyarat.me/sitemap.xml)
- Paginated listing sitemaps: `/sitemap/listings/{page}` (linked from robots.txt)

Public pages are server-rendered HTML with JSON-LD on listings and dealerships.

## Not intended for agents

These routes are app-only, private, or thin share bridges with minimal web content:

- `/wo/` — work orders (app-only)
- `/pitch/` — private investor deck
- `/auction/`, `/service/`, `/community-post/`, `/insurance/policy/` — open-in-app previews only