riyasewana.com APIriyasewana.com ↗
Access Sri Lanka vehicle listings from Riyasewana via API. Browse by category, search with filters, and retrieve full specs, images, and seller info.
curl -X GET 'https://api.parse.bot/scraper/a20b5c9d-d197-43eb-a622-4b464d151c87/get_listings?page=2&category=motorcycles' \ -H 'X-API-Key: $PARSE_API_KEY'
Fetch paginated vehicle listings for a given category. Returns up to 40 listings per page with title, price, year, city, mileage, and posting date.
| Param | Type | Description |
|---|---|---|
| page | string | Page number for pagination |
| category | string | Vehicle category slug. Accepted values: cars, suvs, vans, motorcycles, three-wheels, pickups, lorries, heavy-duty, spare-parts |
{
"type": "object",
"fields": {
"page": "integer - current page number",
"category": "string - the requested category slug",
"listings": "array of objects with title, url, thumbnail, city, price, year, mileage, date_posted",
"total_results": "integer - total number of listings in this category"
},
"sample": {
"data": {
"page": 2,
"category": "motorcycles",
"listings": [
{
"url": "https://riyasewana.com/buy/honda-dio-sale-nittambuwa-11596833",
"city": "Nittambuwa",
"year": "2026",
"price": "Rs. 735,000",
"title": "Honda Dio 2026 Motorbike",
"mileage": "",
"thumbnail": "https://riyasewana.com/thumb/thumbhonda-dio-620120213411.jpg",
"date_posted": "8h ago"
}
],
"total_results": 21607
},
"status": "success"
}
}About the riyasewana.com API
The Riyasewana API exposes 3 endpoints covering Sri Lanka's largest vehicle marketplace, returning listings across cars, SUVs, motorcycles, lorries, and more. The get_listings endpoint delivers paginated results by category with title, price, year, city, mileage, and posting date, while search_vehicles lets you filter by make, model, fuel type, transmission, price range, and year range. A third endpoint retrieves full listing details including high-resolution images and vehicle options.
Browse and Search Vehicle Listings
The get_listings endpoint returns up to 40 vehicles per page for eight category slugs: cars, suvs, vans, motorcycles, three-wheels, pickups, lorries, and heavy-d. Each listing in the response includes title, url, thumbnail, city, price, year, mileage, and date_posted, plus a total_results count for the full category. Paginate through results using the page parameter.
Filtered Search
search_vehicles accepts up to eight filter parameters simultaneously: make (e.g., Toyota, Honda), model (e.g., Prius, Alto), city (e.g., Colombo, Kandy), fuel (petrol, diesel, electric, hybrid), year_min, year_max, and price_max in LKR. The response mirrors the listings shape from get_listings and also returns a search_url field that encodes the resolved query, which you can use to anchor pagination across subsequent calls.
Full Listing Detail
get_listing_detail accepts any Riyasewana listing URL and returns the complete record: make, model, year, gear (transmission), price, options (comma-separated features), an images array of full-resolution URLs, and a contact field for the seller's phone number. Note that contact may be empty for some listings — the phone number is not guaranteed to be present in all cases.
Coverage Notes
All prices are denominated in LKR (Sri Lankan Rupees). The API covers the publicly visible listings on Riyasewana without requiring account authentication. Category slugs and fuel type values are fixed enumerations; passing an unsupported value will return no results rather than an error.
- Build a price-tracker that monitors LKR asking prices for a specific make/model combination over time using
search_vehicles - Aggregate mileage and year distributions across the
carsorsuvscategory to analyze the Sri Lankan used-car market - Pull full-resolution listing images via
get_listing_detailto populate a vehicle comparison tool - Alert users when new motorcycles or three-wheelers appear in a target city by polling
get_listingswith the relevant category slug - Feed vehicle specs and options from
get_listing_detailinto an inventory database for a Sri Lankan dealership or broker - Filter by
fueltype (electric or hybrid) across cities to research EV availability in the Sri Lankan market - Map listings geographically by extracting the
cityfield from paginatedget_listingsresults
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Riyasewana offer an official developer API?+
What does the `search_vehicles` endpoint return that `get_listings` does not?+
search_vehicles supports cross-cutting filters — make, model, city, fuel type, year range, and price ceiling — that get_listings does not. It also returns a search_url field encoding the resolved query, which is useful for stable pagination. Both endpoints return the same listing fields: title, url, thumbnail, city, price, year, mileage, and date_posted.Is the seller phone number always available in `get_listing_detail`?+
contact field in get_listing_detail is populated when a phone number is accessible, but it may be empty. Some listings require a user interaction on the site to reveal the number, and in those cases the field will return an empty string.Does the API cover commercial vehicles or only personal vehicles?+
category parameter in get_listings includes lorries, pickups, and heavy-d alongside personal-vehicle categories like cars, suvs, and motorcycles. All eight category slugs are supported for paginated browsing.Can I retrieve saved searches, user profiles, or dealer inventory pages?+
get_listings, filtered search via search_vehicles, and individual listing detail via get_listing_detail. User accounts, saved searches, and dealer profile pages are not exposed. You can fork this API on Parse and revise it to add an endpoint targeting dealer or seller profile pages.