Skip to Content

OpenSooq Data Parser & API

OpenSooq is the mobile-first classifieds leader across roughly 20 MENA markets — drawing about 800M visits per year region-wide — and Carapis extracts its full car listing data, including make, model, year, mileage, price and seller info, through one REST API. A single integration unlocks the auto markets of Jordan, Kuwait, Qatar, Iraq, Oman, Bahrain and more, and Carapis serves its data without you maintaining a scraper.

Available now. OpenSooq is in the live feed — pull it from /apix/api/vehicles/ with your API key.

CountryJordan
TypeClassifieds
Vehicle typesused, new, private
Monthly visits~800M/yr region-wide
Active listingsvery large
API accessNo public API (parse-only)
Parse priority★★★★☆
Official sitewww.opensooq.com

What is OpenSooq?

OpenSooq is the dominant mobile-first horizontal classifieds platform across the Levant and Gulf, operating in around 20 MENA markets, with autos as a top vertical. It carries a very large volume of private and dealer car listings and draws roughly 800M visits per year with about 2B monthly pageviews region-wide. Its breadth — many smaller national auto markets under one brand — is its defining feature.

Market Position

OpenSooq is the mobile-first classifieds leader across ~20 MENA markets, with ~800M visits/yr region-wide. Its strength is breadth: a single Carapis source covers the auto markets of Jordan, Kuwait, Qatar, Iraq, Oman, Bahrain and more at once — many smaller national markets that would otherwise each need a separate parser. Its per-listing structure is shallower than a dedicated auto portal’s (mobile-first, C2C-heavy), so the value is geographic coverage rather than field depth.

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 OpenSooq is no exception.

List — GET /apix/api/vehicles/ — returns 30 fields per vehicle:

  • idstring
  • source_codestring
  • brand_namestring
  • brand_slugstring
  • model_namestring
  • model_slugstring
  • trimstring
  • yearinteger
  • price_usdinteger
  • mileageinteger
  • fuel_typeFuelTypeEnum
  • transmissionTransmissionEnum
  • body_typeBodyTypeEnum
  • colorColorEnum
  • seller_typeSellerTypeEnum
  • regionstring
  • source_locationobject
  • has_accidentboolean
  • is_new_vehicleboolean
  • is_verifiedboolean
  • statusVehicleStatusEnum
  • is_availableboolean
  • first_seen_atstring
  • last_seen_atstring
  • thumbVehiclePhoto
  • photosarray
  • photos_countinteger
  • has_valuationboolean
  • has_llm_analysisboolean
  • analysisobject

Detail — GET /apix/api/vehicles/{id}/ — adds 23 more:

  • generationstring
  • price_originalstring
  • price_original_currencystring
  • original_msrpstring
  • engine_ccinteger
  • seat_countinteger
  • drive_typeDriveTypeEnum
  • has_simple_repairboolean
  • has_recallboolean
  • recall_fulfilledboolean
  • warranty_typestring
  • inspection_passedboolean
  • owner_countinteger
  • is_undervaluedboolean
  • valuation_scorenumber
  • featuresarray
  • descriptionstring
  • listing_urlstring
  • listing_idstring
  • vinstring
  • vehicle_nostring
  • availability_checked_atstring
  • status_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 mobile-first C2C classifieds, OpenSooq’s per-listing fields are broad but shallower than a dedicated portal’s — its strength is cross-country coverage rather than per-listing depth.

API Quick Start

import requests resp = requests.get( "https://api.carapis.com/v2/listings", params={"source": "opensooq", "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 — multi-market private and dealer pricing feeds dealer models across the Levant and Gulf.
  • Market research — track many smaller national auto markets from one source. See market research.
  • Import / export — broad regional supply helps buyers source across MENA. See import & export.

Frequently asked questions