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
Autorización
ApiKeyAuth x-api-key<token>
Your API key. Include it in the x-api-key header for every request.
In: header
Parámetros de consulta
query*string
Keyword or full bol.com search URL. A product URL is rejected.
Examples:
legohttps://www.bol.com/nl/nl/s/?searchtext=legoregion?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 /nl/nl/, /be/nl/, or /be/fr/.
page?number
Page number, starting at 1. Page 2 asks bol for the next screen of the same search.
Range
1 <= value <= 500return_page_source?boolean
When true, return the raw HTML as {"result": "..."}.
Cuerpo de la respuesta
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.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 }}{ "error": "Bad Request"}{ "error": "Invalid API Key"}{ "error": "Payment required"}{ "error": "Rate limit exceeded for the API key: quota monthly"}{ "error": "Internal Error"}