Piloterr

Bol Product

GET
/v2/bol/product

Read one bol.com product by URL or product id, in nl, be-nl, or be-fr. You get the selling price, the list price, and the seller.

Credit cost: 2 credits per call

Authorization

ApiKeyAuth
headerx-api-key<token>

Your API key. Include it in the x-api-key header for every request.

Query Parameters

query*string

Product URL or numeric product id.

Examples:

9300000240171676
https://www.bol.com/nl/nl/p/apple-iphone-air-256gb-space-black/9300000240171676/
region?string

Shop. Use nl for the Netherlands in Dutch, be-nl for Belgium in Dutch, or be-fr for Belgium in French. Leave empty for nl. A full URL picks the shop from the path.

return_page_source?boolean

When true, return the raw HTML as {"result": "..."}.

fields?string

Comma-separated list of response fields to return, with dot notation for nested fields (e.g. name,location.city).

is_async?boolean

Run the request as a background job: the API answers 202 with a job_id to poll on GET /v1/jobs/{id}.

Defaultfalse
soft_fail?boolean

Return HTTP 200 even when the request fails; the error is in the error field of the body.

Defaultfalse

Response Body

Successful response

application/json
  1. response
mpn?string
url?string
gtin?string
brand?string
color?string
price?integer
title?string
images?array<string>
locale?string
rating?integer
region?string
seller?string
series?string
reviews?array<>
currency?string
delivery?string
variants?array<>
brand_url?string
condition?string
image_url?string
highlights?array<string>
list_price?integer
product_id?string
series_url?string
breadcrumbs?array<>
description?string
return_days?integer
availability?string
review_count?integer
weight_grams?integer
price_display?string
rating_counts?
seller_rating?number
shipping_cost?integer
rating_display?string
specifications?array<>
product_group_id?string
list_price_display?string
seller_rating_scale?integer
shipping_cost_display?string
Example Request
curl -X GET 'https://api.piloterr.com/v2/bol/product?query=string'
Example Response
{  "mpn": "iPhone Air - 256GB - Space Black",  "url": "https://www.bol.com/nl/nl/p/apple-iphone-air-256gb-space-black/9300000240171676/",  "gtin": "0195950622669",  "brand": "Apple",  "color": "Zwart",  "price": 895,  "title": "Apple iPhone Air - 256GB - Space Black",  "images": [    "https://media.s-bol.com/B3MRz4rqxr6N/nRJm0wp/1208x1500.jpg",    "https://media.s-bol.com/NJ6qQlVK3Wy6/DRjxogK/550x309.jpg",    "https://media.s-bol.com/1yy95wgwEW20/W76j4Eo/550x353.jpg",    "https://media.s-bol.com/q3OG4KVRQg0p/jqZPlJl/550x832.jpg",    "https://media.s-bol.com/QzYlpj63G7B5/wjwWnYJ/550x805.jpg",    "https://media.s-bol.com/7481oXqRgllj/pQJOxvp/408x840.jpg",    "https://media.s-bol.com/J3n7L58BJqZD/nRJm0wp/550x472.jpg",    "https://media.s-bol.com/yL4JRYwj0wXP/nRJm0wp/550x832.jpg",    "https://media.s-bol.com/K3o5M48D0ZOr/nRJm0wp/413x840.jpg",    "https://media.s-bol.com/G3kQG4R0D56y/nRJm0wp/131x840.jpg",    "https://media.s-bol.com/V6XmxJBRPjAB/nxvNg1E/548x840.jpg",    "https://media.s-bol.com/1RXjlV8LrnxZ/nxvNg1E/124x840.jpg",    "https://media.s-bol.com/Yg16AVG8vnoA/nxvNg1E/410x840.jpg",    "https://media.s-bol.com/R9Qgq8xNoJOz/nxvNg1E/550x467.jpg",    "https://media.s-bol.com/oLGYrA5g1xlz/nxvNg1E/550x682.jpg",    "https://media.s-bol.com/mv7y321ED290/oZVz43A/550x558.jpg",    "https://media.s-bol.com/WGG82656pq6g/W76j4Eo/550x520.jpg",    "https://media.s-bol.com/goAOj82Vzoqr/wjwWnYJ/550x683.jpg",    "https://media.s-bol.com/KqPNjzLWyYNz/wjwWnYJ/482x840.jpg"  ],  "locale": "nl-NL",  "rating": 5,  "region": "nl",  "seller": "Clevertronic",  "series": "Apple iPhone 17",  "reviews": [    {      "body": "Licht handzaam mooi krachtig gewoon top",      "title": "Super toestel. Ondanks wat er gezegd wordt een goede batterij",      "author": "Alex Martin",      "rating": 5,      "published_at": "2025-12-17"    },    {      "body": "ik gebruik de iphone air nu een paar maanden als opvolger van mijn iphone 15 pro. De air bevalt me beter. Hij is lichter en handzamer en zeker zo snel. Ik ervaar hem als stabieler en minder nerveus. De zogenaamd eenvoudiger camera is een non-issue; hij functioneert perfect.",      "title": "state of the art",      "author": "Jordan Lee",      "rating": 5,      "published_at": "2026-06-10"    }  ],  "currency": "EUR",  "delivery": "Voor 23:59 uur besteld, dinsdag in huis",  "variants": [    {      "url": "https://www.bol.com/nl/nl/p/apple-iphone-air-256gb-cloud-white/9300000240171668/",      "gtin": "0195950622867",      "color": "Wit",      "price": 899,      "title": "Apple iPhone Air - 256GB - Cloud White",      "seller": "Clevertronic",      "currency": "EUR",      "condition": "new",      "image_url": "https://media.s-bol.com/4MB65kz2NG42/Y7R28M0/1205x1500.jpg",      "product_id": "9300000240171668",      "availability": "in_stock",      "price_display": "899,00 €"    },    {      "url": "https://www.bol.com/nl/nl/p/apple-iphone-air-256gb-space-black/9300000240171676/",      "gtin": "0195950622669",      "color": "Zwart",      "price": 895,      "title": "Apple iPhone Air - 256GB - Space Black",      "seller": "Clevertronic",      "currency": "EUR",      "condition": "new",      "image_url": "https://media.s-bol.com/B3MRz4rqxr6N/nRJm0wp/1208x1500.jpg",      "product_id": "9300000240171676",      "availability": "in_stock",      "price_display": "895,00 €"    }  ],  "brand_url": "https://www.bol.com/nl/nl/pb/apple/5070005/",  "condition": "new",  "image_url": "https://media.s-bol.com/B3MRz4rqxr6N/nRJm0wp/1208x1500.jpg",  "highlights": [    "Apple",    "2025",    "Schermformaat:  6.5 in",    "256 GB opslag",    "Camera:  48 Megapixel",    "5G",    "Werkgeheugen:  12 GB",    "iOS 26"  ],  "list_price": 1199,  "product_id": "9300000240171676",  "series_url": "https://www.bol.com/nl/nl/serie/apple-iphone-17/9700000000011697/",  "breadcrumbs": [    {      "url": "https://www.bol.com/nl/nl/l/elektronica/3136/",      "name": "Elektronica"    },    {      "url": "https://www.bol.com/nl/nl/l/telefonie-accessoires/3137/",      "name": "Telefonie & Accessoires"    },    {      "url": "https://www.bol.com/nl/nl/l/smartphones/4010/",      "name": "Smartphones"    },    {      "url": "https://www.bol.com/nl/nl/p/apple-iphone-air-256gb-space-black/9300000240171676/",      "name": "Apple iPhone Air - 256GB - Space Black"    }  ],  "description": "De dunste iPhone ooit! Met zijn maar 5,6 mm en 165 gram is de iPhone Air uniek in zijn soort! En toch heeft iPhone Air een 6,5‑inch display en de kracht van de A19 Pro-chip, dezelfde chip als de iPhone 17 Pro (Max) Nieuw camera systeem: 18MP Center Stage-camer a aan de voorkant. Die je altijd in de voorgrond zet van jouw selfie en zelf switcht tussen verticaal en horizontaal beeld. 48-MP Fusion Hoofdcamera , die functioneert als 2 camera's en 4 lenzen in een. Daarnaast heeft hij 2x een Telelens voor de perfecte zoom. Verder heeft de Air Dolby Vision in 4K met 60 bps Pro Chip: Dankzij de kracht van de nieuwste generatie Apple silicon en de efficiëntie van de A19 Pro-chip draaien geavanceerde features als Apple Intelligence en intensieve games beter dan ooit. A19 Pro bevat de snelste CPU in welke smart­phone dan ook en heeft onze meest geavanceerde GPU tot nu toe. De CPU alleen al is tot 40 procent sneller dan de chip in iPhone 14 Pro. En dankzij C1X, de nieuwe versie van de door Apple ontworpen modem, is iPhone Air de meest energie­zuinige iPhone ooit gemaakt. Batterij & eSim: De Air is ontworpen voor een zo groot mogelijk batterij, daarom is het simkaart slot eruit gehaald en werkt de Air alleen op eSim. Daardoor kan hij tot 27 uur video afspelen . Ook geeft de nieuwe iPhone 17 een snellere en veiligere verbinding, via wifi 7, Bluetooth 6 en 5G. En maakt de Air gebruik van de nieuwste versie van IOS, IOS 26! Met de nieuwste functies en verbeteringen.",  "return_days": 30,  "availability": "in_stock",  "review_count": 15,  "weight_grams": 307,  "price_display": "895,00 €",  "rating_counts": {    "1": 0,    "2": 0,    "3": 0,    "4": 0,    "5": 15  },  "seller_rating": 8.7,  "shipping_cost": 0,  "rating_display": "5,0",  "specifications": [    {      "name": "Merk",      "group": "Productinformatie",      "value": "Apple"    },    {      "name": "Model",      "group": "Productinformatie",      "value": "Apple iPhone Air"    },    {      "name": "MPN (Manufacturer Part Number)",      "group": "Productinformatie",      "value": "iPhone Air - 256GB - Space Black"    },    {      "name": "EAN",      "group": "Productinformatie",      "value": "0195950622669"    },    {      "name": "Kleur",      "group": "Kenmerken",      "value": "Zwart"    },    {      "name": "Verpakkingsgewicht",      "group": "Kenmerken",      "value": "307 g"    }  ],  "product_group_id": "9300000219087270",  "list_price_display": "1.199,00 €",  "seller_rating_scale": 10,  "shipping_cost_display": "0,00 €"}