marktplaats

A command-line interface for searching Marktplaats.nl listings.

Install

# npm
npm install -g marktplaats

# pnpm
pnpm add -g marktplaats

# yarn
yarn global add marktplaats

# bun
bun add -g marktplaats

From source

git clone https://github.com/TheAlexLichter/marktplaats.git
cd marktplaats
pnpm install
pnpm build
npm link

Usage

Search listings

marktplaats search "fiets"

With filters:

# Sort by price, ascending
marktplaats search "fiets" --sort PRICE --sort-order INCREASING

# Location-based search
marktplaats search "fiets" --postcode 1012AB --distance 10000

# Price range
marktplaats search "fiets" --min-price 50 --max-price 200

# Filter by category, limit results
marktplaats search "fiets" --category 445 --limit 10

# Paginate
marktplaats search "fiets" --page 2

# Interactive TUI mode
marktplaats search "fiets" -i

# Output as JSON
marktplaats search "fiets" --json

Search options

| Option | Alias | Description | Default | | --------------- | ----- | --------------------------------------------------------------- | ------------ | | --limit | -l | Results per page | 25 | | --sort | -s | Sort by: DATE, PRICE, OPTIMIZED, LOCATION, SORT_INDEX | SORT_INDEX | | --sort-order | | DECREASING or INCREASING | DECREASING | | --postcode | -p | Postcode for location search | | | --distance | -d | Radius in meters from postcode | | | --category | | Category ID | | | --min-price | | Minimum price in euros | | | --max-price | | Maximum price in euros | | | --page | | Page number | 1 | | --interactive | -i | Interactive TUI mode | false | | --json | | Output as JSON | false |

View a listing

marktplaats view <itemId>
marktplaats view <itemId> --json

Open in browser

marktplaats open <itemId>

Browse categories

# List all categories
marktplaats categories

# Filter by name
marktplaats categories fiets

View seller's listings

# Pass any listing ID to see other listings from the same seller
marktplaats seller <itemId>
marktplaats seller <itemId> --json

Saved searches

# Save a search
marktplaats saved add bikes fiets --postcode 1012AB --distance 5000

# List saved searches
marktplaats saved list

# Run a saved search
marktplaats saved run bikes

# Remove a saved search
marktplaats saved remove bikes

Watch for new listings

# Watch a search (checks every 60s by default)
marktplaats watch "fiets"

# Custom interval
marktplaats watch "macbook" --interval 30

# With filters
marktplaats watch "fiets" --min-price 50 --max-price 200 --postcode 1012AB

Config

# Set defaults
marktplaats config set postcode 1012AB
marktplaats config set distance 5000

# View config
marktplaats config get

# Get a single key
marktplaats config get postcode

# Remove a default
marktplaats config unset postcode

# Show config file path
marktplaats config path

Config defaults are merged with CLI flags (flags take precedence).

JSON output

All commands that support --json produce structured output with:

• Full listing URLs
• Price in both cents and euros
• Geo coordinates (latitude/longitude)
• Seller info with verification status
• Multi-resolution image URLs (small, medium, large, extraLarge)
• Extended attributes as key-value pairs
• Ad/reserved flags, traits, and verticals

Development

# Install dependencies
vp install

# Dev mode (watch)
vp pack --watch

# Run tests
vp test

# Lint & format
vp lint
vp fmt

# Build
vp pack

License

MIT