{ "openapi": "3.0.1", "info": { "title": "Zid Store Scraper — Products, Prices & Stock", "description": "Paste any Zid store URL and get every public product as clean structured data — Arabic names, prices in the store's own currency, list price and sale price, live stock, and variants. Stores on their own domain are detected too. متجر زد | تصدير منتجات زد", "version": "0.1", "x-build-id": "vXuyEGA5ZNHotHeBD" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/al_mansouri~zid-store-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-al_mansouri-zid-store-scraper", "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/al_mansouri~zid-store-scraper/runs": { "post": { "operationId": "runs-sync-al_mansouri-zid-store-scraper", "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/al_mansouri~zid-store-scraper/run-sync": { "post": { "operationId": "run-sync-al_mansouri-zid-store-scraper", "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": [ "startUrls" ], "properties": { "startUrls": { "title": "Store URLs", "minItems": 1, "maxItems": 50, "uniqueItems": true, "type": "array", "description": "Zid store URLs — a homepage, a category page, or a single product page. Mixing them is fine. Stores on their own domain work exactly like stores on a zid.store address. متجر زد", "items": { "type": "string", "pattern": "^https?://" } }, "maxItems": { "title": "Maximum products", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Stop after this many products in total across every store in the run. Raise it for a large catalog — one measured store carries over 8,000 products.", "default": 200 }, "includeOutOfStock": { "title": "Keep sold-out products", "type": "boolean", "description": "Keep products the store lists as out of stock. Turn this off to export only what can be bought right now. Products whose stock could not be determined are always kept, and marked \"unknown\".", "default": true }, "includeVariants": { "title": "Expand product options", "type": "boolean", "description": "Include every publicly visible option combination — sizes, colours — each with its own price and stock. Turn off for one row per product with no variant detail.", "default": true }, "language": { "title": "Storefront language", "enum": [ "auto", "ar", "en" ], "type": "string", "description": "Which language version of the storefront to prefer. \"Automatic\" takes whatever the store serves by default, which for most Zid stores is Arabic.", "default": "auto" }, "respectRobots": { "title": "Respect robots.txt", "type": "boolean", "description": "Skip anything the store's robots.txt asks crawlers not to read. Leave this on unless you own the store and are exporting your own catalog.", "default": true }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Optional. Only needed for a store behind a CDN that refuses datacenter addresses; every store in our survey answered without one. A proxy is never used to reach anything robots.txt disallows.", "default": { "useApifyProxy": false } } } }, "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 } } }, "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 } } } } } } } } } }