{ "openapi": "3.0.1", "info": { "title": "Marktplaats Scraper - Listings, Prices & Sellers", "description": "Scrape Marktplaats.nl listings by keyword, category or pasted URL: price, condition, delivery, location with GPS, seller, photos and full descriptions. Covers 2dehands.be and 2ememain.be too.", "version": "1.0", "x-build-id": "qJgJOWzSpbwA4Z5PM" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/sian.agency~marktplaats-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-sian.agency-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/sian.agency~marktplaats-scraper/runs": { "post": { "operationId": "runs-sync-sian.agency-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/sian.agency~marktplaats-scraper/run-sync": { "post": { "operationId": "run-sync-sian.agency-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": { "operation": { "title": "šŸŽÆ What do you want to scrape?", "enum": [ "search", "seller", "detail" ], "type": "string", "description": "šŸŽÆ **ONE OPERATION PER RUN.** Each returns the same row shape, so results merge cleanly.\n\nšŸ” **Listing Search** ā€” a keyword, a whole category, or a search URL you paste. 100 ads per request.\nšŸŖ **Seller Listings** ā€” every live ad a seller or dealer has, from their profile URL or numeric ID.\nšŸ“„ **Listing Detail** ā€” ad URLs or IDs in, and back come view count, favourites, the exact posting timestamp, the untruncated text, the whole photo gallery and the seller's profile.", "default": "search" }, "site": { "title": "šŸŒ Market", "enum": [ "marktplaats.nl", "2dehands.be", "2ememain.be" ], "type": "string", "description": "šŸŒ **WHICH SITE TO READ.** All three run the same catalogue software, so categories and filters behave identically.\n\nšŸ‡³šŸ‡± **marktplaats.nl** ā€” the Dutch market, and by far the largest.\nšŸ‡§šŸ‡Ŗ **2dehands.be** ā€” the Belgian market in Dutch.\nšŸ‡§šŸ‡Ŗ **2ememain.be** ā€” the same Belgian inventory in French.", "default": "marktplaats.nl" }, "query": { "title": "šŸ”‘ Search keyword", "type": "string", "description": "šŸ”‘ **WHAT TO SEARCH FOR.** Searches the ad title and body, in the site's own language where it matters ('fiets' finds more than 'bicycle').\n\nšŸ’” **TIP:** leave this empty and pick a category to sweep that whole section ā€” the fastest way to build a full inventory snapshot.\n\nšŸ§© Keyword and category combine: 'iphone' inside šŸ“± Phones & telecom is narrower than either alone.", "default": "iphone" }, "category": { "title": "šŸ—‚ļø Category", "enum": [ "", "auto-s", "auto-onderdelen", "motoren", "fietsen-en-brommers", "caravans-en-kamperen", "watersport-en-boten", "huis-en-inrichting", "tuin-en-terras", "witgoed-en-apparatuur", "doe-het-zelf-en-verbouw", "audio-tv-en-foto", "computers-en-software", "telecommunicatie", "spelcomputers-en-games", "kleding-dames", "kleding-heren", "sieraden-tassen-en-uiterlijk", "kinderen-en-baby-s", "sport-en-fitness", "hobby-en-vrije-tijd", "muziek-en-instrumenten", "boeken", "cd-s-en-dvd-s", "verzamelen", "antiek-en-kunst", "postzegels-en-munten", "dieren-en-toebehoren", "huizen-en-kamers", "vakantie", "vacatures", "diensten-en-vakmensen", "tickets-en-kaartjes", "zakelijke-goederen", "auto-diversen", "contacten-en-berichten", "diversen" ], "type": "string", "description": "šŸ—‚ļø **WHICH SECTION TO SWEEP.** šŸŒ All categories searches the whole site.\n\nšŸ’” **TIP:** an empty keyword plus a category returns that section newest-first ā€” the shape you want for a daily monitor.\n\nšŸ”— **Going deeper:** to target a sub-category (Elektrische fietsen, a specific car make), open it on the site and paste that address into šŸŒ Search URLs instead.", "default": "" }, "searchUrls": { "title": "šŸŒ Search URLs", "uniqueItems": true, "type": "array", "description": "šŸŒ **PASTE URLS INSTEAD OF FILLING THE FORM.** Copy any search, category or sub-category address from the site and drop it here.\n\nšŸ§  **The site resolves each URL itself**, so every filter baked into it is honoured ā€” sub-categories, car makes and models, fuel type, frame size, and facets added after this actor shipped.\n\nšŸ“„ **BULK EDIT:** paste many URLs, one per line, or upload a .txt file.\n\nāš ļø Filters the site keeps behind a `#` never leave your browser ā€” set those with the fields below.", "default": [], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "listingUrls": { "title": "šŸ“„ Ad URLs", "uniqueItems": true, "type": "array", "description": "šŸ“„ **USED BY THE LISTING DETAIL OPERATION.** Which ads to open.\n\nāœ… **SUPPORTED:** the full ad URL, copied from your browser or taken from any row this actor returns.\n\nšŸ§  Only have the ad ID? Address it as `https://link.marktplaats.nl/m0000000000` (or `link.2dehands.be`, `link.2ememain.be`) and the site resolves it to the live ad ā€” so an ad that moved category still opens.\n\nšŸ“„ **BULK EDIT:** paste many, one per line, or upload a .txt file.", "default": [], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "sellers": { "title": "šŸŖ Sellers", "uniqueItems": true, "type": "array", "description": "šŸŖ **USED BY THE SELLER LISTINGS OPERATION.** Whose inventory to pull.\n\nāœ… **SUPPORTED:** the seller profile URL from any of their ads (`https://www.marktplaats.nl/u/name/7530354/`), or the bare numeric seller ID.\n\nšŸ’” **TIP:** every row this actor returns carries šŸ‘¤ Seller ID ā€” feed those straight back in here to expand a dealer you found in a search.", "default": [], "items": { "type": "string" } }, "maxResults": { "title": "šŸ”¢ Max listings", "minimum": 1, "maximum": 20000, "type": "integer", "description": "šŸ”¢ **HOW MANY ADS TO RETURN**, across everything the run touches.\n\nšŸ“¦ Each request brings back up to 100 ads, so the run finishes on the first request that crosses your number.\n\nāš ļø The site stops paginating any single query at 5,000 results. To go past that, split the query ā€” more categories, tighter price bands, or a postcode radius per region.", "default": 100 }, "includeDetails": { "title": "šŸ“„ Open each ad's page", "type": "boolean", "description": "šŸ“„ **OPEN EACH AD'S OWN PAGE** for the fields a search result cannot carry: šŸ‘ļø view count, ā¤ļø favourites, šŸ•’ the exact posting timestamp, the untruncated description, the complete photo gallery, šŸ”Ø current bids and the seller's profile with their type and years active.\n\nšŸ’° **COSTS EXTRA:** one additional request per ad, billed as one Listing Detail event on top of the listing row. Leave it off and you pay for listing rows only.", "default": false }, "minPrice": { "title": "šŸ’µ Min price (ā‚¬)", "minimum": 0, "type": "integer", "description": "šŸ’µ **CHEAPEST ASKING PRICE TO INCLUDE**, in whole euros. 0 means no lower bound.\n\nāš ļø Setting either bound drops ads with no fixed price ā€” bidding, on request, see description ā€” because the site filters on the price field itself.", "default": 0 }, "maxPrice": { "title": "šŸ’° Max price (ā‚¬)", "minimum": 0, "type": "integer", "description": "šŸ’° **MOST EXPENSIVE ASKING PRICE TO INCLUDE**, in whole euros. 0 means no upper bound.\n\nšŸ’” **TIP:** narrow price bands are how you get past the 5,000-result ceiling on a big category ā€” run ā‚¬0-100, ā‚¬100-250, ā‚¬250-500 and merge.", "default": 0 }, "condition": { "title": "āœØ Condition", "enum": [ "any", "new", "as-new", "used", "refurbished", "not-working" ], "type": "string", "description": "āœØ **RESTRICT TO ONE CONDITION.** Sellers pick this themselves when they post, so it is the ad's own claim rather than an inspection ā€” but it is the field buyers filter on, and it splits a category cleanly into retail-grade and second-hand stock.", "default": "any" }, "delivery": { "title": "šŸ“¦ Delivery", "enum": [ "any", "shipping", "pickup" ], "type": "string", "description": "šŸ“¦ **HOW THE ITEM CHANGES HANDS.**\n\nšŸšš **Ships to buyer** turns a local classifieds sweep into a national one: those sellers post anywhere in the country, so distance stops mattering.\n\nšŸ¤ **Collection only** is the opposite ā€” pair it with a postcode radius for genuinely local stock.", "default": "any" }, "buyItNowOnly": { "title": "āš” Buy-it-now only", "type": "boolean", "description": "āš” **ONLY ADS A BUYER CAN PURCHASE IMMEDIATELY** at the listed price, skipping every bidding and negotiate-by-message listing.\n\nšŸ’” **TIP:** this is the subset with a real, comparable number in the price field ā€” turn it on before you compute any average.", "default": false }, "postedSince": { "title": "šŸ†• Posted since", "enum": [ "always", "today", "yesterday", "week" ], "type": "string", "description": "šŸ†• **RESTRICT TO RECENTLY POSTED ADS.**\n\nšŸ’” **TIP:** šŸŒ… Today is the cheap way to run this on a schedule ā€” each run then bills only the ads that appeared since the last one, instead of re-paying for the whole category.", "default": "always" }, "postcode": { "title": "šŸ“® Postcode", "type": "string", "description": "šŸ“® **CENTRE THE SEARCH ON A POSTCODE.** 1011AB for Amsterdam, 3011 for Rotterdam, 2000 for Antwerp on the Belgian sites.\n\nāš ļø **Needs šŸ“ Search radius** to do anything on its own.\n\nšŸ“ When both are set, every row comes back with a measured šŸ“ Distance (km).", "default": "" }, "radiusKm": { "title": "šŸ“ Search radius (km)", "minimum": 0, "maximum": 500, "type": "integer", "description": "šŸ“ **HOW FAR FROM THE POSTCODE TO LOOK**, in kilometres. 0 searches the whole country.\n\nšŸ’” **TIP:** a ring of 25 km searches around the five biggest cities covers most of the population and keeps each query under the 5,000-result ceiling.", "default": 0 }, "sort": { "title": "ā†•ļø Sort by", "enum": [ "newest", "oldest", "relevance", "price-asc", "price-desc" ], "type": "string", "description": "ā†•ļø **WHICH ADS COME FIRST.**\n\nšŸ•’ **Newest first** is what you want for monitoring.\n\nšŸ’” **TIP:** ā¬†ļø Cheapest first finds the bottom of a price distribution without paging through all 5,000 results ā€” flip to ā¬‡ļø most expensive and you have both ends in two small runs.", "default": "newest" } } }, "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 } } } } } } } } } }