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

OpenSooq API

OpenSooq classifieds data across 20 MENA markets: cars, property, jobs and electronics, with listing details, sold listings, price insights and sellers.

Overview

The OpenSooq API provides classifieds data from opensooq.com (السوق المفتوح) across 20 markets, including Saudi Arabia, the UAE, Jordan, Kuwait, Qatar, Oman, Bahrain, Iraq, Egypt and Morocco. Search used cars, motorcycles, property for sale and rent, jobs, phones, electronics, furniture and services, with full listing details, sold listings, price insights and seller data.

Search and data coverage

/markets returns the market codes every route takes, with currencies and phone codes. /cities, /neighborhoods and /nearest-city return location ids, and /categories and /search-filters return the category tree and facet values, such as make, model and trim or rooms and amenities. /search filters by category, keyword, location, facets and price, year and area ranges. /autocomplete and /trending-searches help build search, and /search-by-url runs a pasted OpenSooq link.

/sold-listings searches the archive of sold and unavailable listings with their last asking price, and /price-insights returns OpenSooq’s own price summary for a search. /listing-details returns attributes, photos, videos, price, location and seller, and /listing-comparison compares up to three listings. Seller and shop routes return profiles, ratings, written reviews and listings. /product-reviews returns owner reviews of cars and phones and resident reviews of neighbourhoods. /reels and /map-listings cover listing videos and property map pins.

What you can build

  • Classifieds search across 20 Middle East and North Africa markets
  • Used car pricing from live and sold listings
  • Property map search with exact listing positions
  • Seller, shop and owner review data

Coverage and comparison tips

Each market has its own currency, categories and facet ids, so fetch them per market rather than reusing ids across countries. Sold listings show the last asking price, not a confirmed sale price. Use lang to choose English or Arabic labels.

Getting started

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

Subscribe to the OpenSooq 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: opensooq.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 Haraj API, 4Sale Kuwait API and Syarah 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 OpenSooq. All data is retrieved from publicly available sources.

What you can do

Classifieds search across 20 Middle East and North Africa markets
Used car pricing from live and sold listings
Property map search with exact listing positions
Seller, shop and owner review data

Endpoints & Schema

MethodPathSummary
GET/statusCheck whether the OpenSooq API is available.
GET/marketsList every OpenSooq market with the market code every other endpoint takes as country, their currencies, phone codes and capital city.
GET/citiesList a market's cities with the city_id that search and /neighborhoods take, their English and Arabic names and map coordinates.
GET/neighborhoodsList one city's neighbourhoods with the neighborhood_id that search takes, their English and Arabic names and map coordinates.
GET/nearest-cityFind the market's city nearest to a latitude / longitude, with its city_id.
GET/categoriesBrowse a market's category tree one level at a time - top-level categories, or one category's subcategories - with the site's listing counts and the ids search takes.
GET/search-filtersList the filters a search scope offers - facet keys and value ids (make → model → trim, rooms, amenities, …), price / year / area ranges, switches and sorts - for /search...
GET/autocompleteType-ahead search suggestions (keywords, categories, makes, models, places) with listing counts and the /search parameters each one runs.
GET/trending-searchesList a market's trending search terms, ready to send to /search as query.
GET/searchSearch live listings in a market by category, keywords, city, neighbourhood, category facets, price / year / area ranges, seller and switches, in any of the site's sorts.
GET/search-by-urlRun the search an OpenSooq search page URL describes and see how the URL was read as /search parameters.
GET/sold-listingsSearch a market's archive of sold and no-longer-available listings, with their last asking price, by the same filters as /search.
GET/price-insightsGet the market's own price summary for a search scope - lowest / highest price, cheapest model and a min / max / average price table per make, model or year.
GET/similar-listingsList the listings similar to, or recommended alongside, one listing (up to 90).
GET/listing-detailsGet one listing in full by its id - attributes with facet ids, photos and videos, price, exact location, seller and masked contact, job / CV details, live or sold.
GET/listing-details-by-urlGet one listing in full from its OpenSooq page URL or share link - the same answer as /listing-details.
GET/listing-comparisonCompare two or three listings side by side, attribute by attribute, with the differing rows flagged.
GET/review-categoriesList the review categories (cars, motorcycles, mobile phones, tablets, neighbourhoods) with the ids /product-reviews takes.
GET/product-reviewsRead owners' product reviews and residents' neighbourhood reviews level by level - ratings tables of makes and models, then written reviews.
GET/product-review-filtersGet a product review category's make, model, trim, year and attribute ids for /product-reviews.
GET/reelsBrowse sellers' listing videos (reels) by category, city, seller or text, with playable video URLs.
GET/map-listingsMap the property listings (for sale or for rent) inside a latitude / longitude box - exact positions, 500 pins per page, by subcategory, city or neighbourhood.
GET/seller-profileGet a seller's public profile by seller_id: name, shop flag, listing count, member-since date, verification, response time, followers, masked phone, website, location, opening...
GET/seller-profile-by-usernameGet a seller's public profile from a username, a profile share link (opensooq.com/m/<username>) or a member page link (…/mid/<username>), with the seller_id the other seller...
GET/seller-searchFind a market's sellers and shops by name and get their seller_id.
GET/seller-listingsList a seller's listings on sale now, or its sold and no-longer-available listings, filterable by words, city and price and sortable by date or price.
GET/seller-ratingSummarise a seller's ratings: the count of each star, the average, and the feedback tags buyers picked with their counts.
GET/seller-reviewsList a seller's written reviews - text, stars, reviewer and date - newest first, optionally one star rating only.
GET/shopsBrowse a market's shop directory, filterable by name, section, category and city, with each shop's seller_id, listing count, city and rating.
GET/shop-detailsGet a shop's page: description, address, website, map coordinates, opening hours, founding date, phones as shown, cover and gallery.

Frequently asked questions

What does the OpenSooq API return?+
OpenSooq classifieds data across 20 MENA markets: cars, property, jobs and electronics, with listing details, sold listings, price insights and sellers.
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.