{ "openapi": "3.0.1", "info": { "title": "Haraj (حراج) Scraper - Saudi Classifieds Listings + Prices", "description": "Search haraj.com.sa, Saudi Arabia's largest classifieds site, and get public listings: title, price in SAR, city, category, photos, publish time and URL. No login, no cookies. Rows are deduplicated; empty and partial search terms are reported separately and never charged.", "version": "0.0", "x-build-id": "jeshuyfgYCDscp1g6" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/lanternlab318~haraj/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-lanternlab318-haraj", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/lanternlab318~haraj/runs": { "post": { "operationId": "runs-sync-lanternlab318-haraj", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/lanternlab318~haraj/run-sync": { "post": { "operationId": "run-sync-lanternlab318-haraj", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "searchQueries" ], "properties": { "searchQueries": { "title": "Search terms", "type": "array", "description": "One Haraj search term per line. Search in Arabic - the site is Arabic-first and an Arabic term (for example كورفيت for Corvette) returns far more than its English spelling. Every term is searched separately and its listings are labelled with it. A listing that matches several of your terms is returned once and charged once.", "items": { "type": "string" } }, "city": { "title": "City / region", "type": "string", "description": "Restrict every search to one city or region, exactly as Haraj writes it, for example الرياض (Riyadh), جده (Jeddah) or الشرقيه (Eastern Province). Leave empty to search all of Saudi Arabia. A wrong spelling can return an empty result, so copy the name from the site's city filter." }, "category": { "title": "Category", "type": "string", "description": "Keep only listings whose category matches this Haraj category name exactly, for example حراج السيارات (cars). Leave empty to keep every category. A listing outside the category is dropped and counted on the term's status row, so a wrong spelling shows up as dropped listings, not as a silent empty result." }, "maxListings": { "title": "Max listings", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Upper bound on the listing rows this run writes in total. Each search term returns at most about 19 listings - Haraj's search page carries no further pages through this Actor - so with many terms the bound is usually yours, and the term that hits it is marked partial with reason \"listing_limit_reached\".", "default": 100 }, "maxUpstreamRequests": { "title": "Max Haraj requests", "minimum": 1, "maximum": 200, "type": "integer", "description": "Hard ceiling on the HTTP requests this run sends to Haraj. One search page per term is all a run needs, so the Actor works a ceiling out from your search terms when this is left empty. At the ceiling collection stops - the search terms not reached are written with partialReason \"upstream_request_cap\" and the run then ends normally." }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "The proxy the requests to Haraj go through. The default (Apify Proxy, datacenter) is the cheapest and is what this Actor is measured on; Haraj serves its public search pages over it without a login, a cookie or a bot check.", "default": { "useApifyProxy": true } } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }