Haraj+API.SH

Haraj API

Search haraj.com.sa classified ads in Saudi Arabia and pull prices, car and property details as JSON.

The API.SH Haraj API turns public ads on haraj.com.sa, Saudi Arabia's large online classifieds marketplace, into structured JSON. Search with an Arabic or English keyword or a category tag, filter by city and price range and sort by newest. Each ad has title, text, price in SAR, city, district and neighbourhood, posting and update times, tags, attributes, car and real-estate details, photos and comment counts. Open one ad by id, URL or the newest match. Beyond search, read an ad's public comments, a member's public profile with their current ads, the category tree and the Saudi regions and cities that the search filters take.

  • 6 endpoints
  • from $1 / 1,000 calls
  • 1,000 free credits / month
  • failed calls free
Search Haraj ads
GET https://api.api.sh/haraj/v1/search
{"query": "ايفون","tag": null,"count": 21,"has_more": true,"results": [{"id": "191909227","url": "https://haraj.com.sa/11191909227/ايفون_17_برو_ماكس_ازرق_جديد/","title": "ايفون 17 برو ماكس ( ازرق ) جديد","description": "ايفون 17 برو ماكس\nحجم الشاشه 6.9 بوصه\nجهاز جديد\n256  جيجا بايت","price": null,"currency": "SAR","city": "الشرقيه","district": "الدمام","neighborhood": "بدر","geohash": "thew4r","posted": "2026-11-03T14:03:53.000Z","updated": "2026-11-03T14:03:53.000Z","type": "AD","status": true,"promoted": false,"tags": ["حراج الأجهزة","ابل Apple","… 1 more"],"attributes": {"iphone_Storage": "+1 555 010 0000","iphone_Condition": "NEW","iphone_Color": "BLUE","iphone_Model": "+1 555 010 0000"},"car": null,"real_estate": null,"job": null,"images": ["https://mimg6cdn.haraj.com.sa/userfiles30/2026-11-3/1024x768-1_-qe5tlvkZh6QGlA.jpg","https://mimg6cdn.haraj.com.sa/userfiles30/2026-11-3/768x1024-1_-6Xjx9TJmOWOzMy.jpg"],"has_video": false,"comments": 1,"comments_enabled": true,"up_rank": 0,"down_rank": 0},{"id": "191909711","url": "https://haraj.com.sa/11191909711/ايفون_17_برو_ماكس_256/","title": "ايفون 17 برو ماكس 256","description": "ايفون 17 برو ماكس 256 برتقالي\nم يعاني من اي شي ولا يوجد خدوش ولا كسور اخو الجديد \nبطارية 96 \n272 دورة شحن \nعلى السوم\nعن طريق الواتس او البرن…","price": null,"currency": "SAR","city": "الرياض","district": "الرياض","neighborhood": "العريجاء الوسطى","geohash": "th35uz","posted": "2026-11-03T14:09:36.000Z","updated": "2026-11-03T14:09:36.000Z","type": "AD","status": true,"promoted": false,"tags": ["حراج الأجهزة","ابل Apple","… 1 more"],"attributes": {"iphone_Storage": "+1 555 010 0000","iphone_Model": "+1 555 010 0000","iphone_Color": "COSMICORANGE","iphone_Condition": "USED"},"car": null,"real_estate": null,"job": null,"images": ["https://mimg6cdn.haraj.com.sa/userfiles30/2026-11-03/1800x1800_75CE0654-1E86-4FDA-86EA-45C06AFBEEB6.jpg","https://mimg6cdn.haraj.com.sa/userfiles30/2026-11-03/828x1800_7DAFC298-7036-4020-B130-1203D7DD0977.jpg"],"has_video": false,"comments": 0,"comments_enabled": true,"up_rank": 0,"down_rank": 0},"… 19 more"],"cached": false,"credits_used": 1}
1 credit · $1 per 1,000 calls

What you can build with the Haraj API

Used car prices in Saudi Arabia

Search a car model in Arabic or English, filter by city and price, and compare prices with the car details in each ad.

Real estate ad monitoring

Search a property tag in a city and collect prices, neighbourhoods and real-estate details to track the rental and sale market.

New ad alerts

Sort by newest, or open the newest match with latest=1, to pick up fresh ads for a keyword as they are posted.

Category and demand research

Use comment counts, tags and posting times across a category to see which items get attention on Haraj, and read the comment threads under an ad to see what buyers ask and how sellers answer.

Building filters for an app

Load the category tree (cars by make and model, real estate, devices, jobs) and the regions with their cities, with Arabic and English names, so your own search form passes the exact tag and city values the search takes.

Seller and dealer research

Look up a member's public profile (registration date, followers, ratings, realtor and verified flags) and their current ads to see how a dealer or agent prices and how active they are. Phone numbers and email addresses are never returned.

Haraj data you get

Field names from real responses. Numbers come parsed, URLs absolute, dates in ISO 8601.

