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.

Get a free API key Try it in the playground

2 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

{ "success": true }

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.

/search

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.

/search /listing

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.

/search /listing

Category and demand research

Use comment counts, tags and posting times across a category to see which items get attention on Haraj.

/search

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 and discovery1

Search Haraj ads

/haraj/v1/search

$1 · $2 PAYG

1 credit

Products, listings and places1

Haraj ad details

/haraj/v1/listing

$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"

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 482 platforms.
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 481 other platforms
Built and maintained by API.SH, not third-party publishers
Pay per call; errors on our side cost nothing
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), and one ad with text, price, location, tags, attributes, car and real-estate details and photos (/haraj/v1/listing).

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/listing at 1 credit each.

Is there an official Haraj API?+

No public developer API turned up in our research. 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.

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.