Skip to content
Happy Endpoint
Syarah API
API v1.0 Syarah

Syarah API

Saudi car data from Syarah: used and new cars for sale with prices in SAR, car details, inspection reports, a price guide, financing and service centres.

Get on RapidAPI

Overview

The Syarah API provides Saudi car data from syarah.com, an online car retailer in Saudi Arabia selling its own stock and partner dealer cars. Search used and new cars for sale with prices in SAR, read full car details and inspection reports, and check the Syarah price guide by make, model, year and trim, in English and Arabic.

Search and data coverage

/makes, /models and /trims return the catalog ids, and /search-filters lists every filter option. /search filters by make, model, trim, year, price, mileage, monthly instalment, condition, colour, body, fuel, transmission and features. /search-suggestions, /deals and /trends support search pages, and /search-by-url runs a pasted syarah.com link.

/car-details returns specifications, equipment, price and gallery, and /car-inspection-report returns the inspection score, body parts and their state, maintenance notes and the VIN. /similar-cars, /cars-by-ids and /recommended-cars return listing cards. /price-guide returns minimum, average and maximum prices per trim and model year. Other routes cover financing requirements, oil change products, authorised service centres by make and city, customer reviews, FAQs and Syarah’s car guide articles.

What you can build

  • Saudi used and new car search with prices in SAR
  • Car valuation from the Syarah price guide by make, model and trim
  • Inspection reports with VIN and body condition
  • Monthly instalments, financing requirements and service centres

Coverage and comparison tips

Syarah sells its own stock and partner dealer cars, so listings are more uniform than on open classifieds such as Haraj or OpenSooq. Use /cars-by-ids to check which saved cars have sold. Compare listing prices with the price guide for the same trim and model year.

Getting started

Start with /makes to discover the identifiers and filter values used by the routes above. Then test a focused request such as /search?query=camry and inspect its JSON response before adding more filters or pagination. The endpoint list below reflects the supplied OpenAPI specification.

Subscribe to the Syarah API on RapidAPI to get your API key and view current plans and request limits. Send your key in the X-RapidAPI-Key header and use X-RapidAPI-Host: syarah.p.rapidapi.com for requests.

Compare this API with the other car data sources for the region in the Middle East car data guide. Explore Motory API, Haraj API and OpenSooq API, or browse the API library for other markets and platforms.

Disclaimer

This API is an independent service built by HappyEndpoint. It is not affiliated with, endorsed, or sponsored by Syarah. All data is retrieved from publicly available sources.

What you can do

Saudi used and new car search with prices in SAR
Car valuation from the Syarah price guide by make, model and trim
Inspection reports with VIN and body condition
Monthly instalments, financing requirements and service centres

Endpoints & Schema

MethodPathSummary
GET/statusCheck whether the Syarah API is available.
GET/makesList every car make in the catalog with its id, English and Arabic name and logo, whether or not it has cars for sale today.
GET/modelsList one make's models with their ids and English and Arabic names. Takes a make_id from /makes; pass a model id to /trims, or as model_id (together with its make_id) to /search.
GET/trimsList one model's trims (grades) with their ids and names, and the make the model belongs to.
GET/search-filtersGet the car search's filter options - makes, models, trims, years, price, mileage, monthly instalment, colours, body, fuel, transmission, drivetrain, engine, seats and features...
GET/search-suggestionsTurn typed text into up to six search suggestions such as a make or a make and model, or get the popular suggestions when no text is sent.
GET/dealsList the current car deals and promotions with their names and banner images.
GET/searchSearch the cars for sale by make, model, trim, year, price, mileage, monthly instalment, condition, colour, body, fuel, transmission, drivetrain, engine size, seats, features...
GET/search-by-urlRun the car search a pasted syarah.com search-page link describes - a make, model, year, condition, make-country or filter page - and get the same rows as /search.
GET/trendsList the site's trend pages - curated car searches such as a make in a city, a body type or a price band - with their titles, descriptions, images and saved search, one page at...
GET/car-detailsRead one car in full: specifications, equipment, price, gallery and the other sections of its car page.
GET/car-details-by-urlRead a car in full from its syarah.com car page link, the same result as /car-details without looking up the id first. Takes a url, for example the product_url of a /search row.
GET/car-inspection-reportRead one car's inspection report: score, inspected body parts and their state, maintenance notes, report dates, the VIN (chassis_number) and plate number.
GET/similar-carsList cars for sale that are similar to one car, as listing cards like /search rows. Takes a car_id from a /search row and an optional limit; open a row's id in /car-details.
GET/cars-by-idsFetch the current listing cards of up to 100 known cars in one call, in the order asked, and list the ids that return no card (sold, removed or unknown).
GET/recommended-carsList the cars the site recommends to a new visitor, as listing cards with their recommendation order. Takes only lang; open a row's id in /car-details.
GET/price-guideRead the site's published price guide for a make, model or model year: per trim and for the model year as a whole, the minimum, average and maximum price, in English and Arabic.
GET/financing-requirementsRead the conditions a buyer must meet to finance a car and the documents to provide, for new or for used cars.
GET/oil-productsList the engine-oil change coupons on sale with their brand, title, options and prices. Takes only lang; open a product's id in /oil-product-details.
GET/oil-product-detailsRead one oil-change coupon product in full: gallery, purchase options with prices, features, specifications and its FAQ. Takes a product_id from /oil-products.
GET/service-center-filtersList the choices of the authorised car service-centre directory: the makes with centres, the cities and the authorised dealerships, optionally narrowed to one make and city.
GET/service-centersList one make's authorised service centres with their dealership, city, branch, phone numbers and map location, optionally in one city or of one dealership.
GET/customer-reviewsRead customers' reviews of their purchase - rating, comment, city and the car bought - with the overall average rating.
GET/faqsRead the site's frequently asked questions about buying, paying for and receiving a car, with their answers. Takes only lang; no id is needed from another call.
GET/articlesBrowse and search the Syarah car guide's articles - car reviews, comparisons, news and buying, financing, traffic and maintenance guides - by text, category, tag and author...
GET/article-detailsRead one Syarah car guide article in full: its body text as published, with title, summary, dates, author, featured image, categories and tags.
GET/article-details-by-urlRead a Syarah car guide article in full from its syarah.com/carsguide link, the same result as /article-details without looking up the id first.
GET/article-categoriesList every category of the Syarah car guide - topics, per-make reviews and the English section - with its parent and article count.
GET/article-tagsList every tag of the Syarah car guide, such as a model year or a maintenance topic, with its article count. Takes no input; pass a tag id to /articles as tag_id.

Frequently asked questions

What does the Syarah API return?+
Saudi car data from Syarah: used and new cars for sale with prices in SAR, car details, inspection reports, a price guide, financing and service centres.
How do I get an API key?+
Subscribe to this API on RapidAPI. You'll get keys, usage dashboards, and plan management out of the box.
Is there a free tier?+
Check the pricing tab on RapidAPI for current plans and testing allowances.
Can I try the data before subscribing?+
Free samples are available for several platforms - see available samples.

Related Solutions

Explore more high-fidelity data sources.

View API Library
4Sale Kuwait API logo

4Sale Kuwait API

Search 4Sale Kuwait classifieds, used cars, property and electronics. Access listing prices, sellers, districts and business directory data.
Haraj API logo

Haraj API

Saudi classifieds data from Haraj: used cars, real estate, phones, furniture and more, with listing details, sellers, reviews, stores and comments.
HungerStation API logo

HungerStation API

Access HungerStation restaurant menus, meal prices, delivery fees, offers and grocery products across Saudi Arabia in English and Arabic.