{ "openapi": "3.0.1", "info": { "title": "Bizi.si Slovenia Scraper: Slovenska podjetja for Business Leads", "description": "Scrape public Bizi.si records for slovenska podjetja by keyword, location, employee band, ownership, capital, and registration date. Export registry, contact, and map fields to Google Sheets, Airtable, Make, or Zapier. Skip manual directory exports. From $0.0039 per company record.", "version": "0.1", "x-build-id": "HHTTEK15aDlMio02I" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/getascraper~bizi-si-business-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-getascraper-bizi-si-business-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/getascraper~bizi-si-business-scraper/runs": { "post": { "operationId": "runs-sync-getascraper-bizi-si-business-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/getascraper~bizi-si-business-scraper/run-sync": { "post": { "operationId": "run-sync-getascraper-bizi-si-business-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": "Public Bizi URLs", "maxItems": 20, "type": "array", "description": "Optional public Bizi.si search or company-profile URLs. Login, service, paid-report, and unrelated URLs are rejected.", "items": { "type": "object", "properties": { "url": { "title": "URL", "type": "string", "description": "Public Bizi.si search or company-profile URL." } }, "required": [ "url" ] }, "default": [] }, "searchTerms": { "title": "Search Terms", "minItems": 0, "maxItems": 20, "type": "array", "description": "Optional Slovenian or English terms such as restavracija, računovodstvo, hotel, or plumber. Leave blank when using public URLs.", "items": { "type": "string" }, "default": [] }, "locations": { "title": "Locations", "maxItems": 20, "type": "array", "description": "Optional Slovenian city, municipality, or settlement names combined with every search term.", "items": { "type": "string" }, "default": [] }, "addressContains": { "title": "Address Contains", "type": "string", "description": "Optional public address text passed to Bizi's advanced search. Leave blank to search every address.", "default": "" }, "employeeBand": { "title": "Employee Band", "enum": [ "any", "0-4", "5-9", "10-19", "20-49", "50-99", "100-149", "150-199", "200-249", "250-499", "500+" ], "type": "string", "description": "Keep companies in the selected Bizi employee-count band. The source publishes bands rather than exact totals.", "default": "any" }, "companySize": { "title": "Company Size", "enum": [ "any", "not-calculated", "small", "medium", "large", "micro", "unknown" ], "type": "string", "description": "Filter by the public Bizi company-size classification when it is available.", "default": "any" }, "capitalType": { "title": "Capital Type", "enum": [ "any", "domestic", "foreign", "mixed", "not-determined", "unknown" ], "type": "string", "description": "Filter by the public Bizi capital classification, such as domestic, foreign, or mixed capital.", "default": "any" }, "ownershipType": { "title": "Ownership Type", "enum": [ "any", "social", "private", "cooperative", "mixed", "state", "unknown" ], "type": "string", "description": "Filter by the public Bizi ownership classification, such as private, state, or cooperative ownership.", "default": "any" }, "registrationDateFrom": { "title": "Registered From", "type": "string", "description": "Optional earliest registration date in YYYY-MM-DD format.", "default": "" }, "registrationDateTo": { "title": "Registered To", "type": "string", "description": "Optional latest registration date in YYYY-MM-DD format.", "default": "" }, "includeBusinessUnits": { "title": "Include Business Units", "type": "boolean", "description": "Also search public Bizi business-unit records when the source exposes them.", "default": false }, "scrapeDetails": { "title": "Fetch Public Profile Details", "type": "boolean", "description": "Open each matching public profile to collect listed phone, email, website, coordinates, registry fields, and registration date.", "default": false }, "runMode": { "title": "Run Mode", "enum": [ "snapshot", "changes" ], "type": "string", "description": "Snapshot returns every matching company. Changes returns only new or changed companies using persistent Actor state.", "default": "snapshot" }, "maxItems": { "title": "Maximum Companies", "minimum": 1, "maximum": 250, "type": "integer", "description": "Maximum unique companies to process across all supplied searches and URLs.", "default": 10 }, "maxPages": { "title": "Maximum Result Pages Per Search", "minimum": 1, "maximum": 25, "type": "integer", "description": "Maximum Bizi result pages to inspect for each search. The maximum-company limit still stops work early.", "default": 10 }, "requestDelayMs": { "title": "Request Delay", "minimum": 250, "maximum": 5000, "type": "integer", "description": "Minimum delay in milliseconds between requests in a Bizi session. Increase it for gentler scheduled collection.", "default": 500 } } }, "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 } } } } } } } } } }