gamma.be APIgamma.be ↗
Access Gamma.be product data via API: search listings with prices, retrieve detailed specs, browse the full category tree, and get autocomplete suggestions.
curl -X GET 'https://api.parse.bot/scraper/ef576313-3d76-42a4-95f2-6f9790ea6378/search_products?page=1&limit=3&query=verf&include_prices=true' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for products on gamma.be. Returns paginated product listings with metadata including prices, dimensions, materials, reviews, stock info, and variants.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number (1-indexed) |
| limit | integer | Results per page (max 50) |
| query | string | Search query for products |
| include_prices | string | Whether to fetch prices. Accepted values: 'true', 'false'. Set to 'false' for faster results. |
{
"type": "object",
"fields": {
"query": "search query used",
"products": "array of product objects with product_id, name, brand, price, dimensions, reviews, stock, variants, etc.",
"total_pages": "total number of pages available",
"current_page": "current page number (1-indexed)",
"total_results": "total number of matching products",
"results_per_page": "number of results requested per page"
},
"sample": {
"data": {
"query": "houten palen",
"products": [
{
"ean": "8711615190612",
"url": "https://www.gamma.be/nl/assortiment/tuinpaal-rond-groen-geimpregneerd-grenenhout-geschaafd-4x200-cm/p/B354780",
"name": "Tuinpaal rond groen geïmpregneerd grenenhout geschaafd Ø 4x200 cm",
"type": [
"Tuinpaal"
],
"brand": "Geen merk",
"depth": "200.0cm",
"price": 5.19,
"width": "40mm",
"finish": "Geschaafd",
"height": "40mm",
"in_stock": true,
"material": "Hout",
"variants": [],
"head_size": null,
"image_url": "https://static.gamma.be/dam/778207/22",
"object_id": "B354780",
"old_price": 6.49,
"promotion": "20% korting",
"wood_type": "Grenen",
"categories": [
"Tuin"
],
"eco_cheque": true,
"product_id": "354780",
"star_rating": 1,
"color_family": "Groen,Hout",
"delivery_cost": 69.95,
"dimensions_mm": {
"width": 40,
"height": 40,
"length": 2000
},
"total_reviews": 1,
"stock_quantity": 372,
"wood_treatment": "Geïmpregneerd",
"promotion_end_date": "Aanbieding t/m 14-06-2026",
"purchasable_online": true
}
],
"total_pages": 49,
"current_page": 1,
"total_results": 147,
"results_per_page": 3
},
"status": "success"
}
}About the gamma.be API
The Gamma.be API provides 4 endpoints for accessing product and category data from Belgium's Gamma home improvement store. Use search_products to query the catalog and receive paginated results with prices, dimensions, brand, stock status, and variant data. get_product_details returns the full record for a single product including description, multiple images, delivery info, and store availability count.
Endpoints and Response Fields
The search_products endpoint accepts a query string and returns an array of product objects containing product_id, name, brand, price, dimensions, reviews, stock, and variants. Pagination is controlled with page (1-indexed) and limit (max 50). The response also includes total_results, total_pages, and results_per_page for cursor management. Setting include_prices to 'false' skips price resolution, which reduces response latency when price data is not needed.
Product Details and Variants
get_product_details takes a product_id (the B prefix is stripped automatically) and returns the full product record: name, brand, price, old_price, promotion label, description, images array, url_fr (French-language page URL), and a variants array. Each variant object includes its own product_id, feature, value, and url, making it straightforward to enumerate size, color, or configuration options for a given item.
Category Tree and Autocomplete
get_categories returns the complete category hierarchy as a nested structure. Each node carries name, categoryUrl, uid, and a subCategories array that recurses to arbitrary depth, covering the full taxonomy from top-level departments down to leaf categories. The search_suggestions endpoint accepts a partial query and an optional limit, returning suggestion objects with query, nb_hits, and popularity scores — useful for building search interfaces or understanding query volume distribution across the catalog.
- Monitoring price changes on Gamma.be products by polling
search_productsorget_product_detailsfor updatedpriceandold_pricefields. - Building a home improvement product comparison tool using brand, dimensions, and variant data from
get_product_details. - Mapping the Gamma.be category hierarchy for SEO or navigation purposes using the nested
subCategoriestree fromget_categories. - Powering autocomplete in a third-party search UI using
nb_hitsandpopularityscores fromsearch_suggestions. - Tracking promotional activity across the catalog by extracting
promotionlabel text andold_pricefrom product records. - Syncing Gamma.be stock and delivery information into an internal procurement or inventory system using
stockand delivery fields.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Gamma.be have an official public developer API?+
What does `search_products` return that `get_product_details` does not?+
search_products returns paginated batch results with total_results and total_pages metadata, suited for browsing or bulk collection. get_product_details returns fields not available in search results — specifically description, the full images array, url_fr, store availability count, and delivery information — for a single product identified by product_id.Does the API cover Gamma.nl (Netherlands) as well as Gamma.be?+
Are customer review details such as review text or individual ratings returned?+
reviews field on product objects from search_products, but full review text and per-reviewer breakdowns are not currently included in the exposed fields. The API covers aggregate review metadata. You can fork it on Parse and revise to add an endpoint that returns individual review content.What is the maximum number of results returnable per search request?+
limit parameter on search_products accepts a maximum of 50 results per page. For larger result sets, use the total_pages value in the response to iterate through subsequent pages with the page parameter.