Spiral gives your agent every tool with one account. Browse the tools →

AlexandriaE-commerceAvailable now

Marktplaats · Search

marktplaats-nl/listings/search

Get product, price and seller data with Marktplaats · Search from Alexandria through one Spiral API key. Finding second-hand or new items for sale in the Netherlands: call with a query, then narrow with category_id/subcategory_id from categories, filters from filters, min_price/max_price, postcode/distance_km, condition or sort. It runs in the background and returns structured JSON. Pay as you go, with no subscription.

Pricing

$0.00873 per call.

Limits

Runs
In the background
Returns
json
Longest queue wait
1 hour
Run deadline
5 minutes
Longest run, end to end
225 minutes
Largest inline input
1 MB
Largest input file
2 GB
Largest output
5 GB

Input

FieldKindDefaultDescription
pagenumber
1 to 200
1

Result page, 30 listings per page; pass next_page from the previous result. The site serves at most max_page pages.

sortone of
relevance, newest, oldest, price_asc, price_desc
—

Result order from the site's sort menu: relevance (default), newest or oldest listing date, price low to high, price high to low.

querytext—

Search keywords as typed in the Marktplaats search box, e.g. 'fiets' or 'iphone 15'. Optional when category_id is given.

filtersJSON—

Chosen filters as key/value pairs: keys are a returned filter's key, values one of its values[].value (or an array of them for multi_select filters). Example: {"delivery": "Verzenden", "offeredSince": "Een week", "storage": ["128 GB", "256 GB"]}. A key or value the search does not offer is rejected as invalid_input.

postcodetext—

Dutch postcode, e.g. '1012 AB'. Results then carry their distance from it. Pattern: ^[1-9][0-9]{3} ?[A-Za-z]{2}$.

conditionlist—

Item condition (Nieuw, Zo goed als nieuw, Gebruikt, Refurbished, Niet werkend); several values match any of them. Same as filters {"condition": [...]}.

max_pricenumber
0 to 100000000
—

Highest price in EUR.

min_pricenumber
0 to 100000000
—

Lowest price in EUR.

category_idnumber
1 to 99999999
—

Top-level category id from a previous result's categories (an entry with parent_id null), e.g. 445 Fietsen en Brommers.

distance_kmnumber
1 to 300
—

Only listings within this many km of postcode; needs postcode.

subcategory_idnumber
1 to 99999999
—

Subcategory id from categories (an entry whose parent_id is category_id); needs category_id.

Same request in code

curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "alexandria",
    "model": "marktplaats-nl/listings/search",
    "input": {
      "query": "<query>"
    }
  }'

Frequently asked questions

How much does Marktplaats · Search cost?

$0.00873 per call. You pay as you go from one Spiral balance, with no subscription, and a failed run is not charged.

How do I use Marktplaats · Search through an API?

Send `POST /v1/runs` with `"provider": "alexandria"`, `"model": "marktplaats-nl/listings/search"` and the input fields on this page, using one Spiral API key. It runs in the background: poll the run, or name a webhook to be told when it finishes.

Do I need an account with Alexandria to use Marktplaats · Search?

No. Spiral runs it on its own Alexandria account and charges your Spiral balance.

Can my AI agent use Marktplaats · Search?

Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.