from 3 credits per call5 endpoints4 datapoints

bol.com API

bol.com API for product search, product details, offers, reviews and autocomplete in the Netherlands and Belgium as JSON, from 3 credits per call.

Get a free API key Run it below

bol.com

GET/v1/bol/autocomplete?q=lapt

{
  "success": true,
  "query": "lapt",
  "locale": "nl/nl",
  "total": 12,
  "suggestions": [
    {
      "type": "category",
      "label": "laptops",
      "category_id": "4770",
      "tag": "Computer"
    },
    {
      "type": "query",
      "label": "laptop",
      "search_term": "laptop"
    },
    {
      "type": "query",
      "label": "laptoptas",
      "search_term": "laptoptas"
    }
  ],
  "meta": {
    "endpoint_family": "autocomplete",
    "attempts": 1,
    "request_id": "req_2d86f6f004df4879b1c8ef171494632a",
    "credits_charged": 3,
    "credits_remaining": 1967
  }
}

200 OKJSONX-Credits-Used: 3

Recorded from our API and shortened.

Sample data

What one call returns

A recorded run of autocomplete: the fields and shapes you will get, shortened to 3 items.

#	typestring	labelstring	category_idstring	tagstring
1	category	laptops	4770	Computer
2	query	laptop	—	—
3	query	laptoptas	—	—

[
  {
    "type": "category",
    "label": "laptops",
    "category_id": "4770",
    "tag": "Computer"
  },
  {
    "type": "query",
    "label": "laptop",
    "search_term": "laptop"
  },
  {
    "type": "query",
    "label": "laptoptas",
    "search_term": "laptoptas"
  }
]

type,label,category_id,tag
category,laptops,4770,Computer
query,laptop,,
query,laptoptas,,

Recorded from our API · 3 items shown · 4 datapoints per itemGET /v1/bol/autocomplete?q=lapt

4 datapoints

Identity

typestring
category_idstring

Other

labelstring
tagstring

Playground

Run this API

cURLshell

curl "https://api.perceptlayer.com/v1/bol/autocomplete?q=lapt" \
  -H "X-API-Key: $API_KEY"

bol.com · 5 endpoints

Endpoints

Every endpoint takes the same key. Open one for its parameters and an example request.

Endpoint	Required parameters	Cost
GET`/v1/bol/autocomplete`	`q`+2 optional	3 credits
GET`/v1/bol/offers`	none+6 optional	3 credits
GET`/v1/bol/product`	none+5 optional	7 credits
GET`/v1/bol/reviews`	none+5 optional	7 credits
GET`/v1/bol/search`	`q`+8 optional	9 credits

Overview

What you can get

The bol.com API returns bol.com product data as JSON through 5 endpoints. Each takes a country (nl or be) and a language (nl or fr).

Search: search takes a q, with page, category, facet_ids, min_price, max_price and sort (relevance, price_asc, price_desc, rating or popularity). autocomplete takes a partial q.
Products: product and reviews take a product id, url or slug.
Offers: offers takes the same, with condition (new or refurbished).

The recorded autocomplete for "lapt" returns the query, the locale, a total (12 in that recording) and suggestions, each with a type and label: category suggestions add a category_id and tag, and query suggestions add a search_term.

How a call works

Look up a product: GET /v1/bol/product?id=9300000171550609 with your key in the X-API-Key header. Pass the same id to offers, with condition=new or refurbished, and to reviews. Autocomplete query suggestions carry a search_term to pass to search as q. search costs 9 credits, product and reviews cost 7, and offers and autocomplete cost 3. Failed calls cost nothing.

MarketplacesJSONRESTMCP

More marketplaces APIs

Use cases

Track bol.com prices for a product list in the Netherlands or Belgium

Use the bol.com API to track bol.com prices for a product list in the Netherlands or Belgium

Compare new and refurbished offers for a product

Use the bol.com API to compare new and refurbished offers for a product

Analyse product reviews

Use the bol.com API to analyse product reviews

Research search terms and categories with autocomplete

Use the bol.com API to research search terms and categories with autocomplete

FAQ

Questions

How much does the bol.com API cost?

`search` costs 9 credits per successful call, `product` and `reviews` cost 7, and `offers` and `autocomplete` cost 3. Failed calls cost nothing. New accounts get free credits to start, and credit packs bring the price down as you scale.

Can I get Belgian results in French?

Yes. Pass `country=be` and `language=fr` to any endpoint.

Do I need a bol.com account?

No. You call this bol.com API with your Perceptlayer key in the `X-API-Key` header, with no bol.com login.

What format are responses in?

Every endpoint returns JSON, with no HTML parsing on your side.

Should I build a bol.com scraper instead?

You can, but a bol.com scraper is code you maintain: page changes break it, requests get blocked, and bol.com's terms govern how you collect data. The bol.com API gives you 5 endpoints of named JSON fields for 3 credits per successful call, and failed calls cost nothing. A scraper makes sense only for data these endpoints don't return, so check the response in the playground on this page first.

Try the bol.com API with 100 free credits

No credit card. Failed calls are never billed.

Get a free API key Read the docs