{ "openapi": "3.0.1", "info": { "title": "Njuškalo Scraper", "description": "[💰 $1.4 / 1K] Extract classified listings from Njuškalo.hr, Croatia's largest marketplace. Get titles, prices, photos, locations, seller names and phone numbers, and attributes for cars, real estate, electronics, fashion, jobs, and more. Search by keyword or paste any category or listing URL.", "version": "1.0", "x-build-id": "XIhx6bOZ35wi1zuK0" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/solidcode~njuskalo-hr-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-solidcode-njuskalo-hr-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/solidcode~njuskalo-hr-scraper/runs": { "post": { "operationId": "runs-sync-solidcode-njuskalo-hr-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/solidcode~njuskalo-hr-scraper/run-sync": { "post": { "operationId": "run-sync-solidcode-njuskalo-hr-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", "properties": { "startUrls": { "title": "Njuškalo URLs", "type": "array", "description": "Paste Njuškalo.hr URLs directly. Works with category pages (e.g. https://www.njuskalo.hr/prodaja-stanova), filtered or region pages, search-result pages, and direct listing pages. Any filters already in the URL (price, location, sort, keywords) are applied automatically. Mix as many URLs as you like.", "items": { "type": "string" } }, "searchKeywords": { "title": "Search Keywords", "type": "array", "description": "Type what you are looking for (e.g. 'Audi A4', 'iPhone 15', 'apartment Zagreb'). Each keyword runs a Njuškalo search across all categories. No need to build URLs by hand.", "items": { "type": "string" } }, "category": { "title": "Category", "enum": [ "all", "nekretnine", "automobili", "vozila", "mobiteli", "racunala", "elektronika", "moda", "dom-i-vrt", "sport", "djecja-oprema", "poslovi", "usluge", "zivotinje" ], "type": "string", "description": "Limit keyword searches to one Njuškalo category. Only applies to Search Keywords above — ignored for URLs, which carry their own category. Leave on 'All Categories' to search everything.", "default": "all" }, "sortBy": { "title": "Sort Results By", "enum": [ "relevance", "newest", "cheapest", "expensive" ], "type": "string", "description": "Order in which keyword-search listings are collected. Only applies to Search Keywords — URLs keep their own sort order.", "default": "relevance" }, "maxResults": { "title": "Max Results", "minimum": 0, "type": "integer", "description": "Maximum number of listings to collect across all URLs and keywords combined, up to 100,000 per run. Set to 0 for unlimited — a single source then scans a very large but finite number of result pages (effectively unlimited for normal use). Tip: start with 20-50 to test, then increase.", "default": 100 }, "includeListingDetails": { "title": "Include Full Listing Details", "type": "boolean", "description": "Open each listing's detail page to capture the full description, all photos, seller name and phone, exact location, and category-specific attributes (mileage, rooms, size, etc.). Slower but much richer. When off, only the data visible on result pages is returned.", "default": 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 } } }, "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 } } } } } } } } } }