Haraj Data Parser & API
Haraj is Saudi Arabia’s dominant consumer-to-consumer classifieds platform and the national leader for private car listings — and Carapis can extract its full car data, including make, model, year, mileage, price and seller info, through one REST API. It is the primary source of C2C used-car supply in the Kingdom, and Carapis can serve its data without you building a scraper.
On request — not in the live feed today. We do not continuously crawl Haraj right now. Activation takes 2–3 weeks of engineering and is quoted per source, because each one ships with dedicated proxies, anti-bot tuning and ongoing maintenance. Ask us to add it.
| Country | Saudi Arabia |
|---|---|
| Type | Classifieds |
| Vehicle types | used, private |
| Monthly visits | high (national C2C leader) |
| Active listings | very large |
| API access | No public API (parse-only) |
| Parse priority | ★★★★☆ |
| Official site | haraj.com.sa |
What is Haraj?
Haraj (حراج) is the leading horizontal C2C classifieds platform in Saudi Arabia, covering cars and a wide range of other categories. Its automotive section is the country’s largest pool of private (owner-listed) used cars, and it is so central to the market that other Saudi auto platforms — such as Syarah — pull a “Haraj cars” feed. The Saudi used-car market was valued at roughly USD 10.2B in 2025, with online channels growing more than 17% per year.
Market Position
Haraj is the national C2C leader in Saudi Arabia, carrying a very large volume of owner-listed cars — the dominant source of private used-car supply in the Kingdom. The broader Saudi used-car market reached ~USD 10.2B (2025) with the online channel growing >17%/yr, and Haraj sits at the center of that shift. Its private-seller depth complements the dealer-focused inventory on Syarah and Motory, so together they map both sides of the Saudi market.
What the API returns
Response schema
Indicative — this is the shape, not a guarantee. Every source returns the same structure, so what you build against does not change when you add one. Which fields carry a value depends on the source and on the individual listing: a site that does not publish mileage returns null there, and Haraj is no exception.
List — GET /apix/api/vehicles/ — returns 30 fields per vehicle:
idstringsource_codestringbrand_namestringbrand_slugstringmodel_namestringmodel_slugstringtrimstringyearintegerprice_usdintegermileageintegerfuel_typeFuelTypeEnumtransmissionTransmissionEnumbody_typeBodyTypeEnumcolorColorEnumseller_typeSellerTypeEnumregionstringsource_locationobjecthas_accidentbooleanis_new_vehiclebooleanis_verifiedbooleanstatusVehicleStatusEnumis_availablebooleanfirst_seen_atstringlast_seen_atstringthumbVehiclePhotophotosarrayphotos_countintegerhas_valuationbooleanhas_llm_analysisbooleananalysisobject
Detail — GET /apix/api/vehicles/{id}/ — adds 23 more:
generationstringprice_originalstringprice_original_currencystringoriginal_msrpstringengine_ccintegerseat_countintegerdrive_typeDriveTypeEnumhas_simple_repairbooleanhas_recallbooleanrecall_fulfilledbooleanwarranty_typestringinspection_passedbooleanowner_countintegeris_undervaluedbooleanvaluation_scorenumberfeaturesarraydescriptionstringlisting_urlstringlisting_idstringvinstringvehicle_nostringavailability_checked_atstringstatus_changed_atstring
Abbreviated example:
{
"id": "0193f2c1-...",
"source_code": "encar",
"brand_name": "BMW",
"model_name": "320i",
"trim": "M Sport",
"year": 2021,
"price_usd": 28400,
"price_original": "38900000",
"price_original_currency": "KRW",
"mileage": 45000,
"fuel_type": "gasoline",
"transmission": "automatic",
"has_accident": false,
"listing_url": "https://...",
"photos": [{ "url": "https://cdn.carapis.com/..." }],
"first_seen_at": "2026-09-28T11:04:22Z",
"is_available": true
}Which sources you can actually query is answered by GET /apix/api/sources/ with your API key — it is the list your account can pull today, and it is the one to trust over any page on this site.
As a C2C classifieds, Haraj’s per-listing structure is shallower than a dedicated portal’s, but its strength is breadth — it is the widest view of private used-car supply and pricing in Saudi Arabia.
API Quick Start
Python
import requests
resp = requests.get(
"https://api.carapis.com/v2/listings",
params={"source": "haraj", "limit": 20},
headers={"Authorization": f"Bearer {API_KEY}"},
)
for car in resp.json()["results"]:
print(car["make"], car["model"], car["year"], car["price"])Get an API key at my.carapis.com and see the full API reference. Pricing is on the pricing page .
Use Cases
- Pricing intelligence — private-seller pricing benchmarks the Saudi C2C market for dealers.
- Market research — measure private used-car supply and price trends in the Kingdom. See market research.
- Import / export — broad supply data helps buyers source from Saudi Arabia. See import & export.