buybuy BABY APIbuybuybaby.com ↗
Access buybuy BABY product data via API: search by keyword, browse categories, and retrieve homepage featured items with prices, ratings, and reviews.
What is the buybuy BABY API?
The buybuy BABY API provides 3 endpoints for retrieving product data from buybuybaby.com, covering keyword search, category browsing, and homepage featured items. The search_products endpoint returns full product records including pricing, brand, SKU, shipping details, ratings, and Club O Rewards info. Each response includes structured pagination so you can walk through large result sets page by page.
curl -X GET 'https://api.parse.bot/scraper/d33dc853-1e76-46fb-b065-a1ac55e1f051/search_products?page=1&query=stroller' \ -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 buybuybaby-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.
"""Walkthrough: buybuy BABY SDK — search products, browse categories, discover featured items."""
from parse_apis.buybuy_baby_product_scraper_api import BuyBuyBaby, ProductsNotFound
client = BuyBuyBaby()
# Search for strollers — limit caps total items fetched across pages.
for product in client.products.search(query="stroller", limit=3):
print(product.name, product.pricing.current.price, product.reviews.rating)
# Drill into one search result for detailed field access.
product = client.products.search(query="baby shampoo", limit=1).first()
if product:
print(product.name, product.sku, product.urls.product_page)
print(f" Rewards: {product.club_o_rewards.rewards} ({product.club_o_rewards.percentage}%)")
# Browse a specific category by slug and taxonomy ID.
for item in client.products.by_category(category_slug="diapering/baby-wipes", t_id="85833", limit=3):
print(item.name, item.pricing.current.price, item.shipping.intra_country_shipping)
# Get homepage featured/recommended products.
featured = client.featuredproducts.list(limit=3).first()
if featured:
print(featured.name, featured.rating, featured.price_set[0].formatted_price)
# Typed error handling — catch not-found when a query yields no results.
try:
result = client.products.search(query="xyznonexistent99999", limit=1).first()
except ProductsNotFound as exc:
print(f"No products found for query: {exc.query}")
print("exercised: products.search / products.by_category / featuredproducts.list")Search for products by keyword on buybuy BABY. Returns a paginated list of products with names, prices, brands, images, ratings, and pagination info. Each page returns up to 60 products.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination |
| queryrequired | string | Search keyword (e.g., 'stroller', 'baby shampoo', 'diapers') |
{
"type": "object",
"fields": {
"products": "array of product objects with id, name, sku, pricing, reviews, urls, shipping, and clubORewards",
"pagination": "object with currentPage, previousPageLink, nextPageLink, and pages array",
"total_matches": "integer total number of matching products"
},
"sample": {
"data": {
"products": [
{
"id": 43137081,
"sku": "46248682",
"name": "Mompush Ultimate 2 Baby Stroller",
"urls": {
"image": "https://ak1.ostkcdn.com/images/products/is/images/direct/898e3f26edfd38beee0901705543db394ab72755/Mompush-Ultimate-2-Baby-Stroller.jpg",
"productPage": "https://buybuybaby.bedbathandbeyond.com/Baby/Mompush-Ultimate-2-Baby-Stroller/43137081/product.html"
},
"pricing": {
"base": {
"price": "$329.99"
},
"current": {
"type": "STANDARD",
"price": "$329.99 - $429.99",
"priceBreakdown": {
"price": 329.99,
"integerPart": 329,
"fractionalPart": 99
}
},
"hideMAPPrice": false,
"hasMultipleOptions": true,
"hasNonClubODiscount": false
},
"reviews": {
"url": "",
"count": 0,
"rating": "0.0"
},
"favorite": false,
"shipping": {
"fastDelivery": null,
"intraCountryShipping": true
},
"optionCount": 4,
"clubORewards": {
"points": "1650",
"rewards": "$16.50",
"percentage": 5
}
}
],
"pagination": {
"pages": [
{
"value": 1,
"active": true
}
],
"currentPage": 1,
"nextPageLink": "https://buybuybaby.bedbathandbeyond.com/stroller,/k,/results.html?page=2",
"previousPageLink": null
},
"total_matches": 285
},
"status": "success"
}
}About the buybuy BABY API
Endpoints and What They Return
The search_products endpoint accepts a required query string (e.g., 'stroller', 'baby shampoo') and an optional page integer. It returns a products array where each object includes id, name, sku, pricing fields, review data, product URLs, shipping eligibility, and clubORewards info. The response also includes a total_matches integer and a pagination object with currentPage, previousPageLink, nextPageLink, and a pages array for navigating multi-page results.
Category Browsing
The get_category_products endpoint lets you browse products scoped to a specific category. It requires two inputs: category_slug (e.g., 'diapering/baby-wipes') and t_id, the taxonomy ID for that category (e.g., '85833'). The response mirrors the search shape — products array, pagination, and total_matches — but adds a taxonomy_name field indicating the human-readable category label like 'Baby Wipes'. This is useful when you want to enumerate products within a known department rather than run a broad keyword query.
Homepage Featured Products
The get_home_featured endpoint takes no inputs and returns a curated list of products surfaced on the buybuy BABY homepage. Each item in the products array includes productId, name, productLink, thumbnailImage, rating, reviewCount, and priceSet. This endpoint reflects the site's current merchandising selections and is well-suited for trend tracking or populating a feed of highlighted baby products.
Data Shape Across Endpoints
All three endpoints expose pricing and review signals, but the fields vary slightly by endpoint. The search and category endpoints return richer product objects (sku, shipping, clubORewards) compared to the home featured endpoint, which focuses on display-ready fields like thumbnailImage and priceSet. Keep this in mind when normalizing data across endpoint sources.
The buybuy BABY API is a managed, monitored endpoint for buybuybaby.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when buybuybaby.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 buybuybaby.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?+
- Track price changes for specific baby product categories using
get_category_productswith a fixedt_id. - Build a baby registry comparison tool by querying
search_productsfor item names and extracting pricing and review data. - Monitor homepage merchandising trends over time using
get_home_featuredto log which products are featured daily. - Aggregate stroller or car seat listings with ratings and SKUs for a product research or affiliate site.
- Feed a price alert system by polling
search_productsfor specific keywords and watching the pricing fields. - Populate a category-level product catalog by walking pages of
get_category_productsresults with thepageparameter. - Compare
reviewCountandratingfields across brands returned in a keyword search to surface top-rated items.
| 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 buybuy BABY have an official developer API?+
What does the `get_category_products` endpoint require, and how does pagination work?+
category_slug (e.g., 'diapering/baby-wipes') and t_id (the taxonomy ID, e.g., '85833'). Pagination is handled via the optional page integer input. The response returns a pagination object with currentPage, previousPageLink, nextPageLink, and a pages array, so you can walk through all products in a category sequentially.Does the API return individual product detail pages, such as full descriptions or variant/size options?+
Is the `get_home_featured` endpoint useful for tracking what buybuy BABY is actively promoting?+
rating, reviewCount, priceSet, and productLink. Because it reflects the live site's merchandising selections, polling it over time shows how the featured assortment shifts — useful for competitive monitoring or trend analysis.Does the API cover seller or third-party marketplace listings on buybuy BABY?+
sku and pricing fields. There is no dedicated seller-level field or marketplace-seller breakdown in the current response shape. You can fork this API on Parse and revise it to surface seller attribution if that data appears on specific product pages.