Container Store APIcontainerstore.com ↗
Search The Container Store's product catalog by keyword. Get product names, prices, brands, images, and autocomplete suggestions via 2 JSON endpoints.
What is the Container Store 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.
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'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace containerstore-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
from parse_apis.the_container_store_search_api import ContainerStore, Sort
store = ContainerStore()
# Search for products sorted by price ascending
for product in store.products.search(query="bins", sort=Sort.PRICE_ASC, limit=5):
print(product.title, product.sale_price, product.brand)
# Get autocomplete suggestions for a prefix
suggestion = store.suggestions.get(query="kitchen")
for qs in suggestion.query_suggestions:
print(qs.query, qs.display_text)
for ps in suggestion.product_suggestions:
print(ps.title, ps.sale_price)
Full-text search over The Container Store product catalog. Returns paginated results with product details (name, brand, price, images, description) and facet counts for filtering. Pagination via page number; sorting by price or best-seller rank. Each page returns up to `rows` products.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number (1-based). |
| rows | integer | Number of results per page. |
| sort | string | Sort order for results. |
| 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": "10029541",
"url": "https://www.containerstore.com/s/home-decor/decorative-bins-baskets/water-hyacinth-storage-bins-with-handles/12d?productId=10029541",
"brand": "The Container Store",
"image": "https://images.containerstore.com/catalogimages/479464/10085263-x-large-water-hyacinth-bin-.jpg?width=312&height=312",
"price": 119.94,
"title": "Water Hyacinth Storage Bins with Handles",
"sale_price": 119.94,
"description": "Handwoven from natural water hyacinth..."
}
],
"total_pages": 37,
"rows_per_page": 24,
"total_results": 869
},
"status": "success"
}
}About the Container Store API
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.
The Container Store API is a managed, monitored endpoint for containerstore.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when containerstore.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official containerstore.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- 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 | 100 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.