selfridges.com APIselfridges.com ↗
Access Selfridges fragrance data via API. Search by keyword, category, or brand. Returns fragrance notes, scent tags, pricing in GBP, and sizing details.
curl -X GET 'https://api.parse.bot/scraper/08ffc2e9-34df-4cc7-91a6-8dc653718f5a/search_fragrances?limit=2&query=Chanel+No+5' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for fragrance products by keyword on Selfridges. Returns a list of detailed product objects with fragrance notes, scent tags, pricing, and more. Each result requires fetching the individual product page, so response time scales with the limit parameter.
| Param | Type | Description |
|---|---|---|
| limit | integer | Maximum number of products to fetch details for. |
| queryrequired | string | Search query (e.g. 'Baccarat Rouge 540', 'Tom Ford', 'Chanel No 5'). |
{
"type": "object",
"fields": {
"data": "array of product objects, each containing id, brand_name, product_name, category, main_image_url, description, fragrance_notes, scent_tags, price_gbp, size, source_url, and timestamp"
},
"sample": {
"data": [
{
"id": "27760df8-a3af-49f9-8f90-c9ca8bff168d",
"size": "5 L",
"category": "body_oil",
"price_gbp": 258,
"timestamp": "2026-05-03T06:35:09.063332",
"brand_name": "CHANEL",
"scent_tags": [
"musky"
],
"source_url": "https://www.selfridges.com/GB/en/product/chanel-n5-eau-de-toilette-spray_130-73004626-105510/",
"description": "CHANEL N°5 eau de toilette spray...",
"product_name": "N°5 Eau de Toilette Spray",
"main_image_url": "https://images.selfridges.com/is/image/selfridges/130-73004626-105510_M",
"fragrance_notes": {
"top": [],
"base": [],
"heart": []
}
}
],
"status": "success"
}
}About the selfridges.com API
The Selfridges Fragrance API covers 4 endpoints for retrieving fragrance product data from Selfridges.com, including fragrance notes, scent tags, GBP pricing, and brand details. The search_fragrances endpoint accepts a keyword query — such as 'Baccarat Rouge 540' or 'Tom Ford' — and returns an array of product objects. Each object carries fields like fragrance_notes, scent_tags, brand_name, description, main_image_url, and price_gbp.
Endpoints and What They Return
All four endpoints return product objects sharing a common field set: id, brand_name, product_name, category, main_image_url, description, fragrance_notes, scent_tags, price_gbp, and sizing data. search_fragrances takes a required query string and an optional limit integer — results scale in response time with limit, since each match resolves full product details. list_fragrances_by_category accepts a category slug such as beauty/fragrance/womens-perfume or beauty/fragrance/mens-aftershave and returns products from the first page of that category. Unrecognised category slugs return an input_not_found error rather than empty results.
Brand and Direct-URL Access
list_fragrances_by_brand accepts a brand string and returns matching fragrance products. Results are most accurate when the brand name matches Selfridges' own display casing — for example LE LABO, CHANEL, or MAISON FRANCIS KURKDJIAN. get_product_details takes a full Selfridges product URL and returns the complete product record for that specific item, including all fragrance notes and scent tags available on that page.
Coverage Notes
All endpoints are scoped to Selfridges' fragrance catalogue. The list_fragrances_by_category endpoint retrieves only the first page of a category listing, so it does not paginate across the full category depth. Pricing is returned in GBP (price_gbp), reflecting Selfridges' UK storefront. The limit parameter on search and browse endpoints controls how many full product records are fetched; higher limits increase latency proportionally.
- Build a fragrance discovery app showing notes, scent tags, and imagery sourced from Selfridges listings
- Aggregate GBP pricing for luxury fragrances across brands like Chanel, Dior, and Maison Francis Kurkdjian
- Monitor new arrivals in the womens-perfume or mens-aftershave categories by polling list_fragrances_by_category
- Populate a fragrance comparison tool with structured notes fields (e.g. top, heart, base notes) from get_product_details
- Index a brand's full Selfridges fragrance range using list_fragrances_by_brand with exact brand name matching
- Power a recommendation engine by filtering products on scent_tags returned across search and category endpoints
- Track product descriptions and category assignments for specific SKUs using get_product_details with a direct URL
| 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 Selfridges offer an official public developer API?+
What does the list_fragrances_by_category endpoint actually return, and does it paginate?+
beauty/fragrance/womens-perfume. It does not paginate, so results are limited to what appears on that first page. The optional limit parameter controls how many of those results are resolved to full product detail.How specific are the fragrance_notes and scent_tags fields?+
fragrance_notes typically reflects structured note data (top, heart, base) where the source provides it, and scent_tags captures categorical descriptors like 'floral' or 'woody'. Not every product listing includes all fields — availability depends on how the product is listed on Selfridges.