{ "openapi": "3.0.1", "info": { "title": "OLX Scraper - Listings, Ad Details, Phone Numbers", "description": "Scrape OLX classifieds in Poland, Ukraine, Romania, Bulgaria, and Portugal. Search listings by keyword, category, location, and price. Get ad details with descriptions, GPS, and photos, and reveal seller phone numbers. $2 per 1,000 results.", "version": "0.0", "x-build-id": "ee32Sy5XEECPIj4aF" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/sourabhbgp~olx-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-sourabhbgp-olx-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/sourabhbgp~olx-scraper/runs": { "post": { "operationId": "runs-sync-sourabhbgp-olx-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/sourabhbgp~olx-scraper/run-sync": { "post": { "operationId": "run-sync-sourabhbgp-olx-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": [ "mode", "market" ], "properties": { "mode": { "title": "Mode", "enum": [ "search", "detail" ], "type": "string", "description": "search: find offers by keyword, category, location and price. detail: fetch specific offers by URL or ID.", "default": "search" }, "market": { "title": "Market (country)", "enum": [ "pl", "ua", "ro", "bg", "pt" ], "type": "string", "description": "OLX country site to scrape. All share the same data.", "default": "pl" }, "query": { "title": "Search query", "type": "string", "description": "Free-text keyword to search for (search mode). Leave empty to browse a whole category or location." }, "categoryId": { "title": "Category ID", "minimum": 1, "type": "integer", "description": "Numeric OLX category id to restrict to (optional). Find it in an offer's category.id or via a category page URL." }, "regionId": { "title": "Region ID", "minimum": 1, "type": "integer", "description": "Numeric region (voivodeship / county) id to restrict to (optional)." }, "cityId": { "title": "City ID", "minimum": 1, "type": "integer", "description": "Numeric city id to restrict to (optional). Requires or complements Region ID." }, "priceMin": { "title": "Min price", "minimum": 0, "type": "integer", "description": "Minimum price in the market's local currency (optional)." }, "priceMax": { "title": "Max price", "minimum": 0, "type": "integer", "description": "Maximum price in the market's local currency (optional)." }, "condition": { "title": "Condition", "enum": [ "any", "new", "used" ], "type": "string", "description": "Filter by item condition (search mode).", "default": "any" }, "sortBy": { "title": "Sort by", "enum": [ "relevance", "created_desc", "price_asc", "price_desc" ], "type": "string", "description": "Result ordering (search mode).", "default": "relevance" }, "offerUrls": { "title": "Offer URLs or IDs", "type": "array", "description": "Detail mode: OLX offer URLs (https://www.olx.pl/d/oferta/...) or bare numeric offer IDs.", "items": { "type": "string" } }, "includePhone": { "title": "Reveal phone numbers", "type": "boolean", "description": "Fetch the seller's phone number for each offer where it is public (adds one request per offer; numbers are unavailable on chat-only offers).", "default": false }, "maxItems": { "title": "Max results", "minimum": 0, "type": "integer", "description": "Stop after this many offers. 0 = no limit (search will page until OLX's browse ceiling; slice by filter to go deeper).", "default": 100 } } }, "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 } } } } } } } } } }