theshadestore.com APItheshadestore.com ↗
Access The Shade Store catalog via API: window treatment categories, product materials, collections, showroom locations, search, and current promotions.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/67b9e71d-1082-487c-bf6c-d9365fb9ddfd/get_main_categories' \ -H 'X-API-Key: $PARSE_API_KEY'
Get main window treatment categories (Shades, Blinds, Drapery). Returns a static list of top-level product categories with their URL paths.
No input parameters required.
{
"type": "object",
"fields": {
"categories": "array of category objects each containing name and url"
},
"sample": {
"data": {
"categories": [
{
"url": "/shades",
"name": "SHADES"
},
{
"url": "/blinds",
"name": "BLINDS"
},
{
"url": "/drapery",
"name": "DRAPERY"
}
]
},
"status": "success"
}
}About the theshadestore.com API
This API exposes 8 endpoints covering The Shade Store's full product hierarchy, showroom network, and active promotions. Starting with get_main_categories to retrieve top-level window treatment categories, you can drill into subcategories, pull detailed product pages with material and collection arrays, locate any of the brand's physical showrooms, run keyword searches, and fetch the current homepage promotion banner — all in structured JSON.
Product Catalog Navigation
The catalog endpoints form a three-level hierarchy. get_main_categories returns the top-level groupings (Shades, Blinds, Drapery) with their URL paths. Passing a category_slug — shades, blinds, or drapery — to get_subcategories yields a list of subcategory objects, each with a name and url. From there, get_subcategory_products accepts a subcategory_url (e.g. /shades/roller-shades) and returns an array of product objects containing name, link, and price_info, giving you enough to build a browsable product index.
Product Details
get_product_details takes a customization_url and returns the richest response in the API: a title string, a materials array where each entry carries name, price_group, collections, and code, and a flat collections array of name/code pairs. This is the right endpoint when you need to compare fabric options or map collection codes to display names for a configurator or product database.
Showrooms
get_all_showrooms returns every physical location as objects with name, url, state, and city. Feeding any showroom_url to get_showroom_detail resolves it into name, address, phone, hours, and an optional description string. These two endpoints together are sufficient to build a store-finder feature without additional geocoding calls.
Search and Promotions
search_products accepts a query string (e.g. blackout, roller) and returns an array of matching results, each with name and url, covering products, categories, and content pages found on the search results page. get_promotions requires no parameters and returns the current sitewide banner as an array of objects each containing a text field — useful for surfacing active sales in a price-comparison or deal-tracking workflow.
- Build a product configurator that maps material codes and collection names from get_product_details into a custom UI.
- Populate a store-finder widget using get_all_showrooms filtered by state and enriched with hours from get_showroom_detail.
- Monitor active promotions via get_promotions to trigger alerts when sitewide sale text changes.
- Index the full product catalog by walking get_main_categories → get_subcategories → get_subcategory_products for price tracking.
- Power a keyword search feature for window treatments using search_products results mapped to product landing pages.
- Aggregate price_info across subcategories to compare entry-level costs between Shades, Blinds, and Drapery product lines.
- Sync showroom contact data (address, phone, hours) into a CRM or internal directory using get_showroom_detail.
| 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.