brookstone.com APIbrookstone.com ↗
Search Brookstone's product catalog, retrieve detailed variant and pricing data, and get autocomplete suggestions via 3 structured API endpoints.
curl -X GET 'https://api.parse.bot/scraper/d79cfaea-3a75-416e-ae4c-5f5afd9a64d7/search_products?page=2&sort=price-ascending&limit=3&query=blanket' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for products on Brookstone with full pagination, sorting, and filter support. Returns product listings with pricing, variants, images, and available filters.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination |
| sort | string | Sort order. Accepted values: relevance, best-selling, price-ascending, price-descending, title-ascending, title-descending, created-descending |
| limit | integer | Number of products per page (1-48) |
| queryrequired | string | Search query (e.g., 'massage', 'blanket', 'chair') |
{
"type": "object",
"fields": {
"page": "integer, current page number",
"sort": "string, sort order applied",
"limit": "integer, results per page",
"query": "string, the search query used",
"filters": "array of filter objects with type, label, id, and optional values",
"products": "array of product objects with id, title, handle, vendor, price_min, price_max, variants, options, categories, featured_image, url",
"total_pages": "integer, total number of pages",
"total_products": "integer, total number of matching products"
},
"sample": {
"data": {
"page": 1,
"sort": "relevance",
"limit": 3,
"query": "blanket",
"filters": [
{
"id": "pf_pt_product_type",
"type": "product_type",
"label": "Product Type"
},
{
"id": "pf_p_price",
"type": "price",
"label": "Price",
"values": [
{
"to": 50,
"key": "*-50",
"doc_count": 8
}
]
}
],
"products": [
{
"id": 8173894598842,
"url": "https://www.brookstone.com/products/electric-soft-microplush-heated-blanket-throw-62x84-inches-fast-heating-with-3-temperature-settings-by-pursonic",
"title": "Electric Soft Microplush Heated Blanket Throw",
"handle": "electric-soft-microplush-heated-blanket-throw-62x84-inches-fast-heating-with-3-temperature-settings-by-pursonic",
"vendor": "Pursonic",
"options": [
{
"name": "Title",
"values": [
"Default Title"
]
}
],
"variants": [
{
"id": 45008567140538,
"sku": "carro-68040448",
"price": "74.99",
"title": "Default Title",
"available": true,
"compare_at_price": null
}
],
"available": true,
"price_max": 74.99,
"price_min": 74.99,
"categories": [
"cold_&_heat_therapy",
"gifts",
"heated_blankets",
"heated_products",
"home",
"valentines",
"wellness"
],
"product_type": "",
"review_count": 0,
"featured_image": "https://cdn.shopify.com/s/files/1/0262/2226/4423/files/HBT62841.jpg?v=1753724923",
"review_ratings": 0,
"compare_at_price_max": null,
"compare_at_price_min": null
}
],
"total_pages": 1,
"total_products": 21
},
"status": "success"
}
}About the brookstone.com API
The Brookstone API gives developers access to Brookstone's product catalog through 3 endpoints covering full-text search, product detail retrieval, and autocomplete suggestions. The search_products endpoint returns paginated listings with up to 48 products per page, including pricing, variants, filter facets, and category data. Individual product records expose all variant SKUs, option sets, image arrays, and stock availability.
Search and Browse the Catalog
The search_products endpoint accepts a required query string plus optional parameters for page, limit (1–48), and sort. Supported sort values include relevance, best-selling, price-ascending, price-descending, title-ascending, and title-descending. Responses include total_products, total_pages, and a filters array of facet objects — each with a type, label, id, and optional nested values — so you can render filter UIs or narrow subsequent queries programmatically.
Product Detail
The get_product endpoint takes a handle (the URL-safe slug returned in search results) and returns a full product record. Fields include id, title, vendor, tags, available, images, options, and a variants array. Each variant carries its own id, title, sku, price, available flag, option values, and featured_image. This makes it straightforward to map out a product's full size/color/style matrix without additional requests.
Autocomplete Suggestions
The search_suggestions endpoint is optimized for search-as-you-type flows. It accepts a query and optional limit (1–10) and returns a lightweight product array with fields like price, compare_at_price, image, product_type, vendor, and available. The compare_at_price field indicates when a product is on sale relative to its regular price, which is useful for surfacing discounted items in suggestion dropdowns.
Data Scope
All three endpoints reflect current Brookstone catalog data including live pricing and stock status. Product listings include both price_min and price_max to represent price ranges across variants in search results, with per-variant pricing available in the detail endpoint.
- Build a Brookstone product comparison tool using variant-level SKU, price, and availability data from
get_product. - Power a deal-finder that surfaces discounted items by comparing
priceandcompare_at_pricefields fromsearch_suggestions. - Aggregate massage and wellness product pricing across retailers using
search_productswith theprice-ascendingsort. - Implement a faceted search UI by reading the
filtersarray returned bysearch_products. - Monitor stock availability for specific products by polling the
availablefield on variants viaget_product. - Populate an autocomplete widget by wiring
search_suggestionsto a keypress handler with a per-requestlimit. - Track catalog size and category breadth by paginating through
search_productsresults and readingcategoriesper product.
| 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 Brookstone have an official public developer API?+
What does the `filters` array in `search_products` actually contain?+
filters array includes a type, a human-readable label, an id, and an optional values array listing the discrete filter options for that facet (for example, color or size choices). These correspond to the filter controls visible on Brookstone's search results pages.Does the API return customer reviews or ratings for products?+
Is there a limit to how many products `search_products` can return per page?+
limit parameter accepts values between 1 and 48. For larger catalogs you paginate using the page parameter alongside the returned total_pages value. There is no single-request way to retrieve the full catalog in one call.