furniture.com APIwww.furniture.com ↗
Search Furniture.com's product catalog by keyword, filter by color, style, brand, and material. Returns prices, ratings, availability, and seller data.
curl -X GET 'https://api.parse.bot/scraper/0b207cbb-fa29-4388-9b77-611c0e4fdd46/search_products?page=2&limit=5&query=sofa' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for furniture products by keyword with optional filters, sorting, and pagination. Returns product details including title, price, images, seller, specifications, and availability.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination. |
| type | string | Filter by furniture type (e.g. 'Sofa', 'Stationary', 'Platform', 'Upholstered'). |
| brand | string | Filter by brand (e.g. 'BenchMade Modern', 'Four Hands'). |
| color | string | Filter by color (e.g. 'Brown', 'Beige & Cream', 'Gray', 'Blue'). |
| limit | integer | Number of results per page (max 50). |
| query | string | Search keyword (e.g. 'sofa', 'dining table', 'bed'). |
| style | string | Filter by style (e.g. 'Modern', 'Contemporary', 'Traditional', 'Mid-Century Modern'). |
| seller | string | Filter by seller (e.g. 'Lulu and Georgia', 'Bloomingdale\'s'). |
| on_sale | string | Filter to on-sale items only. Pass 'true' to activate. |
| sort_by | string | Sort order. Accepted values: RECOMMENDED, PRICE_LOW_TO_HIGH, PRICE_HIGH_TO_LOW, HIGHEST_RATED. |
| material | string | Filter by material (e.g. 'Fabric', 'Leather', 'Wood', 'Velvet', 'Polyester'). |
| zip_code | string | 5-digit US ZIP code for availability filtering. |
| max_price | number | Maximum price filter. |
| min_price | number | Minimum price filter. |
{
"type": "object",
"fields": {
"page": "current page number",
"count": "number of products returned on this page",
"limit": "results per page limit used",
"query": "search keyword used",
"products": "array of product objects with id, title, slug, url, brand, seller, price, sale_price, in_stock, average_rating, total_ratings, description, images, specifications, variations, availability, and partner"
},
"sample": {
"data": {
"page": 1,
"count": 5,
"limit": 5,
"query": "sofa",
"products": [
{
"id": "MIN_B2096EBB76F646FF8528841940EE833C",
"url": "https://www.furniture.com/shop/alba-alba-001-32-h-x-93-w-x-42-d-sofa-mine-min-b2096ebb76f646ff8528841940ee833c",
"slug": "alba-alba-001-32-h-x-93-w-x-42-d-sofa-mine-min-b2096ebb76f646ff8528841940ee833c",
"brand": null,
"price": 4189,
"title": "Alba ALBA-001 32\"H x 93\"W x 42\"D Sofa",
"images": [
{
"fit": "COVER",
"url": "https://assets.furniture.com/images/MIN_B2096EBB76F646FF8528841940EE833C/primary_image/5935b2ed952b4cede0ba9191334d753fa4ced6cf2e631638c782e9b43f548bae/",
"type": "Lifestyle",
"aspect_ratio": 1.25
}
],
"seller": "MINE",
"partner": {
"code": "MIN",
"name": "MINE"
},
"in_stock": "Ready to ship",
"sale_price": 4189,
"variations": null,
"description": null,
"availability": [
{
"badges": [],
"in_stock": "Ready to ship",
"list_price": null,
"sale_price": 4189
}
],
"total_ratings": null,
"average_rating": null,
"specifications": {
"Material": "Polyester"
}
}
]
},
"status": "success"
}
}About the furniture.com API
The Furniture.com API provides 2 endpoints for searching and filtering the Furniture.com product catalog, returning up to 50 products per request with fields covering title, price, sale price, brand, seller, average rating, total ratings, stock status, and slug. The search_products endpoint accepts keyword queries alongside facet filters for color, style, type, and brand, while get_filters exposes available filter groups with per-option product counts for a given query.
Endpoints and Core Data
The search_products endpoint accepts a query string and returns an array of product objects. Each product includes id, title, slug, url, brand, seller, price, sale_price, in_stock, average_rating, and total_ratings. Results are paginated via the page and limit parameters, with a maximum of 50 results per page. The response also echoes back the page, count, limit, and query values so you can build pagination logic without tracking state externally.
Filtering and Facets
Both endpoints support facet filtering. On search_products you can pass color (e.g. Brown, Gray), style (e.g. Modern, Mid-Century Modern), type (e.g. Sofa, Platform), brand (e.g. Four Hands), and seller (e.g. Lulu and Georgia) as discrete filter parameters. The get_filters endpoint takes the same query string and returns all available filter groups — each with a name, display_name, and an options array of value, label, and count — so you can populate a dynamic filter UI or determine which facet values are valid before issuing a filtered search_products call.
Coverage and Availability Context
get_filters accepts an optional zip_code parameter (5-digit US ZIP) which provides availability context in the response. The endpoint returns total_products for the query, giving you a count of all matching items before paginating. This is useful for estimating how many pages a full traversal requires when limit is set to its maximum of 50.
- Build a furniture price comparison tool using
priceandsale_pricefields across multiple brands and sellers - Populate a dynamic filter sidebar using
get_filtersoption counts before rendering search results - Track in-stock status changes for specific furniture types with repeated
search_productscalls filtered bytype - Aggregate average ratings and total ratings across a style category to identify top-rated contemporary or mid-century pieces
- Feed a recommendation engine with brand and seller metadata to surface seller-specific assortments
- Monitor sale prices on a specific brand's catalog by combining the
brandfilter withsale_pricefield tracking - Build a ZIP-code-aware availability checker using the
zip_codeparameter onget_filters
| 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 Furniture.com have an official developer API?+
What does `search_products` return beyond basic title and price?+
id, title, slug, url, brand, seller, price, sale_price, in_stock, average_rating, and total_ratings. You can combine keyword search via query with up to five facet filters — color, style, type, brand, and seller — in a single request.Can I retrieve individual product detail pages, dimensions, or customer review text?+
How does pagination work, and is there a hard cap on results per call?+
page and limit parameters on search_products. The limit maximum is 50 items per page. The get_filters endpoint returns total_products for a given query, which you can divide by your chosen limit to determine the total page count for a full traversal.Does the API support sorting results by price or ratings?+
average_rating and price fields are present in each product object, so client-side sorting on retrieved results is straightforward. You can fork the API on Parse and revise it to expose a dedicated sort parameter if server-side ordering is required.