Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Haraj Scraper: KSA Classified Listings | Saudi Marketplace | Apify Actor

Apify Actor Node.js TypeScript Free Tier REST API Direct

Haraj scraper and Saudi Arabia classifieds data extraction API. Extract cars, real estate, electronics, prices, locations, and specifications from Haraj.com.sa with high-performance GraphQL API connections. Free tier included.

Whether you are a car dealer, a real estate analyst, or an e-commerce vendor, this Actor delivers clean, structured datasets in under 10 seconds.

Quick Start · Output Schema · Pricing · FAQ

Haraj Scraper Apify Actor hero screenshot


What is Haraj Scraper?

Haraj Scraper is an Apify Actor that extracts public marketplace classified listings from Haraj.com.sa, Saudi Arabia's largest online marketplace. It extracts cars, real estate, electronics, pricing, locations, images, and specifications in Arabic and English. The scraper connects directly to Haraj's GraphQL API, bypassing slow browser rendering and delivering results in under 10 seconds.

Why use Haraj Scraper?

  • No browser overhead. Connects directly to Haraj's GraphQL API, cutting runtime and compute costs by 90%.
  • Flat JSON output. Completely flat dataset with no nested objects, ensuring perfect CSV and Excel exports.
  • Arabic and English support. Preserves all Arabic titles, descriptions, neighborhoods, and tags exactly as returned.
  • Regional proxy routing. Uses premium residential proxies to appear as domestic Saudi users, bypassing regional blocks cleanly.
  • Real-time data. Executes live requests on every query, retrieving the absolute latest classified listings.

Quick Start

npm install apify-client
import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: process.env.APIFY_TOKEN });

