{"uid":"cap_joaMa0nUv0Mvfej1b3agt","slug":"bol-com-product-scraper-x402-e35e9185","name":"Bol.com Product Scraper (x402)","description":"Pay-per-call structured web data. Failed or empty runs are not charged.","url":"https://x402.186-241-26-229.sslip.io/v1/bol?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"mode":{"enum":["search","url"],"type":"string","default":"search","description":"Choose keyword search or pasted bol.com URLs."},"urls":{"type":"array","default":[],"description":"Public product or search result URLs. Used in URL mode."},"sortBy":{"enum":["relevance","popularity","price_asc","price_desc","rating","newest"],"type":"string","default":"relevance","description":"Order search results by relevance, popularity, price, rating, or release date."},"maxItems":{"type":"integer","default":100,"minimum":0,"description":"Maximum products across all sources. Set 0 for no actor-side item cap."},"maxPages":{"type":"integer","default":10,"minimum":0,"description":"Maximum search pages per phrase, up to the public ten-page cap."},"maxPrice":{"type":"number","minimum":0,"description":"Keep products priced at or below this amount in EUR."},"minPrice":{"type":"number","minimum":0,"description":"Keep products priced at or above this amount in EUR."},"condition":{"enum":["any","new","secondhand","refurbished"],"type":"string","default":"any","description":"Keep products whose current best offer has this condition."},"minRating":{"type":"number","maximum":5,"minimum":0,"description":"Keep products with an average rating at or above this value."},"maxReviews":{"type":"integer","default":10,"minimum":0,"description":"Maximum reviews retained from the product page response per item."},"inStockOnly":{"type":"boolean","default":false,"description":"Keep only products with a current best offer."},"searchTerms":{"type":"array","default":[],"description":"Search phrases, one per entry. Used in search mode."},"fetchDetails":{"type":"boolean","default":false,"description":"Visit each product to add specifications, EAN, description, images, review sample, and alternate offers."},"sponsoredOnly":{"type":"boolean","default":false,"description":"Keep only marked sponsored results."}}},"responseSchema":{"type":"json","example":{"count":1,"items":[{"brand":null,"price":null,"title":null,"currency":null,"condition":null,"productId":null,"list_price":null,"discount_percentage":null}],"product":"bol"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.025","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.025/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.025","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.025","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_eZ8TbtgjuBrPBFFm_Hf4C","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.025","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Scrapes structured product listings and details from bol.com via keyword search or direct URL, returning prices, ratings, conditions, and metadata.","exampleAgentPrompt":"Search bol.com for 'noise cancelling headphones', sort by rating, keep only new condition items priced between €50 and €200, grab up to 20 products with full details including specs and reviews.","exampleUseCases":[{"title":"Price comparison for gift shopping","prompt":"Search bol.com for 'LEGO Technic' sets, filter to new condition only, priced under €80, sort by price ascending, and give me up to 30 results with their current prices and ratings."},{"title":"Competitor product research","prompt":"Scrape these bol.com product URLs for me and get full details — specs, EAN codes, descriptions, images, and any alternate seller offers: https://www.bol.com/nl/p/product1 and https://www.bol.com/nl/p/product2."},{"title":"Finding discounted in-stock items","prompt":"Search bol.com for 'robot vacuum cleaner', only show me in-stock items with at least a 4-star rating, sorted by popularity, and fetch full product details including the sample reviews for up to 15 results."}],"resultDescription":"Returns a JSON object with a count and an array of product items, each containing title, brand, price, currency, condition, product ID, list price, and discount percentage. When fetchDetails is enabled, also includes specifications, EAN, description, images, a review sample, and alternate seller offers.","failureModes":["Empty results if search terms match no products on bol.com","No charge on failed or empty runs","Price/rating filters may exclude all results if thresholds are too strict","URL mode fails if provided URLs are invalid or non-public bol.com product pages","maxPages capped at 10 due to bol.com public search limit","fetchDetails=true significantly increases latency and cost per item"],"whenToPreferThis":"Use this endpoint when you need structured product data specifically from bol.com (the dominant Dutch/Belgian e-commerce platform), especially for price comparison, product research, or building datasets of products sold in the Netherlands and Belgium. Prefer it over generic web scrapers because it returns clean structured fields (price, EAN, condition, rating) without parsing effort, and you are only charged for successful non-empty runs.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T03:38:29.889Z","isFirstParty":false,"canonicalSlug":"bol-com-product-scraper-x402-e35e9185"}