jo.opensooq.com APIjo.opensooq.com ↗
Access classified listings, categories, and listing details from OpenSooq Jordan via 4 endpoints. Search by keyword or browse by category slug.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/d8b13845-b2b0-4a24-a8a7-eaa26da5a269/get_categories' \ -H 'X-API-Key: $PARSE_API_KEY'
Get all top-level listing categories from the OpenSooq Jordan homepage. Returns category names and slugs that can be used with get_listings_by_category.
No input parameters required.
{
"type": "object",
"fields": {
"data": "array of category objects each containing name, url, and slug"
},
"sample": {
"data": [
{
"url": "https://jo.opensooq.com/en/autos",
"name": "Motors",
"slug": "autos"
},
{
"url": "https://jo.opensooq.com/en/mobile-phones-tablets",
"name": "Phones & Tablets",
"slug": "mobile-phones-tablets"
},
{
"url": "https://jo.opensooq.com/en/electronics",
"name": "Electronics",
"slug": "electronics"
}
],
"status": "success"
}
}About the jo.opensooq.com API
The OpenSooq Jordan API exposes 4 endpoints for browsing and searching classified listings on jo.opensooq.com, Jordan's largest classifieds marketplace. Starting with get_categories to retrieve top-level category slugs, you can then feed those slugs into get_listings_by_category or run free-text queries via search_listings, and pull full listing details — including price, images, location, and seller info — with get_listing_detail.
Endpoints and Data Coverage
The API is built around four endpoints. get_categories returns every top-level category available on the OpenSooq Jordan homepage as an array of objects with name, url, and slug fields. Those slugs — for example mobile-phones-tablets, cars, or home-garden — are the required input for get_listings_by_category, which returns paginated arrays of listing objects containing id and url. Both get_listings_by_category and search_listings accept an optional page integer for pagination. Note that some legacy category slugs may return a 410 Gone response; use get_categories to confirm valid slugs before passing them to the category endpoint.
Listing Detail Fields
get_listing_detail accepts a numeric listing_id (obtainable from either browse or search results) and returns a single data object with: id, title, price, currency, description, publish_date, images (array), location, and seller. This is the richest response in the API and the appropriate endpoint when you need full item metadata rather than just IDs and URLs.
Search and Browse Workflows
search_listings takes a required query string — suitable for terms like iPhone, Toyota, or apartment — and returns the same paginated id and url structure as the category browse endpoint. This makes it straightforward to build a pipeline: search or browse to collect listing IDs, then call get_listing_detail in sequence to hydrate each result with price, location, and seller data.
- Monitor price trends for specific product types (e.g. used cars or smartphones) by combining
search_listingswithget_listing_detail. - Build a category map of OpenSooq Jordan by pulling all slugs from
get_categoriesand iteratingget_listings_by_category. - Track new listings in a given category by polling
get_listings_by_categoryand comparingpublish_datefromget_listing_detail. - Aggregate seller activity by collecting
sellerfields from multipleget_listing_detailresponses. - Extract location distribution of listings across Jordan by reading the
locationfield at scale. - Build a price comparison tool for specific search terms using
search_listingspluspriceandcurrencyfromget_listing_detail. - Collect training data for a classifieds recommendation model using category, title, description, and image fields.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does OpenSooq have an official developer API?+
What does `get_listing_detail` return beyond basic price and title?+
get_listing_detail returns id, title, price, currency, description, publish_date, an images array, location, and seller information. It does not return bidding history, view counts, or contact phone numbers. You can fork the API on Parse and revise it to add additional fields if they become accessible.Does the API cover subcategories, not just top-level categories?+
get_categories returns top-level categories only, and get_listings_by_category accepts top-level slugs. Subcategory browsing is not covered. You can fork the API on Parse and revise it to add a subcategory endpoint.Are there any known quirks with category slugs?+
get_listings_by_category. Always retrieve current slugs from get_categories before using them, rather than hardcoding slugs from external sources.