{ "openapi": "3.0.1", "info": { "title": "Salla & Zid App Store Tracker", "description": "Track public Salla and Zid app listings, ratings and displayed prices. Export new or changed apps between runs. Optional category enrichment; no marketplace login required. App listings, not merchant product catalogs.", "version": "0.1", "x-build-id": "QJZsyu9NDtc5SuRms" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/abdulwhab95~salla-zid-app-store-tracker/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-abdulwhab95-salla-zid-app-store-tracker", "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/abdulwhab95~salla-zid-app-store-tracker/runs": { "post": { "operationId": "runs-sync-abdulwhab95-salla-zid-app-store-tracker", "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/abdulwhab95~salla-zid-app-store-tracker/run-sync": { "post": { "operationId": "run-sync-abdulwhab95-salla-zid-app-store-tracker", "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", "properties": { "platforms": { "title": "App stores", "type": "array", "description": "Which app stores to read.", "items": { "type": "string", "enum": [ "salla", "zid" ], "enumTitles": [ "Salla App Store (apps.salla.sa)", "Zid App Market (apps.zid.sa)" ] }, "default": [ "salla", "zid" ] }, "language": { "title": "Language", "enum": [ "en", "ar" ], "type": "string", "description": "Language of app names, categories and pricing text, as the stores show them.", "default": "en" }, "maxAppsPerPlatform": { "title": "Max apps per store", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Stop after this many apps from each store, in the store's own listing order. With 'Only new or changed apps' it counts apps checked, not apps delivered.", "default": 5000 }, "includeCategories": { "title": "Include Salla categories", "type": "boolean", "description": "On (default): Salla's 18 category lists are walked too (about 110 extra requests) so every Salla app gets category and categories. Off: that walk is skipped and Salla rows carry category and categories as null (not looked up). Zid rows always carry their category, which the Zid listing includes. With 'Only new or changed apps', each setting keeps its own Salla snapshot, so the first run after switching returns Salla apps as NEW.", "default": true }, "onlyChanges": { "title": "Only new or changed apps", "type": "boolean", "description": "Tracking mode. Remembers every app between runs and returns only apps that are new or whose rating, rating count, price or pricing text changed (with changeType, changedFields, previousRating, previousRatingCount and previousPrice). The first run returns every app as NEW.", "default": false }, "stateStoreName": { "title": "State store name", "type": "string", "description": "Named key-value store that keeps the last snapshot for 'Only new or changed apps'. Use a different name for each independent tracker.", "default": "gulf-app-stores-state" } } }, "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 } } } } } } } } } }