Brookstone APIbrookstone.com ↗
Search Brookstone's product catalog, retrieve detailed variant and pricing data, and get autocomplete suggestions via 3 structured API endpoints.
What is the Brookstone 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.
curl -X GET 'https://api.parse.bot/scraper/d79cfaea-3a75-416e-ae4c-5f5afd9a64d7/search_products?page=1&sort=relevance&limit=5&query=massage' \ -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 brookstone-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.
"""Brookstone product search: search, drill-down, and autocomplete suggestions."""
from parse_apis.brookstone_product_search_api import Brookstone, Sort, ProductNotFound
client = Brookstone()
# Search for products sorted by price, capped at 5 total items.
for product in client.productsummaries.search(query="heated blanket", sort=Sort.PRICE_ASCENDING, limit=5):
print(product.title, product.price_min, product.vendor)
# Drill into the first result for full details.
summary = client.productsummaries.search(query="massage", limit=1).first()
if summary:
detail = summary.details()
print(detail.title, detail.price_min_formatted, detail.available)
for variant in detail.variants[:3]:
print(variant.title, variant.price, variant.available)
# Fetch a product directly by handle.
try:
product = client.products.get(handle="brookstone-cozy-heated-plush-throw")
print(product.title, product.price_varies, len(product.images))
except ProductNotFound as exc:
print(f"Product not found: {exc.handle}")
# Autocomplete suggestions for a query.
for suggestion in client.suggestions.suggest(query="chair", limit=5):
print(suggestion.title, suggestion.price, suggestion.available)
print("exercised: productsummaries.search / summary.details / products.get / suggestions.suggest")
Full-text search over Brookstone's product catalog. Returns paginated product listings with pricing, variant summaries, options, and available filters for the result set. Pagination via page number; results ordered by the chosen sort. Each product exposes a handle suitable for get_product drill-down.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination |
| sort | string | Sort order for results |
| limit | integer | Number of products per page (1-48) |
| queryrequired | string | Search query text |
{
"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 summary objects with id, title, handle, vendor, product_type, available, price_min, price_max, compare_at_price_min, compare_at_price_max, featured_image, options, variants, categories, review_count, review_ratings, url",
"total_pages": "integer, total number of pages",
"total_products": "integer, total number of matching products"
},
"sample": {
"data": {
"page": 1,
"sort": "relevance",
"limit": 5,
"query": "massage",
"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": 31
}
]
}
],
"products": [
{
"id": 8153303548090,
"url": "https://www.brookstone.com/products/zyllion-rechargeable-shiatsu-back-and-neck-massager-pillow-with-heat-2-speed-levels-change-rotation-and-wired-connection-zma-34rb-by-zyllion",
"title": "Rechargeable Shiatsu Back and Neck Massager Pillow with Heat",
"handle": "zyllion-rechargeable-shiatsu-back-and-neck-massager-pillow-with-heat-2-speed-levels-change-rotation-and-wired-connection-zma-34rb-by-zyllion",
"vendor": "Zyllion",
"options": [
{
"name": "Color",
"values": [
"Black"
]
}
],
"variants": [
{
"id": 44932901699770,
"sku": "carro-67826989",
"price": "89.95",
"title": "Black",
"available": true,
"compare_at_price": null
}
],
"available": true,
"price_max": 89.95,
"price_min": 89.95,
"categories": [
"massage",
"neck_and_back"
],
"product_type": "",
"review_count": 0,
"featured_image": "https://cdn.shopify.com/s/files/1/0262/2226/4423/files/03_955708d1-0c0a-4f60-aa53-22abd802df8e.jpg?v=1765906659",
"review_ratings": 0,
"compare_at_price_max": null,
"compare_at_price_min": null
}
],
"total_pages": 18,
"total_products": 184
},
"status": "success"
}
}About the Brookstone API
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.
The Brookstone API is a managed, monitored endpoint for brookstone.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when brookstone.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 brookstone.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 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 | 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 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.