{ "openapi": "3.0.1", "info": { "title": "Netherlands Visa Sponsors: IND Recognised Sponsor Register", "description": "Netherlands recognised visa sponsors: search the IND register of employers approved to sponsor work and highly skilled migrant permits by name, KVK number or legal form, or get sponsors new since your last run. $0.0008 per sponsor, $0.002 per new sponsor.", "version": "0.1", "x-build-id": "SSzMbz0ALxwP2iLUt" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/datagleaner~netherlands-recognised-sponsors/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-datagleaner-netherlands-recognised-sponsors", "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/datagleaner~netherlands-recognised-sponsors/runs": { "post": { "operationId": "runs-sync-datagleaner-netherlands-recognised-sponsors", "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/datagleaner~netherlands-recognised-sponsors/run-sync": { "post": { "operationId": "run-sync-datagleaner-netherlands-recognised-sponsors", "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": { "query": { "title": "Organisation name contains", "type": "string", "description": "Case-insensitive text the organisation name must contain, e.g. `software`, `ziekenhuis`, `shell`." }, "kvkNumbers": { "title": "KVK numbers", "type": "array", "description": "Check specific organisations by Chamber of Commerce (KVK) number, 8 digits. Handy to verify a list of employers in one run.", "items": { "type": "string" } }, "legalForms": { "title": "Legal forms", "type": "array", "description": "Keep names ending in these forms: BV, NV, VOF, CV, Stichting, Vereniging, Cooperatie, DE (GmbH/AG), Anglo (Ltd/Inc/LLP), FR (SA/SARL), SE.", "items": { "type": "string" } }, "listAll": { "title": "List the whole register", "type": "boolean", "description": "Return every recognised sponsor when no filter is set (about 12,700 rows, billed per row). Without any filter or this switch the Actor runs a 5-row example.", "default": false }, "watchMode": { "title": "Watch mode (new sponsors since last run)", "type": "boolean", "description": "Compare the register with the copy saved by your previous run in the named store below and return only organisations that are new (filters still apply). The IND updates the register monthly. The first run saves a baseline for free; a run on an unchanged register is free too.", "default": false }, "storeName": { "title": "Watch store name", "type": "string", "description": "Named key-value store holding the previous register. Use a different name for each separate watch.", "default": "nl-sponsor-watch" }, "maxResults": { "title": "Maximum results", "minimum": 1, "maximum": 50000, "type": "integer", "description": "Stop after this many billed rows. In watch mode a capped run does not advance the baseline.", "default": 1000 }, "changeTypes": { "title": "Change types (watch mode)", "type": "array", "description": "Watch mode: `new` (newly recognised) and `notListed` (in your saved register but no longer listed). Leave empty for `new`.", "items": { "type": "string", "enum": [ "new", "notListed" ] }, "default": [] } } }, "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 } } } } } } } } } }