Search Marktplaats listings by price, distance and date.

curl -s https://wield.run/api/v1/recipes/marktplaats.nl/search-listings | shasum -a 256
# 27be3cbae8bdc5cc0a9f74677fae601d77fd4e0e38c52f19273aa0853f7cc6de

{
  "description": "Searches Marktplaats, the Netherlands' largest classifieds site, like its search: title, short description, price in euros and price type (fixed, bidding, free, …), city, distance from a postcode, when it was listed, seller and whether verified, pickup or shipping, promoted flag, image and link. Sort by relevance, newest, price or distance. Admarkt ads from businesses are dropped by default.",
  "effect": "read",
  "id": "marktplaats.nl/search-listings",
  "keywords": [
    "marktplaats",
    "tweedehands",
    "kopen",
    "verkopen",
    "fiets",
    "occasion",
    "advertentie",
    "gebruikt",
    "second hand",
    "classifieds",
    "netherlands",
    "used",
    "marketplace"
  ],
  "output": {
    "schema": {
      "properties": {
        "listings": {
          "items": {
            "properties": {
              "city": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "delivery": {
                "description": "Ophalen (pickup), Verzenden (shipping) or both",
                "type": [
                  "string",
                  "null"
                ]
              },
              "description": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "distance_km": {
                "type": [
                  "number",
                  "null"
                ]
              },
              "id": {
                "type": "string"
              },
              "image": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "latitude": {
                "type": [
                  "number",
                  "null"
                ]
              },
              "listed": {
                "description": "As Marktplaats shows it, e.g. 'Vandaag', '3 nov 26'",
                "type": [
                  "string",
                  "null"
                ]
              },
              "longitude": {
                "type": [
                  "number",
                  "null"
                ]
              },
              "price_eur": {
                "type": [
                  "number",
                  "null"
                ]
              },
              "price_type": {
                "description": "FIXED, BIDDING (bieden), FREE, SEE_DESCRIPTION, …",
                "type": [
                  "string",
                  "null"
                ]
              },
              "promoted": {
                "description": "The seller paid for a boost (e.g. Dagtopper)",
                "type": "boolean"
              },
              "seller": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "seller_verified": {
                "type": "boolean"
              },
              "sponsored": {
                "description": "Admarkt business ad",
                "type": "boolean"
              },
              "title": {
                "type": "string"
              },
              "url": {
                "type": "string"
              }
            },
            "type": "object"
          },
          "type": "array"
        },
        "page": {
          "type": "integer"
        },
        "query": {
          "type": "string"
        },
        "total": {
          "type": [
            "integer",
            "null"
          ]
        }
      },
      "type": "object"
    },
    "value": "let $ads = params.include_ads == `true` in {query: params.query, total: steps.search[0].total || `null`, page: params.page || `1`, listings: map(&(let $l = @ in {id: $l.itemId, title: $l.title, description: $l.description || `null`, price_eur: ($l.priceInfo.priceCents > `0` && $l.priceInfo.priceCents / `100`) || (($l.priceInfo.priceType == 'FREE') && `0`) || `null`, price_type: $l.priceInfo.priceType || `null`, city: $l.location.cityName || `null`, distance_km: ($l.location.distanceMeters >= `0` && $l.location.distanceMeters / `1000`) || `null`, latitude: $l.location.latitude || `null`, longitude: $l.location.longitude || `null`, listed: $l.date || `null`, seller: $l.sellerInformation.sellerName || `null`, seller_verified: $l.sellerInformation.isVerified == `true`, delivery: ($l.attributes[?key == 'delivery'] | [0].value) || `null`, promoted: $l.priorityProduct != 'NONE' && $l.priorityProduct != `null`, sponsored: starts_with($l.itemId, 'a') || contains($l.traits || `[]`, 'ADMARKT_CONSOLE'), image: ($l.pictures[0].mediumUrl && (starts_with($l.pictures[0].mediumUrl, '//') && join('', ['https:', $l.pictures[0].mediumUrl]) || $l.pictures[0].mediumUrl)) || `null`, url: join('', ['https://www.marktplaats.nl', $l.vipUrl])}), steps.search[0].listings || `[]`)[?$ads || !sponsored]}"
  },
  "params": {
    "additionalProperties": false,
    "properties": {
      "distance_km": {
        "description": "Only with postcode",
        "enum": [
          3,
          5,
          10,
          15,
          25,
          50,
          75
        ],
        "type": "integer"
      },
      "include_ads": {
        "default": false,
        "description": "Keep Admarkt business ads (marked sponsored)",
        "type": "boolean"
      },
      "max_price": {
        "description": "EUR",
        "minimum": 0,
        "type": "number"
      },
      "min_price": {
        "description": "EUR",
        "minimum": 0,
        "type": "number"
      },
      "page": {
        "default": 1,
        "maximum": 20,
        "minimum": 1,
        "type": "integer"
      },
      "postcode": {
        "description": "Dutch postcode for distance, e.g. '1012AB'",
        "pattern": "^[1-9][0-9]{3} ?[A-Za-z]{2}$",
        "type": "string"
      },
      "query": {
        "description": "What to look for, e.g. 'fiets', 'bakfiets', 'iphone 13'",
        "maxLength": 100,
        "minLength": 2,
        "type": "string"
      },
      "sort": {
        "default": "relevance",
        "enum": [
          "relevance",
          "newest",
          "price_low",
          "price_high",
          "distance"
        ],
        "type": "string"
      }
    },
    "required": [
      "query"
    ],
    "type": "object"
  },
  "provenance": {
    "method": "browser-inspect",
    "notes": "The list page /q/<query>/ is server-rendered (__NEXT_DATA__ props.pageProps.searchRequestAndResponse), but its filters live in the URL hash, which never reaches the server. When filters change, the page calls /lrp/api/search with query, limit, offset, sortBy (OPTIMIZED, SORT_INDEX, PRICE, LOCATION), sortOrder, attributeRanges[]=PriceCents:<min|null>:<max|null>, postcode, distanceMeters. Admarkt business ads: itemId starting with 'a', traits ADMARKT_CONSOLE, priorityProduct NONE. Dagtopper/Topadvertentie are paid boosts of genuine listings (priorityProduct), kept and marked promoted. robots.txt disallows some /lrp/api paths but not /lrp/api/search. Answers servers too.",
    "recorded_at": "2026-11-07T19:08:00+01:00",
    "recorded_by": "C4"
  },
  "requires_login": false,
  "schema": "https://wield.run/schema/recipe/v1.json",
  "site": {
    "country": "NL",
    "id": "marktplaats.nl",
    "language": "nl",
    "name": "Marktplaats",
    "origin": "https://www.marktplaats.nl",
    "origins": [
      "https://www.marktplaats.nl"
    ]
  },
  "steps": [
    {
      "description": "Marktplaats's own search API (the list page calls it when filters change). The one-item foreach builds the price range, sort and offset.",
      "expect": {
        "assert": "body.listings != `null`",
        "content_type": "json",
        "status": [
          200
        ]
      },
      "extract": {
        "json": {
          "listings": "listings",
          "total": "totalResultCount"
        }
      },
      "foreach": {
        "as": "f",
        "in": "[{offset: (params.page - `1`) * `30`, range: (params.min_price || params.max_price) && join('', ['PriceCents:', params.min_price && to_string(floor(params.min_price * `100`)) || 'null', ':', params.max_price && to_string(floor(params.max_price * `100`)) || 'null']) || `null`, sortBy: (params.sort == 'newest' && 'SORT_INDEX') || ((params.sort == 'price_low' || params.sort == 'price_high') && 'PRICE') || (params.sort == 'distance' && 'LOCATION') || 'OPTIMIZED', sortOrder: (params.sort == 'newest' && 'DECREASING') || (params.sort == 'price_high' && 'DECREASING') || 'INCREASING', postcode: params.postcode && upper(replace(params.postcode, ' ', '')) || `null`, distance: params.postcode && params.distance_km && to_string(params.distance_km * `1000`) || `null`}]",
        "max": 1
      },
      "id": "search",
      "request": {
        "headers": {
          "Accept": "application/json"
        },
        "method": "GET",
        "query": {
          "attributeRanges[]": "{{f.range}}",
          "distanceMeters": "{{f.distance}}",
          "limit": "30",
          "offset": "{{f.offset}}",
          "postcode": "{{f.postcode}}",
          "query": "{{params.query}}",
          "sortBy": "{{f.sortBy}}",
          "sortOrder": "{{f.sortOrder}}",
          "viewOptions": "list-view"
        },
        "url": "/lrp/api/search"
      }
    }
  ],
  "task": "Search Marktplaats listings by price, distance and date",
  "tos": {
    "notes": "One search request per call, the same one the list page makes. No messages, no bids.",
    "reviewed": false
  },
  "verify": {
    "checks": [
      "length(output.listings) > `10`",
      "length(output.listings[?sponsored]) == `0`",
      "length(output.listings[?price_eur > `300`]) == `0`",
      "length(output.listings[?starts_with(url, 'https://www.marktplaats.nl/v/')]) == length(output.listings)",
      "output.total > `100`"
    ],
    "example_params": {
      "max_price": 300,
      "query": "fiets",
      "sort": "newest"
    },
    "max_ms": 3000
  },
  "version": 1
}