Haraj category tree/haraj/v1/categories
id1
category[]id · parent_id · tag · name_ar · name_en · type · order · url · icon · children_count · children
Haraj regions and cities/haraj/v1/cities
count21city_count88
regions[]region · region_en · cities
Haraj ad comments/haraj/v1/comments
id191909227urlhttps://haraj.com.sa/11191909227/orderoldestpage1count1
comments[]id · author · author_id · author_level · new_user · text · date · status · deleted_reason · sequence · reply · reply_to

Haraj API endpoints and prices

Every Haraj endpoint costs 1 credit per call: credits are $1 per 1,000 on a monthly plan, $2 pay-as-you-go. Pricing

Search and discovery1
Search Haraj ads
/haraj/v1/search
params none required +7 optionaldocstry
$1 · $2 PAYG
1 credit
Profiles and accounts1
Haraj member profile and ads
/haraj/v1/seller
params username +1 optionaldocstry
$1 · $2 PAYG
1 credit
Comments and reviews1
Haraj ad comments
/haraj/v1/comments
params none required +4 optionaldocstry
$1 · $2 PAYG
1 credit
Products, listings and places1
Haraj ad details
/haraj/v1/listing
params none required +5 optionaldocstry
$1 · $2 PAYG
1 credit
More data2
Haraj category tree
/haraj/v1/categories
params none required +2 optionaldocstry
$1 · $2 PAYG
1 credit
Haraj regions and cities
/haraj/v1/cities
params none requireddocstry
$1 · $2 PAYG
1 credit

Call the Haraj API

Search Haraj ads: GET https://api.api.sh/haraj/v1/search

curl "https://api.api.sh/haraj/v1/search?q=%D8%A7%D9%8A%D9%81%D9%88%D9%86" \
  -H "x-api-key: $APISH_KEY"
  1. Create a free accountConfirm your email and get 1,000 free credits every month. No card needed.
  2. Create an API keyOne key works for all 918 platforms.
  3. Send the requestJSON back in one call. Add output=csv or output=ndjson for files.

Why API.SH for Haraj data

  • Public data only: no Haraj login, cookies or account needed
  • One key and one response shape for Haraj and 917 other platforms
  • Built and maintained by API.SH, not third-party publishers
  • Pay per call; errors on our side cost nothing
  • No rate limits: run as many calls in parallel as you need
  • Live status for every endpoint

API.SH vs the official Haraj API

Haraj does not publish a public API for its ads. API.SH reads public haraj.com.sa pages and returns them as JSON. This is the Saudi site haraj.com.sa, not Haraj One or other apps with similar names.

Rather than building a scraper that handles Arabic text and changing pages, use one API.SH key for search and ad details at a fixed price per call.

Haraj API questions

What Haraj data can I get?+

Ad search by Arabic or English keyword or tag, with city, price and newest filters (/haraj/v1/search); one ad with text, price, location, tags, attributes, car and real-estate details and photos (/haraj/v1/listing); an ad's public comments (/haraj/v1/comments); a member's public profile and current ads (/haraj/v1/seller); and the category tree and Saudi regions and cities (/haraj/v1/categories, /haraj/v1/cities).

How much does the Haraj API cost?+

Every Haraj endpoint costs 1 credit per call. On a monthly plan 1,000 credits cost $1 (Starter is $50/month for 50,000 credits). Pay-as-you-go is $2 per 1,000 credits, with top-ups from $15 that never expire.

Is there a free trial?+

Yes. Every account gets 1,000 free credits every month. That is 1,000 calls to /haraj/v1/categories at 1 credit each.

Is there an official Haraj API?+

No public developer API turned up in our research; the results for "haraj api" are scraper listings and Haraj's own search pages. API.SH covers public ads on haraj.com.sa.

Do I need a Haraj account or login?+

No. API.SH reads public Haraj pages only. No endpoint uses a login, cookies or anyone's account. Private sellers' names, phone numbers and email addresses are never returned and are masked in ad text.

Can I search in Arabic?+

Yes. /haraj/v1/search accepts Arabic or English keywords, and ad titles and text come back as posted. Category and city names come with both Arabic and English names.

How do I filter by city or category?+

Call /haraj/v1/cities for the city names the search takes as city, and /haraj/v1/categories for the tag values (cars by make and model, real estate, devices and so on). Pass them to /haraj/v1/search with min_price and max_price to narrow results.

Which Haraj is this?+

haraj.com.sa, the Saudi classifieds marketplace for cars, devices, real estate, furniture and more. It is not Haraj One, Emirates Haraj or other apps with similar names.

How do I get started?+

1. Sign up at api.sh. 2. Copy your API key. 3. Call /haraj/v1/search with q set to a car model such as كامري and sort=newest. Request examples and every parameter are in the docs at https://api.sh/docs. You can also use the JS or Python SDK, Google Sheets, Zapier, Make, n8n or the MCP server at https://api.sh/mcp.

Does the Haraj API have a rate limit?+

No. API.SH puts no rate limit on your key: send as many Haraj calls in parallel as you need and pay only for the calls that run. If Haraj itself slows down, the call returns 503 with a retry-after header and is not charged.

More e-commerce APIs all e-commerce APIs →

Start with 1,000 free credits
Every month, on every account. One key works for all 918 platforms.
Get a free API key