Developers · Car Catalogue API

Car Catalogue API — every make, model and variant, independently, per GCC country.

Every vehicle sold in each GCC country, back to 2012, with a unique AlgoDriven code and full specifications — new-car pricing included, in English and Arabic. A guided lookup walks users from year and make down to the exact variant — perfect for listing forms, appraisal flows and search — or take the whole catalogue as a database download, updated twice a month with every new-to-market Chinese brand and model.

POST /v1/vehicleLookup · final response
[{
  "AlgoDriven Code": "AEBMX5-18AOAB",
  "Year": "2018",
  "Make": "BMW",
  "Model": "X5",
  "Variant": "50i M Sport",
  "Series": "F15",
  "Body": "SUV",
  "Litres": "4.4", "Cylinders": "8", "HP": "408",
  "Transmission": "Automatic",
  "Drive": "All Wheel Drive",
  "Fuel": "Petrol", "Seats": "7"
}]
Endpoints

Look up one car, or take the lot.

POST /v1/vehicleLookup

Guided Vehicle Lookup

A conversational disambiguation flow: each call tells you the next field to ask the user for — year, make, model, variant and so on — with the valid values for each, until the vehicle resolves to a single AlgoDriven code with full specs. Flows can run year-first or make-first (orderByMake), return all matching codes at once, and operate fully in Arabic or English.

POST /v1/getLatestADData

Database Download

Secure, time-limited links to the latest full catalogue as CSV, plus a change summary and usage instructions with every release. Load it into your own systems and keep it current with updates twice a month — including every new-to-market Chinese brand and model.

Coverage

Independent, per GCC country. In English and Arabic.

The catalogue doesn't treat the GCC as one block — it independently covers each country (UAE, Saudi Arabia, Kuwait, Qatar, Bahrain and Oman) back to 2012, with its own new and used vehicle line-up, new-car pricing and specs for every passenger and light commercial vehicle. Every field is available in full English and Arabic, and the same AlgoDriven code keys directly into our Pricing API and is returned by our VIN Decode API.

Per country

Six GCC markets, independently

UAE, Saudi Arabia, Kuwait, Qatar, Bahrain and Oman — each with its own line-up and new-car pricing, not a merged regional list.

اللغة العربية · English

Full Arabic, not just labels

Every field — make, model, variant, spec — is available in complete Arabic and English, not a partial translation layer.

Freshness

Updated twice a month

New builds and every new-to-market Chinese brand and model are added on a twice-monthly cycle — so the catalogue keeps pace with the market.

Pricing

Get building fast.

Onboarding

Access within a working day

Talk to our team about what you're building and we'll issue API access so you can build and validate your integration before going live.

Production

Volume & enterprise pricing

Production pricing scales with call volume. Talk to us about volume tiers, database licensing and enterprise terms.

Quickstart

Your first call.

Vehicle Lookup · step one returns the fields to ask for
$ curl -X POST https://algodriven.io/v1/vehicleLookup \
    -H "Authorization: {your-api-key}"

{
  "message": "Please select a year.",
  "field-required": "year",
  "field-values": ["2026", "2025", "2024", ]
}

Send each answer back as a POST field and the API returns the next question — most vehicles resolve to a single code in three to five calls. Build your front end dynamically from each response rather than hard-coding the field order.

FAQ

Straight answers.

Which markets does the catalogue cover?

The catalogue independently covers each GCC country back to 2012 — passenger cars and light commercial vehicles (utilities and cab chassis up to one tonne, and vans), new and used — with every vehicle sold in each market carrying a unique AlgoDriven code. Contact us about coverage for other regions.

Is new-car pricing included?

Yes. Alongside used-vehicle specs, the catalogue includes new-car pricing for each GCC country, so you can compare new and used values side by side.

What data is included per vehicle?

Each vehicle carries a unique AlgoDriven code plus year, make, model, variant, series, a consolidated full description, body, doors, litres, cylinders, horsepower, transmission, drive, fuel and seats — in English and Arabic.

How does the guided lookup work?

The Vehicle Lookup endpoint is called consecutively: each response tells you the next field to ask for (year, make, model, variant…) and the valid values, until the vehicle disambiguates to a single AlgoDriven code. Flows can start year-first or make-first, and run fully in Arabic or English via a language flag.

Can I download the whole database?

Yes. The Database Download endpoint returns secure links to the latest full catalogue in CSV format, along with a change summary and usage instructions. Data is updated twice a month, with every new-to-market Chinese brand and model added as it lands.

What does it cost?

Production pricing scales with volume — contact the API team for a quote and to get access.

Is the API secure and compliant?

Yes. AlgoDriven holds a SOC 2 Type 2 attestation and ISO 27001 certification, and all API traffic is encrypted in transit. Compliance documentation is available on request.

Request API access.

Tell us what you're building — we'll get you set up.

Request API access