cultbeauty.co.uk APIcultbeauty.co.uk ↗
Access Cult Beauty product listings, ingredients, customer reviews, brand directories, new arrivals, and sale items via a structured REST API.
curl -X GET 'https://api.parse.bot/scraper/8544425d-fdf5-4620-bd73-9b4fa05a9c08/search_products?page=1&query=vitamin+c+serum' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for products by keyword on Cult Beauty. Supports pagination. Multi-word queries are handled via a GraphQL fallback when the HTML search page redirects.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number to retrieve. |
| queryrequired | string | Search query string (e.g. 'elemis', 'vitamin c serum'). |
{
"type": "object",
"fields": {
"data": "array of product objects with title, sku, brand, price, images, reviews, variants, and content",
"status": "string indicating success"
},
"sample": {
"data": [
{
"sku": 17738286,
"url": "/p/elemis-pro-collagen-body-cleansing-balm-75ml/17738286/",
"brand": {
"name": "Elemis",
"page": {
"path": "/brands/elemis"
},
"imageUrl": "https://static.thcdn.com/design-assets/images/logos/shared-brands/colour/elemis.gif"
},
"title": "Elemis Pro-Collagen Body Cleansing Balm 75ml",
"images": [
{
"altText": null,
"original": "https://static.thcdn.com/productimg/original/17738286-6135326458866979.jpg"
}
],
"reviews": {
"total": 0,
"maxScore": 5,
"averageScore": 0
},
"cheapestVariant": {
"sku": 17738286,
"price": {
"rrp": {
"amount": "24.0",
"currency": "GBP",
"displayValue": "£24.00"
},
"price": {
"amount": "24.0",
"currency": "GBP",
"displayValue": "£24.00"
}
},
"inStock": true
}
}
],
"status": "success"
}
}About the cultbeauty.co.uk API
The Cult Beauty API covers 8 endpoints for searching and browsing cultbeauty.co.uk, returning product titles, SKUs, pricing, ingredient lists, variants, and Bazaarvoice customer reviews. get_product_details delivers the most granular data — including ingredients, synopsis, and loyalty-point values — while get_product_reviews exposes paginated review text, ratings, and author metadata for any product ID.
Product Search and Category Browsing
search_products accepts a query string and an optional page integer, returning arrays of product objects that include title, sku, brand, price, images, reviews, variants, and content. The same product object shape is returned by get_category_products (scoped by category_path, e.g. /c/skin-care/moisturisers/) and get_brand_products (scoped by brand_slug from the get_brand_list endpoint). All three support page-based pagination so you can iterate through large result sets.
Full Product Details and Ingredients
get_product_details takes a full Cult Beauty product URL and returns a richer object that adds content fields — including ingredients, synopsis, and whyChoose — alongside recommendations and complete variants. This makes it the right endpoint when you need formulation data or want to present a product detail page rather than a catalog grid.
Customer Reviews via Bazaarvoice
get_product_reviews wraps Cult Beauty's Bazaarvoice review layer. It requires a product_id (the internal SKU, obtainable from search_products or get_product_details) and accepts limit and offset integers for pagination. The response is the full Bazaarvoice Results array — each item carries review text, star rating, author info, and syndication metadata — plus TotalResults and an Includes block with related product data.
Brand Directory, New Arrivals, and Sale
get_brand_list returns every brand on Cult Beauty with its name, slug, and url — the slug value feeds directly into get_brand_products. get_new_arrivals and get_sale_products each accept an optional page parameter and return the same paginated product object array, letting you track what Cult Beauty is currently promoting or discounting without constructing category paths manually.
- Build a beauty product comparison tool that aggregates ingredients lists from
get_product_detailsacross competing SKUs. - Monitor Cult Beauty sale pricing by polling
get_sale_productsand alerting when specific brands appear in the sale section. - Populate a brand discovery page using
get_brand_listslugs to drive paginated calls toget_brand_products. - Aggregate Bazaarvoice review text and ratings from
get_product_reviewsto feed a sentiment-analysis pipeline. - Track new product launches by paginating
get_new_arrivalsand diffing against a stored SKU list. - Index skincare product ingredients from
get_category_productsresults enriched withget_product_detailsfor a formulation search engine. - Sync Cult Beauty catalog data — titles, prices, images, and variants — into an affiliate or price-comparison database.
| 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 Cult Beauty have an official public developer API?+
What does `get_product_details` return that search and category endpoints do not?+
get_product_details adds content sub-fields — ingredients, synopsis, and whyChoose — along with a recommendations array. Search and category endpoints return the core product object (title, SKU, brand, price, images, reviews, variants) but omit those extended content fields.How does review pagination work in `get_product_reviews`?+
limit to control how many reviews are returned per call and an integer offset to advance through the result set. The response includes TotalResults so you can calculate how many additional pages remain.Does the API expose wishlist data, account-specific loyalty point balances, or order history?+
Are there any limitations on multi-word search queries?+
search_products endpoint handles them differently from single-keyword searches when the Cult Beauty search page redirects rather than returning a standard listing page. The endpoint resolves this automatically and still returns the same product object array. Highly ambiguous or misspelled queries may return fewer results than expected.