{ "openapi": "3.0.1", "info": { "title": "Marktplaats Scraper — Netherlands Listings, Prices & Bids", "description": "Scrape Marktplaats.nl by search term, category or URL: title, price and price type, condition, delivery, brand, attributes, category, town, photos, posted date. Optional details add the full description, all photos, views, favourites and bids. Never collects sellers' names or contacts. No login.", "version": "0.1", "x-build-id": "y7iFflkyQxftegx1h" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/yugenox~marktplaats-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-yugenox-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/yugenox~marktplaats-scraper/runs": { "post": { "operationId": "runs-sync-yugenox-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/yugenox~marktplaats-scraper/run-sync": { "post": { "operationId": "run-sync-yugenox-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": { "searchTerms": { "title": "🔍 Search terms", "type": "array", "description": "What to search for, as you would type it on Marktplaats, e.g. \"iphone 15\", \"gazelle\", \"lego technic\". Each term is a separate search. Leave empty to browse a whole category.", "items": { "type": "string" } }, "category": { "title": "Category", "enum": [ "all", "antiek-en-kunst", "audio-tv-en-foto", "auto-s", "auto-onderdelen", "auto-diversen", "boeken", "caravans-en-kamperen", "cd-s-en-dvd-s", "computers-en-software", "diensten-en-vakmensen", "dieren-en-toebehoren", "doe-het-zelf-en-verbouw", "fietsen-en-brommers", "hobby-en-vrije-tijd", "huis-en-inrichting", "huizen-en-kamers", "kinderen-en-baby-s", "kleding-dames", "kleding-heren", "motoren", "muziek-en-instrumenten", "postzegels-en-munten", "sieraden-tassen-en-uiterlijk", "spelcomputers-en-games", "sport-en-fitness", "telecommunicatie", "tickets-en-kaartjes", "tuin-en-terras", "vacatures", "vakantie", "verzamelen", "watersport-en-boten", "witgoed-en-apparatuur", "zakelijke-goederen", "diversen" ], "type": "string", "description": "Limit the search to one Marktplaats category, or browse it without search terms. For a subcategory, paste its URL under Marktplaats URLs.", "default": "all" }, "maxItems": { "title": "Max listings", "minimum": 0, "maximum": 100000, "type": "integer", "description": "Maximum number of listings for the whole run, shared fairly between your searches. 0 = as many as possible (Marktplaats shows up to 5,010 per search; bigger searches are split into subcategories automatically).", "default": 100 }, "includeDetails": { "title": "Include item details", "type": "boolean", "description": "Also open each item page for the full description, every photo, the spec table, the exact posting time, views, favourites, bids and whether the seller is private or a business. One extra page per listing.", "default": false }, "startUrls": { "title": "🔗 Marktplaats URLs", "type": "array", "description": "Optional: Marktplaats search or category URLs (marktplaats.nl/q/… or /l/…, including filters such as brand or condition) or item URLs (marktplaats.nl/v/…). Sorting, price range and postcode filters live after the # in a URL and are applied by your browser only, so they are ignored.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "condition": { "title": "Condition", "type": "array", "description": "Only items in these conditions. Leave empty for any.", "items": { "type": "string", "enum": [ "new", "as-good-as-new", "used", "refurbished", "not-working" ], "enumTitles": [ "New (Nieuw)", "As good as new (Zo goed als nieuw)", "Used (Gebruikt)", "Refurbished", "Not working (Niet werkend)" ] } }, "delivery": { "title": "Delivery", "enum": [ "any", "pickup", "shipping" ], "type": "string", "description": "Pick-up only, shipping only, or any.", "default": "any" }, "includeDescription": { "title": "Include descriptions", "type": "boolean", "description": "Turn off to leave the seller-written description out of every row.", "default": true }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Apify Proxy (datacenter) is the default and comes with every Apify plan. If Marktplaats refuses datacenter IPs for a while, the run switches to residential proxies when your account has them.", "default": { "useApifyProxy": 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 }, "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 } } } } } } } } } }