| GET | /status | Check whether the Haraj API is available. |
| GET | /provinces | List the Saudi provinces Haraj files listings under, with Arabic and English names and the province_id that /cities takes. |
| GET | /cities | List the cities of one Saudi province with coordinates; each name is the exact spelling the city filter of /search and /listings needs. |
| GET | /neighborhoods | List the districts (neighborhoods) of one Haraj city with coordinates; each name is the district value /listings filters by. |
| GET | /reverse-geocode | Find the Haraj district, city and province a latitude/longitude point lies in or is nearest to, with their ids and the distance to them. |
| GET | /categories | Walk the Haraj category tree one level at a time - sections, sub-categories, car makes and models, device brands, job roles - with Arabic tags and English labels. |
| GET | /tag-suggestions | Turn a keyword (Arabic or English) into the Haraj category path it belongs to, most specific tag first, ready for the tag filter. |
| GET | /tag-details | Look up Haraj category tags by exact name and get each one's category_id and tree level; unknown names are reported back. |
| GET | /search-suggestions | Autocomplete a Haraj search box: the popular search phrases that start with the text typed so far, optionally steered towards one category; pass one as the query of /search. |
| GET | /spelling-suggestions | Get "did you mean" spelling corrections for a misspelled Haraj search word, best guess first, with confidence scores; pass the chosen word as the query of /search. |
| GET | /trending-keywords | List the keywords trending in Haraj searches over the last 1 to 14 days, in the site's order, with relative scores - ready to pass as the query of /search. |
| GET | /tag-regions | Rank the Saudi regions by how many Haraj listings they have in one category, largest first - counts for comparing regions; each city label works as the city filter of /listings. |
| GET | /attribute-values | List the values of a device or watch attribute in one Haraj category, with listing counts for comparing values - the vocabulary of the attribute_filters filter of /listings. |
| GET | /live-streams | List the live-shopping video streams open on Haraj right now, with title, cover image, seller, viewers and the stream's listing. |
| GET | /escrow-fee | Calculate the Haraj escrow (wasata) service fee and the buyer's total for an item at a given price in SAR - for example a listing's price.input_price from /listing-details. |
| GET | /coin-packages | List the coin bundles Haraj sells to sellers for promoting their listings, with each bundle's price in SAR, the coins credited and the bonus coins included. |
| GET | /search | Search Haraj listings by keyword, with category, city, car body style, price, photos, video, date window, near-a-point, dealer, car condition, fuel and mileage filters - title... |
| GET | /listings | Browse Haraj listings by category and city without a keyword, with district, strict-city, car model-year, trim, body-style, device/watch attribute, photo and video filters - by... |
| GET | /map-listings | List the Haraj listings located inside a map box given by its north, south, east and west edges, optionally for one category, as the map view shows them. |
| GET | /listings-by-url | Run the listing search a pasted haraj.com.sa category, city, keyword-search or seller page link describes; returns the listings plus the applied filters and any ignored link parts. |
| GET | /promoted-listings | List the featured listings Haraj shows for a category, make or model: community posts from that category's forum section, or with city the featured ads of that category in that city. |
| GET | /listing-details | Read one Haraj listing in full by listing_id: text, price, photos, location, seller and structured car, real-estate, jobs and device details; a closed listing comes back with... |
| GET | /listing-details-by-url | Read a Haraj listing in full from its haraj.com.sa page link - the same response as /listing-details without extracting the id first. |
| GET | /similar-listings | List the listings Haraj shows as similar to one listing on its page, in the labelled groups the page shows (up to 15 listings each), as full listing rows. Takes a listing_id. |
| GET | /listing-comments | Read the public comments on one Haraj listing (questions, offers and seller replies), newest or oldest first, a page at a time. |
| GET | /related-videos | List the related video listings Haraj plays after one listing, each with a playable MP4 link, title, seller and location. |
| GET | /listing-likes | Read the like count of one Haraj listing by listing_id - the number of people who liked it, as its page shows next to the heart button; separate from the up and down votes on a... |
| GET | /listing-video | Read the video a seller attached to one Haraj listing by listing_id - a playable MP4 link and its cover image; listing rows only say whether a video exists (has_video). |
| GET | /seller-listings | List one seller's open Haraj listings by username, most recent activity first. Take the username from the author_username of a /search or /listings row. |
| GET | /seller-profile | Read a Haraj seller's public profile by username (the author_username of a /search or /listings row) - registration date, last seen, followers, buyer rating summary, badges and... |
| GET | /seller-profile-by-id | Read a Haraj seller's public profile by seller id (the author_id of a /search or /listings row, or the user_id of a /sellers row) - registration date, last seen, followers... |
| GET | /seller-reviews | Read the reviews buyers left on one Haraj seller - positive and negative, with the buyer's comment and the seller's reply - newest first, a page at a time, by username. |
| GET | /sellers | List the entries of Haraj's real-estate seller directory - one per advertiser listing, most recently posted first - optionally by real-estate category and city, each with the... |
| GET | /seller-contact | Read the phone number a real-estate advertiser publishes in Haraj's seller directory; the input is the contact_request_id of a /sellers row, and phone is null when none is... |
| GET | /store-details | Read a Haraj seller's store page by store handle (the seller's handle from /seller-profile without the @) - description, map location, published contacts, verification badges... |
| GET | /forum-posts | Read the Haraj community forum feed, newest posts first, with each post's up and down votes, optionally for one category or one seller; consecutive pages can share a few posts. |
| GET | /forum-post-details | Read one Haraj forum post by post_id (from /forum-posts, or a listing id): title, full text, photos, author, tags, comment count and up and down votes; comments via... |
| GET | /forum-comments | Read the comments on one Haraj forum post with each comment's up and down votes, oldest or newest first, a page at a time. |
