Skip to content
Happy Endpoint
4Sale Kuwait API
API v1.0 4Sale Kuwait

4Sale Kuwait API

Search 4Sale Kuwait classifieds, used cars, property and electronics. Access listing prices, sellers, districts and business directory data.

Overview

The 4Sale API provides structured data from Q84Sale, the Kuwait classifieds marketplace. Search used cars, apartments, houses, electronics, jobs and services, then retrieve the listing records needed for a classifieds search application or market research pipeline.

Search and data coverage

Begin with /categories and /districts to discover the identifiers used by listing filters. /search supports keyword queries, price ranges and pagination, while /listings narrows results by category and district. If you already have a Q84Sale search link, /listings-by-url lets you use that input directly. Category filters help your application present the options available for each type of listing.

Use /listing-details or /listing-details-by-url for an individual advert. Related endpoints cover similar listings, listing views and a seller’s inventory. Business profiles and the separate directory endpoints add company details, reviews and media; /new-cars provides a starting point for new vehicle research.

What you can build

  • Kuwait classifieds search across cars, property and consumer goods
  • Price monitoring within a category and district
  • Seller inventory and dealer research
  • Local business directory search with reviews

Coverage and comparison tips

Listings cover Kuwait, with prices in Kuwaiti dinars and English and Arabic content. Keep category and district identifiers with each record so that price comparisons use comparable local inventory.

Getting started

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

Subscribe to the 4Sale Kuwait 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: 4sale-kuwait-api.p.rapidapi.com for requests.

Explore Gumtree API and Milanuncios API, or browse the API library for other markets and platforms.

What you can do

Kuwait classifieds search across cars, property and consumer goods
Price monitoring within a category and district
Seller inventory and dealer research
Local business directory search with reviews

Endpoints & Schema

MethodPathSummary
GET/statusCheck whether the 4Sale API is available.
GET/categoriesBrowse or search the category tree to find the category ids /listings, /listings-by-url, /category-search, /category-details, /category-filters, /sponsored-cards and...
GET/category-detailsOne category's bilingual description, breadcrumb and direct children.
GET/category-filtersA category's attribute dictionary, the ids and option ids the attributes filter takes and listing attributes decode against.
GET/districtsKuwait's governorates, areas and blocks, the ids the district_ids filter takes.
GET/autocompleteTurn a typed phrase into search suggestions and the category id to browse.
GET/trending-searchesThe search phrases trending on the marketplace right now.
GET/searchKeyword search across every category, with price, attribute, video and near-a-point filters.
GET/listingsBrowse one category with district, price and attribute filters.
GET/category-searchKeyword search inside one category, with district, price and attribute filters.
GET/latest-listingsThe live catalogue across every category as one roughly newest-first feed, for monitoring new listings or a bulk sync.
GET/listings-by-urlPaste a category page address and get its listings, with the address parsed back.
GET/promoted-listingsA category's paid placements: its pinned, rotating, business, commercial and golden listings.
GET/popular-listingsThe most-viewed listings right now in each major vertical.
GET/listing-detailsEverything about one listing by id: bilingual text, decoded attributes, coordinates, seller and promotion state.
GET/listing-details-by-urlPaste a listing page address and get the full listing record.
GET/listing-scoreThe marketplace's quality score for a listing, broken down by factor with improvement advice.
GET/listing-viewsA listing's view history by day and hour, and how often buyers used its contact buttons.
GET/similar-listingsListings the marketplace recommends alongside one listing.
GET/seller-listingsThe active listings of one seller account as the marketplace lists them (it leaves some pinned ones out), found by the seller's phone number.
GET/business-profilesFind the dealers, offices and service companies on the marketplace, by the categories they have listings in, or by business directory.
GET/business-profile-detailsOne business profile: identity, contact numbers, verification and branches.
GET/business-profile-listingsA business profile's full inventory, paginated with an exact total.
GET/directory-searchSearch the business directory, restaurants, cafés, clinics, salons and other local businesses, with opening hours and tags.
GET/directory-business-detailsOne business-directory entry by slug: phone numbers, website, amenities, opening hours, branches with coordinates and its star rating.
GET/directory-business-reviewsThe user reviews of one business-directory entry, newest first, page by page.
GET/directory-business-mediaThe photos and menus of one business-directory entry, by slug.
GET/sponsored-cardsThe sponsored banner cards shown in a category's search results.
GET/promo-codesPromo codes currently valid for posting ads on the marketplace.
GET/home-sectionsWhat the home screen is promoting: trending categories, hero banners and sponsored cards.
GET/new-carsThe new-car catalogue: models by brand with every trim and its price in KWD where the dealer publishes one.
GET/service-offersLocal service businesses advertising on the marketplace, with phone and WhatsApp numbers.
GET/service-categoriesThe service directory's categories, the ids /service-offers filters by.
GET/blog-articlesThe handful of editorial blog posts the marketplace's app features.

Frequently asked questions

What does the 4Sale Kuwait API return?+
Search 4Sale Kuwait classifieds, used cars, property and electronics. Access listing prices, sellers, districts and business directory data.
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.