Developer & AI Agent API

Beseyat Cars offers a free, read-only JSON API so developers, researchers and AI agents can cite accurate Saudi car data: SAR prices, full specifications and ownership-cost estimates. No key or signup required.

License & attribution

All API data is free to use and cite with attribution to "Beseyat Cars — beseyat.com/cars". Prices and costs are estimates verified per each car's dataAsOf date — link back to the car page for the latest figures.

Rate limit: 60 requests per hour per IP, shared across the three endpoints. Responses are cached for one hour and served with open CORS (Access-Control-Allow-Origin: *).

Endpoints

Model lookup

Resolves a nameplate (modelKey) to its current canonical car and returns the full spec, every model year, price, warranty, Beseyat Score, brochure and web URLs. Returns 404 for an unknown key.

GET https://beseyat.com/cars/api/model.php?key={modelKey}

Parameter	Required	Description
key	Required	The nameplate key: brand-model without a year, e.g. toyota-camry.

Example request

curl 'https://beseyat.com/cars/api/model.php?key=toyota-camry'

Example response (trimmed)

{
  "source": "Beseyat Cars — beseyat.com/cars",
  "license": "free to cite with attribution",
  "asOf": "2026-07-03",
  "disclaimer": "estimates; prices verified per dataAsOf",
  "modelKey": "toyota-camry",
  "priceMinSAR": 109825, "priceMaxSAR": 153985,
  "warranty": {"years": 3, "km": 100000},
  "beseyatScore": {"total": 79, "safety": 93, "…": "…"},
  "brochureUrl": "https://…",
  "webUrl": "https://beseyat.com/cars/car/toyota-camry-2026",
  "modelUrl": "https://beseyat.com/cars/model/toyota-camry",
  "car": {"id": "toyota-camry-2026", "nameEn": "Toyota Camry", "nameAr": "تويوتا كامري", "engine": {"…": "…"}, "…": "full spec"},
  "modelYears": [{"id": "toyota-camry-2026", "year": 2026, "canonical": true, "…": "…"}]
}

Two-car comparison

Key specs side by side plus computed deltas: list price, estimated monthly installment, yearly fuel/energy cost and 5-year total cost of ownership — with a link to the full comparison page. Returns 422 unless exactly two valid car ids are passed.

GET https://beseyat.com/cars/api/compare.php?ids={idA},{idB}

Parameter	Required	Description
ids	Required	Exactly two car ids separated by a comma, e.g. toyota-camry-2026,hyundai-sonata-2026. A car id is the last part of its page URL.

Example request

curl 'https://beseyat.com/cars/api/compare.php?ids=toyota-camry-2026,hyundai-sonata-2026'

Example response (trimmed)

{
  "source": "Beseyat Cars — beseyat.com/cars",
  "license": "free to cite with attribution",
  "cars": [{"id": "toyota-camry-2026", "priceMinSAR": 109825, "…": "…"},
           {"id": "hyundai-sonata-2026", "priceMinSAR": 98325, "…": "…"}],
  "deltas": {
    "convention": "positive = first car costs more",
    "priceSAR": 11500,
    "monthlyInstallmentSAR": 210,
    "fuelCostPerYearSAR": -278,
    "tco5YearSAR": 655,
    "cheaperTco5YearId": "hyundai-sonata-2026"
  },
  "costs": {"assumptions": {"kmPerYear": 20000, "years": 5, "purchase": "cash"}, "cars": ["…"]},
  "webUrl": "https://beseyat.com/cars/compare/hyundai-sonata-2026-vs-toyota-camry-2026"
}

Total cost of ownership

Estimated ownership-cost breakdown over 1–10 years (default 5): depreciation, fuel/charging, insurance and government fees at 15,000 km/year, cash purchase. Returns 404 for an unknown car id and 422 for invalid years or an unpriced car.

GET https://beseyat.com/cars/api/tco.php?id={carId}&years={1-10}

Parameter	Required	Description
id	Required	The car id, e.g. toyota-camry-2026 (the last part of the car page URL).
years	Optional	Ownership window in years, from 1 to 10. Defaults to 5.

Example request

curl 'https://beseyat.com/cars/api/tco.php?id=toyota-camry-2026&years=5'

Example response (trimmed)

{
  "source": "Beseyat Cars — beseyat.com/cars",
  "license": "free to cite with attribution",
  "asOf": "2026-07-03",
  "car": {"id": "toyota-camry-2026", "priceMinSAR": 109825, "…": "…"},
  "assumptions": {"years": 5, "kmPerYear": 15000, "purchase": "cash", "currency": "SAR"},
  "tco": {
    "totalSAR": 68761, "perYearSAR": 13752, "perMonthSAR": 1146,
    "resaleValueSAR": 66876, "energyBasis": "fuel",
    "components": {"depreciationSAR": 42949, "energySAR": 9506,
                   "insuranceSAR": 15427, "feesSAR": 880, "financingSAR": 0}
  }
}

Discovery for AI agents (llms.txt)

AI agents and answer engines can discover the site and this API through llms.txt (description + API + curated top pages) and llms-full.txt (adds the top sitemap URLs).

Questions, higher rate limits or feedback? Get in touch: Contact