{ "openapi": "3.0.1", "info": { "title": "Marktplaats Scraper", "description": "[💰 $1.0 / 1K] Scrape Marktplaats listings at scale.", "version": "1.0", "x-build-id": "O6oqNbrVYhazRp20X" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/solidcode~marktplaats-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-solidcode-marktplaats-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~marktplaats-scraper/runs": { "post": { "operationId": "runs-sync-solidcode-marktplaats-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~marktplaats-scraper/run-sync": { "post": { "operationId": "run-sync-solidcode-marktplaats-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": { "searchUrls": { "title": "Search or Category URLs", "type": "array", "description": "Paste one or more Marktplaats URLs. Two shapes are read exactly: a keyword search URL such as https://www.marktplaats.nl/q/iphone+15/, and a category URL that carries its category numbers, such as https://www.marktplaats.nl/l/auto-s/bmw/?l1CategoryId=91&l2CategoryId=96. A plain category URL with no category numbers (https://www.marktplaats.nl/l/auto-s/bmw/) cannot be matched to a category, so it is searched as the keyword 'bmw' instead and the run log says so.", "items": { "type": "string" } }, "searchQueries": { "title": "Search Queries", "type": "array", "description": "Plain-text search terms — for example 'iPhone 15 Pro' or 'LEGO City set'. The scraper will search Marktplaats and return matching listings.", "items": { "type": "string" } }, "maxResults": { "title": "Max Results", "minimum": 0, "type": "integer", "description": "Maximum total number of listings to collect. The limit is shared evenly across every URL and query you enter, so each one gets its own share and none is left empty — whatever a search does not use rolls over to the ones still to run. Listings come back in pages of 30, so every search returns at least 30 and the final total can land a little above your limit. Set to 0 for no limit.", "default": 100 }, "sortBy": { "title": "Sort Results By", "enum": [ "date_down", "price_asc", "price_desc", "relevance" ], "type": "string", "description": "Choose the order in which listings are collected from Marktplaats.", "default": "date_down" }, "minPrice": { "title": "Minimum Price (€)", "minimum": 0, "type": "integer", "description": "Only include listings priced at or above this amount in euros. Leave empty for no minimum." }, "maxPrice": { "title": "Maximum Price (€)", "minimum": 0, "type": "integer", "description": "Only include listings priced at or below this amount in euros. Leave empty for no maximum." }, "includeSponsored": { "title": "Include sponsored ads", "type": "boolean", "description": "Marktplaats mixes paid advertisements from webshops into its search results (often around 1 in 5 results). Leave this on to receive them just as they appear on the site. Turn it off to collect only genuine listings from the search, and to avoid paying for advertising you did not search for.", "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 } } } } } } } } } }