ScavioScavio
Pricing
Tools
Sign InsGet Startedg
Quick StartAPI & SDKsEcosystem

bol.com

bol.com Search API

Search bol.com, the Netherlands' and Belgium's largest online marketplace, on its Dutch, Belgian Dutch or Belgian French storefront: each product with its id, title, brand, category, rating and buy-box offer (price, reference price and its type, discount, seller, condition, delivery promise, labels), sponsored placements flagged, plus bol's facets with counts. Sort by relevance, popularity, price, rating or most wished for and filter by price, condition, deals, delivery, brand, category or any facet. Up to page 10 (about 280 results). Costs 2 credits.

POST/api/v1/bolcom/search

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>, where <token> is your Scavio API key (e.g. Bearer sk_live_your_key).

Body

application/json
querystringrequired

Search keywords, 1-200 characters. Dutch or French keywords match best; an EAN finds that product.

Example: airpods

countryenum<string>default:nl

The bol.com storefront country: nl (bol.com Netherlands) or be (bol.com Belgium). Prices are euros on both. Anything else answers 400, not charged.

Example: be

  • nl — bol.com Netherlands (storefront nl-nl). The default.
  • be — bol.com Belgium: be-nl in Dutch, or be-fr with language fr.
languageenum<string>default:nl

The storefront language: nl (Dutch) or fr (French, only with country be: storefront be-fr). country nl with language fr answers 400, not charged.

Example: fr

  • nl — Dutch. The default, on nl and be.
  • fr — French, on be only (be-fr).
pageintegerdefault:1

Results page, 1 to 10, about 24-30 items a page. bol.com search stops at page 10 (about 280 results); higher answers 400. Split a large query by category, brand or price to reach more.

Example: 2

sortenum<string>default:relevance

Result order. Sorting by anything but relevance can narrow bol's result set (measured: nintendo switch 6,655 results by relevance, 30 by price): total is bol's count for that sort. No newest sort.

Example: price_asc

  • relevance — bol's best match. The default.
  • popularity — bol's popularity order.
  • price_asc — Price, low to high, in bol's own ordering (small inversions against the live buy-box price occur).
  • price_desc — Price, high to low, in bol's own ordering.
  • rating — bol's rating order (weighted, not a strict sort by average).
  • wishlist — Most wished for first.
category_idstring

Search within one category: a category id from the category facet or a product's category_path.

Example: 76364

price_minnumber

Lowest price in euros.

Example: 50

price_maxnumber

Highest price in euros. price_min must not exceed price_max.

Example: 250

conditionstring | string[]

One or more of new, refurbished, second_hand: keeps products with an offer in that condition. offer stays the buy box (often new); cheapest_second_hand and cheapest_refurbished carry those offers.

Example: ["refurbished", "second_hand"]

deals_onlyboolean

Only products on a deal.

Example: true

select_dealsboolean

Only bol Select member deals (the list, not Select member prices).

Example: true

deliverystring | string[]

Delivery filters as bol offers them: today, tomorrow, evening, sunday, free_shipping (one or more).

Example: tomorrow

brand_facet_idstring

A brand value id from the brand facet of an earlier answer (facets[].values[].id of the Merk / Marque facet, e.g. 4294862300 Apple). A different id space from brand_id of the brand endpoint (Apple is 5070005 there).

Example: 4294862300

facetsstring[]

Up to 10 facet value ids from facets[].values[].id of an earlier answer (any facet: colour, size, rating band ...). Ids bol did not apply come back in filters_ignored.

Example: ["4294862300"]

Notes

Storefronts. This endpoint serves nl-nl, be-nl, be-fr: country nl (default) or be, language nl (default) or fr, where fr is only on be. Every answer echoes country, language, storefront and currency (EUR). country nl with language fr answers 400, as does any other country or language, before anything is charged.

storefrontBodyMarketLanguage
nl-nlcountry nl (the default)bol.com Netherlands, EURDutch
be-nlcountry bebol.com Belgium, EURDutch
be-frcountry be, language frbol.com Belgium, EURFrench for bol's own texts; some partner titles and review_topics stay Dutch; review texts are bol's translation (is_translated)

Request

from scavio import ScavioClient

client = ScavioClient(api_key="sk_live_your_key", timeout=60)

# The same query on the Dutch and the Belgian storefront: 2 credits per call.
for country in ["nl", "be"]:
    d = client.bolcom.search(query="airpods", country=country)["data"]
    for i in d["items"][:5]:
        o = i["offer"] or {}
        print(country, i["product_id"], o.get("price"), o.get("reference_price_type"), o.get("seller_name"), i["sponsored"])

Response

"query": "airpods",
"count": 28,
"sponsored_count": 6,
"total": 3776,
"page": 1,
"max_page": 10,
"has_more": true,
"sort": "relevance",
"country": "nl",
"language": "nl",
"storefront": "nl-nl",
"currency": "EUR"
},
"response_time": 7595
}
PreviousMercari ShopNextbol.com Product
ScavioScavio

One scraper API for every social, search, e-commerce and real estate platform. Built for AI agents.

Product

  • Features
  • Pricing
  • Dashboard
  • Affiliates

Developers

  • Documentation
  • API Reference
  • Quickstart
  • MCP Integration
  • Python SDK

Alternatives

  • Tavily Alternative
  • SerpAPI Alternative
  • Firecrawl Alternative
  • Exa Alternative
  • Serper Alternative
  • Tavily vs Scavio
  • SerpAPI vs Scavio
  • All alternatives
  • Compare Scavio vs alternatives

Search APIs

  • Google Search API
  • Amazon Product API
  • YouTube API
  • Reddit API
  • Walmart Product API
  • TikTok API
  • Instagram API

Tools

  • All Tools

Ask AI about Scavio

© 2026 Scavio. All rights reserved.

Featured on TAAFT
Terms of ServicePrivacy Policy