const run = await client.actor('getascraper/haraj-scraper').call({
  search: 'toyota',
  city: 'Riyadh',
  maxItems: 100
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);

How to use

  1. Create a free Apify account (no credit card needed).
  2. Open the Haraj Scraper in the Apify Console.
  3. Enter your product search keywords (e.g. toyota, iphone, or شقة).
  4. Select the target category (e.g. Cars, Real Estate, Devices) or target city.
  5. Click Start and download your structured Saudi marketplace dataset as JSON, CSV, or Excel.

What data does it extract?

Field Description
id Unique identifier of the listing on Haraj.
url Canonical link to the listing page.
title Listing display title.
body Full listing description text (Arabic or English).
authorUsername Username of the posting seller.
authorId Unique profile ID of the posting seller.
city Broad region name of the listing (e.g. Riyadh, Jeddah).
geoCity Specific city location of the listing.
geoNeighborhood Local neighborhood name of the listing.
postDate ISO timestamp of when the listing was created.
updateDate ISO timestamp of when the listing was last updated.
tags Comma-separated category tags.
hasImage True if the listing has photos.
hasVideo True if the listing has video attachments.
thumbnailUrl Fully-resolved absolute CDN thumbnail image link.
imagesList Comma-separated high-resolution photo URLs.
price Parsed numeric price value.
formattedPrice Formatted price text (e.g. 190,000 SAR).
commentCount Total comments posted on this listing.
upRank Up-vote rating count.
downRank Down-vote rating count.
isPromoted True if this is a sponsored or featured listing.
postType Classified format type (always AD).
carModel Vehicle model year (if car listing).
carOrRelated Vehicle classification tag (CAR or RELATED).
sellOrWaiver Sale terms (SELL or WAIVER).
carMileage Vehicle mileage odometer value in thousands (if car listing).
carFuel Vehicle fuel category (DIESEL or GASOLINE).
carGear Transmission type (AUTO or MANUAL).
carCondition General vehicle condition (USED or NEW).
scrapedAt ISO timestamp of when the row was scraped.

Output Example

{
  "id": "182466169",
  "url": "https://haraj.com.sa/11182466169/تويوتا_هايس_2026_الجديدة/",
  "title": "تويوتا هايس 2026 الجديدة",
  "body": "تويوتا هايس 2026 ركاب جديد ديزل ارتفاع كامل اتصل بنا...",
  "authorUsername": "مؤسسة مسارات النظم",
  "authorId": "20163797",
  "city": "الرياض",
  "geoCity": "الرياض",
  "geoNeighborhood": "الملز",
  "postDate": "2026-06-15T08:48:15.000Z",
  "updateDate": "2026-06-15T08:48:15.000Z",
  "tags": "حراج السيارات, تويوتا, باص, باص 2026, باص, ركاب",
  "hasImage": true,
  "hasVideo": false,
  "thumbnailUrl": "https://mimg6cdn.haraj.com.sa/userfiles30/405x900-1_-AhGsmMBx7flhl5.jpg-140x140.webp",
  "imagesList": "https://mimg6cdn.haraj.com.sa/userfiles30/2026-6-15/405x900-1_-AhGsmMBx7flhl5.jpg, https://mimg6cdn.haraj.com.sa/userfiles30/2026-6-15/900x405-1_-40tinaS7cON82L.jpg",
  "price": "190000",
  "formattedPrice": "190,000",
  "commentCount": 0,
  "upRank": 0,
  "downRank": 0,
  "isPromoted": false,
  "postType": "AD",
  "carModel": 2026,
  "carOrRelated": "CAR",
  "sellOrWaiver": "SELL",
  "carMileage": null,
  "carFuel": "DIESEL",
  "carGear": "AUTO",
  "carCondition": null,
  "scrapedAt": "2026-06-15T10:51:10.367Z"
}

Pricing

$2.99 per 1,000 results. Free tier included.

Listings scraped Cost (USD)
100 $0.30
500 $1.50
1,000 $2.99
5,000 $14.95
10,000 $29.90

Advanced Options

  • Search filtering. Use search field for keywords (e.g. toyota, iphone, شقة).
  • Category filtering. Use tag field to filter by Cars, Real Estate, Devices, Furniture, Jobs, etc.
  • City filtering. Use city field to target specific Saudi cities (Riyadh, Jeddah, Eastern Region, etc.).
  • Date filtering. Use duringDate to get listings from Last 24 Hours, 3 Days, Week, or Month.
  • Image filtering. Enable onlyWithImage to return only listings with photos.
  • Seller filtering. Use authorUsername to filter listings by a specific seller.
  • Proxy configuration. Pre-configured residential proxies recommended for clean regional access.

Supported URL types

  • https://haraj.com.sa (homepage with all categories)
  • https://haraj.com.sa/search?q=toyota (search results)
  • Category-specific pages via GraphQL API
  • City-specific filtered listings

Use cases

  • Car dealers and resellers monitoring price benchmarks and active vehicle listings across specific models, years, and mileages in Saudi Arabia.
  • Real estate analysts tracking historical property valuations, areas, and listing activity across major Saudi regions.
  • E-commerce vendors backfilling localized Saudi electronic and consumer goods inventory into their own directories.
  • Market researchers analyzing pricing trends and demand patterns across Saudi Arabia's largest marketplace.
  • Liquidation specialists finding resale arbitrage opportunities across cars, electronics, and real estate.

FAQ

Is the Haraj scraper legal?

Yes. The scraper retrieves publicly available classified listings on Haraj. Make sure your usage complies with Haraj Terms of Service and applicable laws.

Does it get blocked by Haraj?

No. The scraper natively routes through premium residential proxies by default. This makes the automated traffic appear identical to regular domestic Saudi Arabian users, bypassing regional blocks cleanly.

Does it extract seller phone numbers?

No. To protect user privacy and comply with global data regulations, the scraper does not extract private seller profiles or contact phone numbers. It only retrieves public listings, descriptions, specifications, prices, and seller names.

How fresh is the data?

Extremely fresh. The scraper executes live requests on every query, retrieving the absolute latest classified listings posted on Haraj in real-time.

Are all regions supported?

Yes. The scraper supports all major regions across Saudi Arabia, as well as listings from Kuwait, the UAE, and Bahrain.

Disclaimers

This Actor is an independent tool and is not affiliated with, endorsed by, or sponsored by Haraj. The scraper retrieves publicly available classified listings on Haraj. Make sure your usage complies with Haraj Terms of Service and applicable laws. You are responsible for complying with Haraj's terms of service and applicable laws.

Support


Built with Apify and direct GraphQL API integration. Part of the getascraper ecosystem.

About

Haraj scraper and Saudi Arabia classifieds data extraction API. Extract cars, real estate, electronics, prices, and locations from haraj.com.sa with high-performance GraphQL API. Free tier available.

Topics

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages