Sephora.com Data API – Real-Time Beauty & Skincare Product Data

Unlock the full potential of Sephora.com with the Sephora.com Data API – a high-performance solution for developers, businesses, and innovators building applications in the beauty, skincare, and cosmetics industry. Simple & easy to use, NO Proxies Needed.

Whether you're creating a beauty recommendation engine, price comparison platform, or e-commerce search experience, this API provides fast, structured, and reliable access to Sephora’s product ecosystem.

Last Updated: Jan 19, 2026

⚡ Quick Start: Example Payloads

Copy and paste these JSON objects directly into the Apify Input tab to test specific endpoints.

1. Helper & Navigation

Health Check (Default)

{
  "endpoint": "/status"
}

Auto-Complete

{
  "endpoint": "/auto-complete",
  "query": "lipstick",
  "language": "en-US"
}

Store List

{
  "endpoint": "/store-list",
  "latitude": "37.4418834",
  "longitude": "-122.1430195",
  "radius": "50"
}

Brands List

{
  "endpoint": "/brands-list"
}

Categories List

{
  "endpoint": "/categories-list"
}

Category Data

{
  "endpoint": "/category-data",
  "categoryId": "cat160006"
}

---

2. Product Search

Search by Keyword

{
  "endpoint": "/search-by-keyword",
  "query": "eyeshadow",
  "sortBy": "BEST_SELLING",
  "minPrice": 20,
  "maxPrice": 100,
  "minRating": 4,
  "isNew": false,
  "currentPage": 1,
  "pageSize": 60
}

Search by Category

{
  "endpoint": "/search-by-category",
  "categoryId": "fragrance",
  "sortBy": "TOP_RATED",
  "currentPage": 1,
  "pageSize": 60
}

Search by Brand

{
  "endpoint": "/search-by-brand",
  "brandName": "gucci",
  "sortBy": "NEW",
  "currentPage": 1,
  "pageSize": 60
}

---

3. Product Information

Product Details

{
  "endpoint": "/product-details",
  "productId": "P427421",
  "language": "en-US"
}

Product Reviews

{
  "endpoint": "/product-reviews",
  "productId": "P458747",
  "sortBy": "MOST_HELPFUL",
  "minRating": 4,
  "currentPage": 1,
  "pageSize": 10
}

---

🔍 What Is the Sephora.com Data API?

The Sephora.com Data API is a developer-friendly RESTful API offering real-time access to:

• Product listings & details
• Brand catalogs
• Categories hierarchy
• Store locations
• Reviews & ratings
• Pricing, SKUs, and ingredient data

With 10 fully documented endpoints, responses under 500ms, and clean JSON output, the API is ideal for responsive frontends, AI/ML pipelines, retail analytics, and more.

---

🚀 Key Features

• 📦 Product Details — Names, pricing, images, SKUs, ingredients & more
• 🧠 Autocomplete Search — Fast, intelligent keyword suggestions
• 🏷️ Brand & Category Data — Full Sephora catalog structure
• 💬 Product Reviews — Ratings, text reviews & customer sentiment
• 📍 Store Locator — Search stores by GPS coordinates
• 🔎 Advanced Search — Filter by price, rating, newness, and more

---

📖 Endpoint Reference & Required Parameters

To prevent errors, use this guide to see exactly which parameters are Required (🔴) or Optional (⚪) for each operation.

1. Helper & Navigation

Endpoint	Description	Required Parameters (🔴)	Optional Parameters (⚪)
/status	Health check (Default)	None	None
/auto-complete	Keyword suggestions	query	language
/store-list	Find nearby stores	latitude, longitude, radius	None
/brands-list	List all brands	None	None
/categories-list	List root categories	None	None
/category-data	Sub-category details	categoryId	None

2. Product Search

Endpoint	Description	Required Parameters (🔴)	Optional Parameters (⚪)
/search-by-keyword	Search by text	query	sortBy, minPrice, maxPrice, minRating, isNew, page, pageSize
/search-by-category	Search by category ID	categoryId	sortBy, minPrice, maxPrice, page, pageSize
/search-by-brand	Search by brand name	brandName	sortBy, minPrice, maxPrice, minRating, page, pageSize

3. Product Information

Endpoint	Description	Required Parameters (🔴)	Optional Parameters (⚪)
/product-details	Full metadata	productId	skuId, language
/product-reviews	User reviews	productId	sortBy, minRating, page, pageSize

---

🧰 Parameter Definitions

Here are the specific values allowed for the parameters listed above.

🆔 Identifiers

• query: The search keyword (e.g., "lipstick", "foundation").
• productId: Sephora Product ID (e.g., "P427421").
• categoryId: Category ID (e.g., "cat160006" or "fragrance").
• brandName: Brand slug/name (e.g., "gucci", "fenty-beauty").
• skuId: Specific variation ID (e.g., "2025633").

📍 Geo-Location

• latitude: e.g., "37.4418834"
• longitude: e.g., "-122.1430195"
• radius: Search radius in miles (e.g., "50").

🎛️ Filters & Pagination

• minPrice / maxPrice: Integer values in USD.
• minRating: Integer between 1 and 5.
• isNew: Boolean (true/false).
• currentPage: Start at 1.
• pageSize: Default is 60.

🔃 Sorting Options (sortBy)

For Product Search Endpoints:

• BEST_SELLING (Default)
• TOP_RATED
• PRICE_LOW_TO_HIGH
• PRICE_HIGH_TO_LOW
• NEW

For Product Reviews Endpoint:

• MOST_HELPFUL
• HIGHEST_RATING
• LOWEST_RATING
• OLDEST
• NEWEST

🌐 Language

• en-US (Default)
• en-CA
• fr-CA

---

💻 Example Input (JSON)

Here is how to configure the Actor for a standard Keyword Search:

{
  "endpoint": "/search-by-keyword",
  "query": "moisturizer",
  "minPrice": 20,
  "maxPrice": 80,
  "minRating": 4,
  "sortBy": "BEST_SELLING",
  "currentPage": 1,
  "pageSize": 60,
  "language": "en-US"
}

---

✅ Ideal Use Cases

• 🛍️ E-commerce & Retail Platforms
• 💄 Beauty & Skincare Apps
• 🧠 AI/ML Recommendation Engines
• 📊 Market Research & Analytics Tools

---

🌍 SEO & Semantic Search Optimization

Optimized for developers looking for:

• Sephora API
• Sephora product data
• Beauty product API
• Skincare API
• Makeup data API
• Store locator API
• Product reviews API
• Beauty e-commerce integration

---

🔗 Start Building Today

Supercharge your beauty tech, AI engine, or e-commerce platform with real-time Sephora data. Integrate the Sephora.com Data API and build smarter, faster, and more personalized beauty experiences.