{ "openapi": "3.0.1", "info": { "title": "Marktplaats.nl Scraper (search, radius, price & new-ad alerts)", "description": "Marktplaats scraper for marktplaats.nl: search by keyword, category, postcode radius and price, and get flat rows with price and price type, condition, city, coordinates, photos and every listing attribute. Monitor mode alerts on new listings, price changes and reservations. No login, no proxy.", "version": "0.1", "x-build-id": "MJZ8efj7vaOgUKdIa" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/datahamster~marktplaats-listings/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-datahamster-marktplaats-listings", "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/datahamster~marktplaats-listings/runs": { "post": { "operationId": "runs-sync-datahamster-marktplaats-listings", "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/datahamster~marktplaats-listings/run-sync": { "post": { "operationId": "run-sync-datahamster-marktplaats-listings", "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": { "queries": { "title": "Search queries", "type": "array", "description": "Free-text searches, one string per search phrase, each paginated separately. Example: [\"fiets\", \"elektrische fiets\"]. Leave empty only if you pass a category id.", "default": [ "fiets" ], "items": { "type": "string" } }, "l1CategoryId": { "title": "Category id (level 1)", "minimum": 1, "type": "integer", "description": "Marktplaats numeric top-level category id, read from the c segment of a Marktplaats category URL. Example: 445 (Fietsen en Brommers). Optional." }, "l2CategoryId": { "title": "Category id (level 2)", "minimum": 1, "type": "integer", "description": "Marktplaats numeric sub-category id, read from the second c segment of a category URL. Example: 453. Optional." }, "postcode": { "title": "Postcode", "type": "string", "description": "Dutch postcode for a radius search, 4 digits plus 2 letters and no space. Example: \"1012AB\". Use together with distanceMeters. Optional." }, "distanceMeters": { "title": "Radius (meters)", "minimum": 1000, "type": "integer", "description": "Radius around postcode in metres. Example: 10000 for 10 km. Ignored unless postcode is set. Optional." }, "priceFrom": { "title": "Min price (EUR)", "minimum": 0, "type": "integer", "description": "Minimum price in whole euros. Example: 50. Optional." }, "priceTo": { "title": "Max price (EUR)", "minimum": 0, "type": "integer", "description": "Maximum price in whole euros. Example: 500. Optional." }, "sortBy": { "title": "Sort by", "enum": [ "SORT_INDEX", "PRICE", "LOCATION" ], "type": "string", "description": "Result order: SORT_INDEX (Marktplaats relevance/date ranking), PRICE, or LOCATION (distance from postcode). Example: \"SORT_INDEX\".", "default": "SORT_INDEX" }, "sortOrder": { "title": "Sort order", "enum": [ "DECREASING", "INCREASING" ], "type": "string", "description": "Direction for sortBy: DECREASING (high to low / newest first) or INCREASING (low to high). Example: \"DECREASING\".", "default": "DECREASING" }, "maxPages": { "title": "Pages per query", "minimum": 1, "maximum": 100, "type": "integer", "description": "How many result pages to fetch per query, 30 listings per page. Example: 5.", "default": 5 }, "maxItems": { "title": "Max items", "minimum": 1, "type": "integer", "description": "Stop the run after this many listings; you are charged only for listings actually pushed. Example: 20.", "default": 20 }, "mode": { "title": "Mode", "enum": [ "scrape", "monitor" ], "type": "string", "description": "scrape = return all matching listings; monitor = return only listings that are new, changed price or newly reserved since the previous run of this saved Task. Example: \"scrape\".", "default": "scrape" }, "monitorStateId": { "title": "Monitor state id", "type": "string", "description": "Optional state id when not running as a saved task (monitor mode)" }, "webhookUrl": { "title": "Webhook URL", "type": "string", "description": "Optional HTTPS URL that receives a POST with the monitor-mode change summary (JSON). Example: \"https://hooks.example.com/marktplaats\"." }, "telegramBotToken": { "title": "Telegram bot token", "type": "string", "description": "Optional Telegram bot token used to send monitor-mode change summaries. Format: \"123456789:AA...\"." }, "telegramChatId": { "title": "Telegram chat id", "type": "string", "description": "Optional Telegram chat id that receives monitor-mode summaries. Example: \"-1001234567890\"." } } }, "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 } } } } } } } } } }