allmodern.com APIallmodern.com ↗
Search AllModern's catalog of modern furniture, lighting, and decor via API. Returns prices, ratings, reviews, images, and product URLs with pagination.
curl -X GET 'https://api.parse.bot/scraper/d58dcdc2-e789-49ff-aef9-0a8efd155b9a/search_products?page=2&query=lamp&sort_by=price_low' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for products by keyword on AllModern. Returns product listings with name, price, rating, reviews, images, and URLs. Results are paginated with 48 products per page.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination. |
| queryrequired | string | Search keyword (e.g. 'sofa', 'lamp', 'rug', 'desk') |
| sort_by | string | Sort order. Accepted values: 'price_low', 'price_high', 'top_rated', 'most_popular', 'newest'. Omitting returns default recommended order. |
{
"type": "object",
"fields": {
"page": "integer - current page number",
"query": "string - search keyword used",
"products": "array of product objects with keys: name, sku, url, image_url, sale_price, original_price, rating, review_count, badge, color_options",
"total_pages": "integer - total number of pages available",
"total_results": "integer or null - total number of matching products",
"products_count": "integer - number of products on this page"
},
"sample": {
"data": {
"page": 1,
"query": "sofa",
"products": [
{
"sku": "kkah1348",
"url": "https://www.allmodern.com/furniture/pdp/allmodern-wanetta-88-upholstered-sofa-with-solid-wood-leg-kkah1348.html",
"name": "Wanetta 88'' Upholstered Sofa With Solid Wood Leg",
"badge": "Sale",
"rating": 4.7,
"image_url": "https://assets.wfcdn.com/im/77486600/resize-h400-w400%5Ecompr-r85/4257/425700362/Wanetta+88%27%27+Upholstered+Sofa+With+Solid+Wood+Leg.jpg",
"sale_price": 1399,
"review_count": 170,
"color_options": "5 Colors",
"original_price": 1599
}
],
"total_pages": 6,
"total_results": 273,
"products_count": 48
},
"status": "success"
}
}About the allmodern.com API
The AllModern API exposes one endpoint — search_products — that returns up to 48 product listings per page from AllModern's catalog of modern furniture, lighting, and decor. Each response includes 10 fields per product: name, SKU, URL, image URL, sale price, original price, rating, review count, badge, and color options. The endpoint accepts keyword queries and supports five sort orders, making it straightforward to retrieve ranked or filtered product sets.
What the API Returns
The search_products endpoint accepts a required query string — such as 'sofa', 'desk', or 'pendant light' — and returns a paginated list of matching products from AllModern. Each product object includes name, sku, url, image_url, sale_price, original_price, rating, review_count, badge (such as sale or bestseller labels), and color_options. The response envelope also carries total_results, total_pages, products_count, and the page and query values used in the request.
Sorting and Pagination
Results are paginated at 48 products per page. The optional page parameter navigates between pages; total_pages tells you how many exist for a given query. The optional sort_by parameter accepts five values: price_low, price_high, top_rated, most_popular, and newest. Omitting sort_by returns the default relevance ordering. Combining sort_by=price_low with pagination lets you walk the full sorted catalog for any keyword.
Pricing and Review Data
Both sale_price and original_price are returned for each product, so you can compute discount amounts or filter to items currently on sale. rating and review_count are included at the product level, which is enough to sort or filter by social proof without making additional calls. total_results may occasionally be null depending on how AllModern surfaces that count for a given query.
- Build a price-comparison tool that tracks
sale_pricevsoriginal_priceover time for furniture categories - Aggregate
ratingandreview_countacross product listings to surface top-rated modern decor items - Power a shopping feed by iterating through all
total_pagesfor a given keyword query - Monitor
badgefields to detect when products receive sale or bestseller status - Build a catalog index of AllModern SKUs for downstream inventory or analytics workflows
- Filter and rank results by
sort_by=newestto track new product introductions in a specific category - Populate a curated furniture recommendation widget using product
image_urlandurlfields
| 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 AllModern have an official developer API?+
What does the `search_products` endpoint return for each product?+
name, sku, url, image_url, sale_price, original_price, rating, review_count, badge, and color_options. The response also includes pagination metadata: page, total_pages, total_results, and products_count.Can I retrieve product detail pages or individual product specs?+
Is `total_results` always populated?+
total_results field is typed as integer or null and may be null for certain queries depending on how AllModern surfaces that count. Use total_pages and products_count as reliable fallbacks for pagination logic.Does the API support filtering by category, price range, or brand?+
query and a sort_by sort order. Category filters, price range filters, and brand filters are not exposed as parameters. You can fork the API on Parse and revise it to add those filter parameters as separate inputs.