blocket-cli
Fast CLI for searching Blocket.se — Sweden's largest marketplace.
Search the general marketplace, cars, boats, and motorcycles. Designed for agents, scripts, and quick terminal lookups. Minimal dependencies, structured output.
Install
pip install blocket-cli
Or with uv:
uv tool install blocket-cli
Usage
Search general marketplace
blocket search "soffa"
blocket search "iphone 15" -l stockholm --price-max 8000
blocket search "mountainbike" -c sports --sort price-asc -n 10
blocket search "ps5" -c electronics -o json | jq '.results[:3]'
Search cars
blocket cars "volvo xc60" --year-min 2018 --mileage-max 12000
blocket cars "tesla model 3" --fuel el --sort price-asc
blocket cars "vw alltrack" -l stockholm --price-max 300000 -o json
Search boats
blocket boats "segelbat" --length-min 30
blocket boats "bayliner" --sort price-asc -o json
Search motorcycles
blocket mc "yamaha mt-07" --year-min 2020
blocket mc "harley" --sort price-desc -o json
Get ad details
blocket ad 20851738
blocket ad 20851738 -o json
Browse filters
blocket categories # general marketplace categories
blocket locations # Swedish counties
blocket fuels # fuel types for car search
Output formats
| Flag | Format | Use case |
|---|---|---|
| (default) | Human-readable table | Terminal browsing |
-o json |
Compact JSON | Piping to jq, API consumption |
-o jsonl |
One JSON object per line | Streaming, log processing |
Common options
All search commands support these shared options:
| Option | Description |
|---|---|
-l, --location |
Filter by Swedish county (e.g. stockholm, skane) |
--price-min |
Minimum price in SEK |
--price-max |
Maximum price in SEK |
--sort |
Sort order (relevance, price-asc, price-desc, date) |
-n, --limit |
Max results to display |
-p, --page |
Page number |
-o, --output |
Output format (table, json, jsonl) |
--raw |
Full API response instead of slim fields |
General marketplace options
| Option | Description |
|---|---|
-c, --category |
Category filter (electronics, furniture, sports, etc.) |
Car options
| Option | Description |
|---|---|
--year-min / --year-max |
Model year range |
--mileage-min / --mileage-max |
Mileage in Swedish mil (1 mil = 10 km) |
--fuel |
Fuel type (bensin, diesel, el, hybrid-bensin, etc.) |
--transmission |
manuell or automat |
--sort |
Also supports mileage-asc, mileage-desc, year-asc, year-desc |
Boat options
| Option | Description |
|---|---|
--length-min / --length-max |
Length in feet |
Motorcycle options
| Option | Description |
|---|---|
--year-min / --year-max |
Model year range |
--mileage-min / --mileage-max |
Mileage in Swedish mil |
--sort |
Also supports mileage-asc, mileage-desc, year-asc, year-desc |
Agent integration
The JSON output is designed for LLM agents and automation:
# Compact car search results
blocket cars "volvo" --year-min 2020 -o json | jq '.results[:3]'
# Stream general listings line by line
blocket search "soffa" -o jsonl
# Price analysis
blocket cars "tesla model 3" --fuel el -o json | python3 -c "
import sys, json
data = json.load(sys.stdin)
prices = [r['price'] for r in data['results'] if r.get('price') and r['price'] > 10]
print(f'Found {data[\"total\"]} listings')
print(f'Price range: {min(prices):,} - {max(prices):,} SEK')
print(f'Average: {sum(prices)//len(prices):,} SEK')
"
License
MIT