Bol Search
Search bol.com by keyword. Region is nl, be-nl, or be-fr. Page the product cards. Sponsored ads can repeat across pages.
Credit cost: 2 credits per call
ApiKeyAuthx-api-key<token>Your API key. Include it in the x-api-key header for every request.
query*stringKeyword or full bol.com search URL. A product URL is rejected.
Examples:
legohttps://www.bol.com/nl/nl/s/?searchtext=legoregion?stringShop. 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 /nl/nl/, /be/nl/, or /be/fr/.
page?numberPage number, starting at 1. Page 2 asks bol for the next screen of the same search.
1 <= value <= 500return_page_source?booleanWhen true, return the raw HTML as {"result": "..."}.
fields?stringComma-separated list of response fields to return, with dot notation for nested fields (e.g. name,location.city).
is_async?booleanRun the request as a background job: the API answers 202 with a job_id to poll on GET /v1/jobs/{id}.
falsesoft_fail?booleanReturn HTTP 200 even when the request fails; the error is in the error field of the body.
falseSuccessful response
application/json- response
results?array<>pagination?curl -X GET 'https://api.piloterr.com/v2/bol/search?query=string'{ "results": [ { "url": "https://www.bol.com/nl/nl/p/lego-icons-rozenboeket-10328/9300000157956429/", "brand": "LEGO", "price": 47.99, "title": "LEGO Botanicals Rozenboeket Decoratief Bloemen Bouwpakket uit de Botanical Collection 10328", "locale": "nl-NL", "rating": 4.8, "region": "nl", "seller": "bol", "brand_id": "4648554", "currency": "EUR", "delivery": "Voor 23:59 uur besteld, morgen in huis", "offer_id": "6cc9ba23-4459-4455-b1f0-dbb512814ec3", "brand_url": "https://www.bol.com/nl/nl/pb/lego/4648554/", "image_alt": "LEGO Botanical Collection Rozenboeket verpakking, met afbeelding van twaalf rode rozen.", "image_url": "https://media.s-bol.com/8Q2W6R9wqArl/BNlmq0Q/550x839.jpg", "sponsored": false, "bol_select": true, "highlights": [ "822 onderdelen", "Geen minifiguren", "2024" ], "list_price": 59.99, "product_id": "9300000157956429", "description": "LEGO Botanicals Rozenboeket. Type product: Bouwpakket, Aanbevolen leeftijd (min): 18 jaar, Materiaal:...", "availability": "in_stock", "review_count": 154, "price_display": "47,99 €", "rating_display": "4,8/5", "list_price_display": "59,99 €" } ], "pagination": { "next": "https://www.bol.com/nl/nl/s/?searchtext=lego&page=2", "page": 1, "per_page": 29, "total_pages": null, "total_results": 11622 }}