containerstore.com APIwww.containerstore.com ↗
Search The Container Store's product catalog by keyword. Get product names, prices, brands, images, and autocomplete suggestions via 2 JSON endpoints.
curl -X GET 'https://api.parse.bot/scraper/5af121a6-2787-4abb-9063-b692ead7ed37/search_products?page=1&rows=5&sort=sale_price+asc&query=bins' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for products by keyword with pagination and sorting support. Returns product details including name, brand, price, images, and descriptions.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number (1-based). |
| rows | integer | Number of results per page. |
| sort | string | Sort order. Accepted values: 'sale_price asc', 'sale_price desc', 'best_seller desc'. Omitting returns default relevance order. |
| queryrequired | string | Search keyword (e.g. 'bins', 'kitchen organizer', 'closet'). |
{
"type": "object",
"fields": {
"page": "integer, current page number",
"query": "string, the search keyword used",
"facets": "object with filter categories and their value counts",
"products": "array of product objects with pid, title, brand, price, sale_price, url, image, description",
"total_pages": "integer, total number of pages",
"rows_per_page": "integer, number of results per page",
"total_results": "integer, total number of matching products"
},
"sample": {
"data": {
"page": 1,
"query": "bins",
"facets": {},
"products": [
{
"pid": "11019017",
"url": "https://www.containerstore.com/s/storage/plastic-bins-baskets/plastic-storage-bins-with-handles/12d?productId=11019017",
"brand": "The Container Store",
"image": "https://images.containerstore.com/catalogimages/572148/10071294g-plastic-storage-bin-with-h.jpg?width=312&height=312",
"price": 95.88,
"title": "Plastic Storage Bins with Handles",
"sale_price": 95.88,
"description": "<b>Simple. Affordable. And perfect for storing all kinds of things around your home.</b>..."
}
],
"total_pages": 174,
"rows_per_page": 5,
"total_results": 869
},
"status": "success"
}
}About the containerstore.com API
The Container Store API provides 2 endpoints for searching and browsing The Container Store's product catalog. The search_products endpoint returns up to 9 fields per product — including pid, title, brand, price, sale_price, image, url, and description — along with facets and pagination metadata. A companion suggest endpoint returns query completions and matching product previews for a given search prefix.
Search Products
The search_products endpoint accepts a required query string (e.g. 'bins', 'closet organizer') and returns a paginated list of matching products. Each product object includes pid, title, brand, price, sale_price, image, url, and description. Results can be sorted by sale_price asc, sale_price desc, or best_seller desc via the sort parameter. The response also includes a facets object containing filter categories and their value counts, which can be used to understand how results break down by attribute.
Autocomplete Suggestions
The suggest endpoint takes a query prefix and returns two arrays: query_suggestions (each with query and display_text) and product_suggestions (each with pid, title, sale_price, image, and url). This is useful for building search-as-you-type experiences or pre-fetching candidate product sets before a full search is triggered.
Pagination and Sorting
search_products supports page (1-based integer) and rows (results per page) parameters alongside the sort option. The response includes total_pages, total_results, and rows_per_page fields so consumers can iterate through the full result set programmatically. Omitting sort returns results in the site's default ranking order.
- Build a price-tracking tool that monitors
sale_pricechanges for specific storage product categories over time. - Power a search autocomplete widget using
query_suggestionsandproduct_suggestionsfrom thesuggestendpoint. - Aggregate product catalogs across multiple retailers and compare Container Store items by
brandandprice. - Filter and sort storage products by
sale_price ascto identify the lowest-cost options in a given category. - Analyze
facetsdata fromsearch_productsto understand how a category (e.g. 'closet') breaks down by attribute. - Generate curated product lists ranked by
best_seller descfor content or affiliate marketing use cases.
| 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 The Container Store have an official public developer API?+
What does the `facets` field in `search_products` contain?+
facets object returns filter categories relevant to the search query along with value counts for each option. For example, a search for 'bins' might return facets grouping results by material or size, each with a count of matching products. Facets are included in every search_products response and vary by query.Does the API return product reviews or ratings?+
search_products and suggest endpoints cover product identifiers, titles, brands, prices, images, descriptions, and facets. Review scores and review text are not included in the response. You can fork this API on Parse and revise it to add a product reviews endpoint.Can I retrieve a product's full detail page — dimensions, color variants, or stock status?+
pid, title, brand, price, sale_price, image, url, and description. Detailed attributes like dimensions, color variants, and inventory availability are not exposed. You can fork this API on Parse and revise it to add a product detail endpoint covering those fields.How does pagination work in `search_products`?+
page parameter. The response includes total_pages, total_results, and rows_per_page so you can calculate the full result range. The rows parameter controls how many products are returned per page.