--- title: "bol.com API: JSON data, 5 endpoints, from 3 credits per call" description: "bol.com API for product search, product details, offers, reviews and autocomplete in the Netherlands and Belgium as JSON, from 3 credits per call." url: https://perceptlayer.com/apis/bol --- [APIs](https://perceptlayer.com/apis) / [Marketplaces](https://perceptlayer.com/verticals/marketplaces) / bol.com from 3 credits per call 5 endpoints 4 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](https://perceptlayer.com/signup) 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 OK JSON X-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. | # | type string | label string | category\_id string | tag string | | --- | --- | --- | --- | --- | | 1 | category | laptops | 4770 | Computer | | 2 | query | laptop | — | — | | 3 | query | laptoptas | — | — | Recorded from our API · 3 items shown · 4 datapoints per item GET /v1/bol/autocomplete?q=lapt 4 datapoints ### Identity - type string - category\_id string ### Other - label string - tag string Playground ## Run this API cURL shell ``` 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`](https://perceptlayer.com/apis/bol/autocomplete) | `q` +2 optional | 3 credits | | [GET `/v1/bol/offers`](https://perceptlayer.com/apis/bol/offers) | none +6 optional | 3 credits | | [GET `/v1/bol/product`](https://perceptlayer.com/apis/bol/product) | none +5 optional | 7 credits | | [GET `/v1/bol/reviews`](https://perceptlayer.com/apis/bol/reviews) | none +5 optional | 7 credits | | [GET `/v1/bol/search`](https://perceptlayer.com/apis/bol/search) | `q` +8 optional | 9 credits | Overview ## About the bol.com API ## 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. Marketplaces JSON REST MCP ### More marketplaces APIs [About You](https://perceptlayer.com/apis/about-you) [adidas](https://perceptlayer.com/apis/adidas) [AliExpress](https://perceptlayer.com/apis/aliexpress) [Allegro](https://perceptlayer.com/apis/allegro) [Amazon](https://perceptlayer.com/apis/amazon) [ASOS](https://perceptlayer.com/apis/asos) [Billiger.de](https://perceptlayer.com/apis/billiger) [Chrono24](https://perceptlayer.com/apis/chrono24) [Costco](https://perceptlayer.com/apis/costco) [Craigslist](https://perceptlayer.com/apis/craigslist) [DBA](https://perceptlayer.com/apis/dba) [Depop](https://perceptlayer.com/apis/depop) 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](https://perceptlayer.com/signup) [Read the docs](https://docs.perceptlayer.com)