# OpenSooq API OpenSooq classifieds data across 20 MENA markets: cars, property, jobs and electronics, with listing details, sold listings, price insights and sellers. - Page: https://happyendpoint.com/library/opensooq-api - RapidAPI: https://rapidapi.com/happyendpoint/api/opensooq - RapidAPI host: `opensooq.p.rapidapi.com` - MCP: `https://mcp.rapidapi.com` with headers `x-api-host: opensooq.p.rapidapi.com` and `x-api-key: ` - Tags: classifieds, middle-east, used-cars, real-estate, marketplace, price-insights ## Features - 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 (30) - `GET /status` - Check whether the OpenSooq API is available. - `GET /markets` - List every OpenSooq market with the market code every other endpoint takes as country, their currencies, phone codes and capital city. - `GET /cities` - List a market's cities with the city_id that search and /neighborhoods take, their English and Arabic names and map coordinates. - `GET /neighborhoods` - List one city's neighbourhoods with the neighborhood_id that search takes, their English and Arabic names and map coordinates. - `GET /nearest-city` - Find the market's city nearest to a latitude / longitude, with its city_id. - `GET /categories` - Browse 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-filters` - List 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 /autocomplete` - Type-ahead search suggestions (keywords, categories, makes, models, places) with listing counts and the /search parameters each one runs. - `GET /trending-searches` - List a market's trending search terms, ready to send to /search as query. - `GET /search` - Search 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-url` - Run the search an OpenSooq search page URL describes and see how the URL was read as /search parameters. - `GET /sold-listings` - Search a market's archive of sold and no-longer-available listings, with their last asking price, by the same filters as /search. - `GET /price-insights` - Get 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-listings` - List the listings similar to, or recommended alongside, one listing (up to 90). - `GET /listing-details` - Get 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-url` - Get one listing in full from its OpenSooq page URL or share link - the same answer as /listing-details. - `GET /listing-comparison` - Compare two or three listings side by side, attribute by attribute, with the differing rows flagged. - `GET /review-categories` - List the review categories (cars, motorcycles, mobile phones, tablets, neighbourhoods) with the ids /product-reviews takes. - `GET /product-reviews` - Read owners' product reviews and residents' neighbourhood reviews level by level - ratings tables of makes and models, then written reviews. - `GET /product-review-filters` - Get a product review category's make, model, trim, year and attribute ids for /product-reviews. - `GET /reels` - Browse sellers' listing videos (reels) by category, city, seller or text, with playable video URLs. - `GET /map-listings` - Map 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-profile` - Get 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-username` - Get a seller's public profile from a username, a profile share link (opensooq.com/m/) or a member page link (…/mid/), with the seller_id the other seller... - `GET /seller-search` - Find a market's sellers and shops by name and get their seller_id. - `GET /seller-listings` - List 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-rating` - Summarise a seller's ratings: the count of each star, the average, and the feedback tags buyers picked with their counts. - `GET /seller-reviews` - List a seller's written reviews - text, stars, reviewer and date - newest first, optionally one star rating only. - `GET /shops` - Browse 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-details` - Get a shop's page: description, address, website, map coordinates, opening hours, founding date, phones as shown, cover and gallery. 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](https://rapidapi.com/happyendpoint/api/opensooq) 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. ## Related data sources Compare this API with the other car data sources for the region in the [Middle East car data guide](/automotive-data/middle-east). Explore [Haraj API](/library/haraj-api), [4Sale Kuwait API](/library/4sale-api) and [Syarah API](/library/syarah-api), or browse the [API library](/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.