matterhackers.com APImatterhackers.com ↗
Search MatterHackers products, browse filament collections by material, and retrieve detailed specs, pricing, variants, and availability via 4 REST endpoints.
curl -X GET 'https://api.parse.bot/scraper/46d2312a-fa20-4dce-8857-b8742488ee7d/search_products?query=Bambu+Lab' \ -H 'X-API-Key: $PARSE_API_KEY'
Search across all MatterHackers store products by keyword. Returns products matching the query from the site-wide search. Supports multi-word queries.
| Param | Type | Description |
|---|---|---|
| queryrequired | string | Search keyword or phrase (e.g. 'PLA', 'Bambu Lab', 'resin'). |
{
"type": "object",
"fields": {
"query": "string — the search query echoed back",
"products": "array of product objects with title, brand, price, url, sku_id, and tags"
},
"sample": {
"data": {
"query": "PLA",
"products": [
{
"url": "https://www.matterhackers.com/store/l/black-mh-build-series-pla-filament-175mm-3kg/sk/MPTXV94Y",
"tags": [
"1.75mm",
"PLA",
"Black",
"MH Build",
"Spools",
"3kg",
"Bulk Materials"
],
"brand": "MatterHackers",
"price": 65.99,
"title": "Black MH Build Series PLA Filament - 1.75mm (3kg)",
"sku_id": "MPTXV94Y"
}
]
},
"status": "success"
}
}About the matterhackers.com API
The MatterHackers API provides 4 endpoints for querying the MatterHackers 3D printing store catalog, covering product search, filament listings, material collections, and full product detail pages. The get_product_details endpoint returns price, availability, color variants with swatch URLs, technical specifications, and parsed color metadata including hex codes and Pantone references — all keyed by SKU ID obtained from search or listing results.
Product Search and Filament Browsing
The search_products endpoint accepts any keyword or phrase — such as 'PLA', 'Bambu Lab', or 'resin' — and returns matching products with title, brand, price, url, sku_id, and tags. Multi-word queries are supported. The list_filaments endpoint narrows scope to filament products specifically and accepts an optional material parameter (e.g. 'ABS', 'NylonX', 'mh-build-series') that maps to a collection slug, plus a page integer for pagination through large result sets.
Material Collections and Navigation
The list_material_collections endpoint takes no inputs and returns the full list of collection objects, each with a name and url. The collection slugs it surfaces can be passed directly as the material parameter to list_filaments, making it straightforward to enumerate available categories before querying them. This is the right starting point for any workflow that needs to map MatterHackers' taxonomy before drilling into individual materials.
Product Detail and Variant Data
get_product_details accepts a sku_id (sourced from search_products or list_filaments results) and returns the richest response in the API: price in USD, availability status ('In Stock' or 'Out of Stock'), a specs object of key-value technical specifications, a description_preview of up to 500 characters, and a variants array listing each color option's color, sku_id, and swatch_url. The color_metadata field provides detected_hex_codes and detected_pantone_references arrays parsed from the product's color information.
- Build a filament comparison tool that pulls specs and pricing for PLA, ABS, and PETG variants using list_filaments and get_product_details
- Monitor in-stock status for specific filament SKUs to trigger purchase alerts when availability changes
- Aggregate swatch_url and detected_hex_codes data to build a visual filament color catalog
- Enumerate all material collections via list_material_collections to populate a dynamic filter UI for a 3D printing materials database
- Extract technical specification key-value pairs from get_product_details to feed a materials recommendation engine
- Track price changes across filament products by polling search_products results over time
- Discover brand-specific product lines by querying search_products with a brand name like 'Bambu Lab' or 'Polymaker'
| 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 MatterHackers offer an official developer API?+
How do I filter filaments by material type, and what slugs are valid?+
material parameter to list_filaments using a collection slug such as 'PLA', 'ABS', 'PET', or 'NylonX'. To get the full current list of valid slugs, call list_material_collections first — it returns every collection's name and url, and the slug portion of the URL corresponds to what list_filaments accepts.Does get_product_details return customer reviews or ratings?+
How do variants work — does each color have its own SKU ID?+
variants array in get_product_details lists each color option as a separate object with its own sku_id, color name, and swatch_url. To get full specs for a specific color, pass that variant's sku_id back into get_product_details.Does the API cover non-filament products like printers, resins, or accessories?+
search_products endpoint searches across all store products and will return printers, resins, and accessories if they match the query. However, list_filaments and list_material_collections are scoped to filament and material collections only. Dedicated listing endpoints for printers or accessories are not currently included. You can fork the API on Parse and revise it to add collection browsing for those product categories.