{"uid":"cap_Ts0yegUGU9s_8AF8BP0gO","slug":"bol-com-product-scraper-1ab988d7","name":"Bol.com Product Scraper","description":"Pay-per-call structured web data. Failed or empty runs are not charged.","url":"https://api.scrapeforagents.tech/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_HKKrGMKYD0YA8yFT1l39H","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":"Searches and extracts structured product data from bol.com, the largest Dutch-Belgian e-commerce marketplace, with filtering by price, rating, condition, and more","exampleAgentPrompt":"Search bol.com for 'LEGO Technic' sets, sort by price ascending, only show new condition items in stock priced between €20 and €100, fetch full product details including specs and reviews, and return up to 50 results.","exampleUseCases":[{"title":"Price comparison for consumer electronics","prompt":"Search bol.com for 'Sony WH-1000XM5 headphones', sort by price ascending, only new items in stock, and give me the top 20 results with full product details so I can compare prices and ratings."},{"title":"Finding discounted or secondhand items","prompt":"Look up bol.com for 'iPhone 14' but only show secondhand or refurbished condition listings, priced under €500, rated at least 4 out of 5, and return up to 30 results sorted by rating."},{"title":"Bulk product research from specific URLs","prompt":"Pull structured product data from these bol.com product URLs I have — fetch full details including EAN codes, specs, alternate offers, and up to 5 reviews per item."}],"resultDescription":"A JSON object containing a count of matched products and an array of product items, each with fields such as title, brand, price, currency, condition, productId, list_price, and discount_percentage. With fetchDetails enabled, each item also includes EAN, specifications, description, images, a sample of reviews, and alternate seller offers.","failureModes":["Empty result set if search terms match no products on bol.com (not charged)","Failed run if bol.com blocks the request or changes its structure (not charged)","maxPages capped at 10 by bol.com's public pagination limit","Price or rating filters may exclude all results if thresholds are too strict","URL mode fails if supplied URLs are invalid, private, or not bol.com product/search pages"],"whenToPreferThis":"Choose this endpoint when you need structured, machine-readable product data from bol.com specifically — the dominant e-commerce platform in the Netherlands and Belgium. It is ideal for price monitoring, product research, comparison shopping, or feeding a catalog in the Benelux market. It supports both keyword search and direct URL scraping with rich filtering. The pay-per-call model with no charge for failed or empty runs makes it low-risk for exploratory or automated workflows.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T03:54:45.837Z","isFirstParty":false,"canonicalSlug":"bol-com-product-scraper-1ab988d7"}