+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
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} 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.
Haraj data you get
Field names from real responses. Numbers come parsed, URLs absolute, dates in ISO 8601.
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 Haraj ads /haraj/ | $1 · $2 PAYG 1 credit |
| Haraj member profile and ads /haraj/ | $1 · $2 PAYG 1 credit |
| Haraj ad comments /haraj/ | $1 · $2 PAYG 1 credit |
| Haraj ad details /haraj/ | $1 · $2 PAYG 1 credit |
| Haraj category tree /haraj/ | $1 · $2 PAYG 1 credit |
| Haraj regions and cities /haraj/ | $1 · $2 PAYG 1 credit |
Call the Haraj API
Search Haraj ads: GET https://api.api.sh/haraj/
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" import os, requests
res = requests.get(
"https://api.api.sh/haraj/v1/search",
params={"q": "ايفون"},
headers={"x-api-key": os.environ["APISH_KEY"]},
timeout=120,
)
res.raise_for_status()
data = res.json() const url = new URL("https://api.api.sh/haraj/v1/search");
url.searchParams.set("q", "ايفون");
const res = await fetch(url, { headers: { "x-api-key": process.env.APISH_KEY } });
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
const data = await res.json(); # Google Sheets (API.SH add-on)
=APISH("/haraj/v1/search", "q", "ايفون")
# Zapier, Make, n8n (verified node): pick the API.SH app,
# choose "Haraj" and "Search Haraj ads".
# AI agents (Claude, ChatGPT, Cursor): add the
# API.SH MCP server https://api.sh/mcp - Create a free accountConfirm your email and get 1,000 free credits every month. No card needed.
- Create an API keyOne key works for all 918 platforms.
- Send the requestJSON back in one call. Add
output=csvoroutput=ndjsonfor 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.