# Sephora API

> Sephora returns beauty product, product detail, and review data, available as a workflow and API.

Sephora, also called Sephora USA, returns beauty product search results filtered by query, brand, price, and sort options. Get product returns details such as ingredients, highlights, sizes, shades, and availability using a product name or Sephora link. Get product reviews returns review summaries and customer reviews using a product name or Sephora link, with optional sorting and skin type.

- Page: https://fous.com/workflows/sephora
- Handle: `@sephora`
- Category: [Commerce](https://fous.com/workflows/category/commerce)
- Source website: https://sephora.com
- Last verified: Sep 29, 2026
- Fous is not affiliated with Sephora.

## Methods

### Get product

Operation `get_product`, version 1. 1 credit per call.

Get full Sephora US product details from a product name or Sephora product link. A brand can narrow name matches; prices and availability are shown for the public US catalog.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `brand` | string | no | `"Rare Beauty"` | Optional brand to distinguish matches, for example Rare Beauty. |
| `product` | string | yes | `"https://www.sephora.com/product/rare-beauty-by-selena-gomez-soft-pinch-liquid-blush-P97989778"` | The product name or Sephora product link, for example Soft Pinch Liquid Blush or https://www.sephora.com/product/rare-beauty-by-selena-gomez-soft-pinch-liquid-blush-P97989778. |

**Input schema**

```json
{
  "type": "object",
  "required": [
    "product"
  ],
  "properties": {
    "brand": {
      "type": "string",
      "default": "",
      "description": "Optional brand to distinguish matches, for example Rare Beauty.",
      "examples": [
        "Rare Beauty"
      ]
    },
    "product": {
      "type": "string",
      "description": "The product name or Sephora product link, for example Soft Pinch Liquid Blush or https://www.sephora.com/product/rare-beauty-by-selena-gomez-soft-pinch-liquid-blush-P97989778.",
      "examples": [
        "https://www.sephora.com/product/rare-beauty-by-selena-gomez-soft-pinch-liquid-blush-P97989778",
        "Mini Soft Pinch Liquid Blush",
        "Soft Pinch Liquid Blush"
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "product": "https://www.sephora.com/product/rare-beauty-by-selena-gomez-soft-pinch-liquid-blush-P97989778"
    },
    {
      "brand": "Rare Beauty",
      "product": "Mini Soft Pinch Liquid Blush"
    },
    {
      "brand": "Rare Beauty",
      "product": "Soft Pinch Liquid Blush"
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `brand` | string | `"Rare Beauty by Selena Gomez"` |  |
| `price` | number or null | `25` |  |
| `sku_ids` | array |  |  |
| `currency` | string | `"USD"` |  |
| `highlights` | array |  |  |
| `how_to_use` | string or null | `"Suggested Usage: -Gently remove excess product from applicator. -Use the doe-foot applicator and place one or two dots ` |  |
| `product_id` | string | `"P97989778"` |  |
| `what_it_is` | string or null | `"A weightless liquid blush that delivers high-impact color with just one dot. Blends seamlessly for a pinch-perfect flus` |  |
| `image_links` | array |  |  |
| `ingredients` | string or null |  |  |
| `loves_count` | integer or null | `3217755` |  |
| `star_rating` | number or null | `4.5423` |  |
| `product_link` | string | `"https://www.sephora.com/product/rare-beauty-by-selena-gomez-soft-pinch-liquid-blush-P97989778"` |  |
| `product_name` | string | `"Soft Pinch Liquid Blush"` |  |
| `review_count` | integer or null | `12602` |  |
| `sizes_and_shades` | array |  |  |
| `sizes_and_shades[].name` | string or null | `"Adore"` |  |
| `sizes_and_shades[].size` | string or null | `"0.25 oz/7.5 mL"` |  |
| `sizes_and_shades[].price` | number or null | `25` |  |
| `sizes_and_shades[].sku_id` | string | `"2911741"` |  |
| `sizes_and_shades[].in_stock` | boolean | `true` |  |
| `sizes_and_shades[].product_link` | string | `"https://www.sephora.com/product/rare-beauty-by-selena-gomez-soft-pinch-liquid-blush-P97989778?skuId=2911741"` |  |

**Example input**

```json
{
  "product": "https://www.sephora.com/product/rare-beauty-by-selena-gomez-soft-pinch-liquid-blush-P97989778"
}
```

**Example output**

```json
{
  "brand": "Rare Beauty by Selena Gomez",
  "price": 25,
  "sku_ids": [
    "2911741",
    "2518959"
  ],
  "currency": "USD",
  "highlights": [
    "Medium Coverage",
    "Vegan"
  ],
  "how_to_use": "Suggested Usage: -Gently remove excess product from applicator. -Use the doe-foot applicator and place one or two dots on each cheek. -Use fingertips or the Soft Pinch Blush Brush (sold separately) an…",
  "product_id": "P97989778",
  "what_it_is": "A weightless liquid blush that delivers high-impact color with just one dot. Blends seamlessly for a pinch-perfect flush that lasts up to 12 hours.",
  "image_links": [
    "https://www.sephora.com/productimages/sku/s2911741-main-zoom.jpg",
    "https://www.sephora.com/productimages/sku/s2911741-av-1202509042327382180700-zoom.jpg"
  ],
  "ingredients": "Hydrogenated Polyisobutene, Hydrogenated Poly(C6-14 Olefin), Mica, Octyldodecanol, Ethylene/Propylene/Styrene Copolymer, Trimethylsiloxysilicate, Isododecane, 1,2-Hexanediol, Disteardimonium Hectorite…",
  "loves_count": 3217755,
  "star_rating": 4.5423,
  "product_link": "https://www.sephora.com/product/rare-beauty-by-selena-gomez-soft-pinch-liquid-blush-P97989778",
  "product_name": "Soft Pinch Liquid Blush",
  "review_count": 12602,
  "sizes_and_shades": [
    {
      "name": "Adore",
      "size": "0.25 oz/7.5 mL",
      "price": 25,
      "sku_id": "2911741",
      "in_stock": true,
      "product_link": "https://www.sephora.com/product/rare-beauty-by-selena-gomez-soft-pinch-liquid-blush-P97989778?skuId=2911741"
    },
    {
      "name": "Believe",
      "size": "0.25 oz/ 7.5 mL",
      "price": 25,
      "sku_id": "2518959",
      "in_stock": true,
      "product_link": "https://www.sephora.com/product/rare-beauty-by-selena-gomez-soft-pinch-liquid-blush-P97989778?skuId=2518959"
    }
  ]
}
```

### Get product reviews

Operation `get_product_reviews`, version 1. 1 credit per call.

Get a Sephora US product’s overall review summary and customer reviews by product name or Sephora link. Reviewer details may be missing when not provided by the customer.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `sort` | string | no | `"most_helpful"` | Order reviews, for example newest. |
| `brand` | string | no | `"LANEIGE"` | Optional brand to distinguish products, for example LANEIGE. |
| `product` | string | yes | `"Lip Sleeping Mask"` | Product name or Sephora product link, for example Lip Sleeping Mask or https://www.sephora.com/product/lip-sleeping-mask-P420652. |
| `skin_type` | string | no | `"any"` | Reviewer skin type to include, for example dry. |
| `max_results` | integer | no | `20` | Maximum number of reviews, for example 20. |

**Input schema**

```json
{
  "type": "object",
  "required": [
    "product"
  ],
  "properties": {
    "sort": {
      "enum": [
        "most_helpful",
        "newest",
        "highest_rating",
        "lowest_rating"
      ],
      "type": "string",
      "default": "most_helpful",
      "description": "Order reviews, for example newest.",
      "examples": [
        "most_helpful",
        "lowest_rating",
        "newest"
      ]
    },
    "brand": {
      "type": "string",
      "description": "Optional brand to distinguish products, for example LANEIGE.",
      "examples": [
        "LANEIGE",
        "Rare Beauty by Selena Gomez"
      ]
    },
    "product": {
      "type": "string",
      "description": "Product name or Sephora product link, for example Lip Sleeping Mask or https://www.sephora.com/product/lip-sleeping-mask-P420652.",
      "examples": [
        "Lip Sleeping Mask",
        "Soft Pinch Liquid Blush",
        "https://www.sephora.com/product/lip-sleeping-mask-P420652"
      ]
    },
    "skin_type": {
      "enum": [
        "any",
        "dry",
        "oily",
        "combination",
        "normal"
      ],
      "type": "string",
      "default": "any",
      "description": "Reviewer skin type to include, for example dry.",
      "examples": [
        "any",
        "combination",
        "dry"
      ]
    },
    "max_results": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1,
      "description": "Maximum number of reviews, for example 20.",
      "x-fous-developer": true,
      "examples": [
        20,
        4,
        5
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "sort": "most_helpful",
      "brand": "LANEIGE",
      "product": "Lip Sleeping Mask",
      "skin_type": "any",
      "max_results": 20
    },
    {
      "sort": "lowest_rating",
      "brand": "Rare Beauty by Selena Gomez",
      "product": "Soft Pinch Liquid Blush",
      "skin_type": "combination",
      "max_results": 4
    },
    {
      "sort": "newest",
      "product": "https://www.sephora.com/product/lip-sleeping-mask-P420652",
      "skin_type": "dry",
      "max_results": 5
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `reviews` | array |  |  |
| `reviews[].date` | string or null | `"2026-07-29"` |  |
| `reviews[].title` | string or null | `"Problem with leaking product"` |  |
| `reviews[].page_link` | string | `"https://www.sephora.com/product/rare-beauty-by-selena-gomez-soft-pinch-liquid-blush-P97989778#ratings-reviews-container` |  |
| `reviews[].skin_tone` | string or null | `"Fair"` |  |
| `reviews[].skin_type` | string or null | `"Combination"` |  |
| `reviews[].review_text` | string or null | `"This is a delayed review but I just threw this product out because it consistently leaks product out of the top and get` |  |
| `reviews[].star_rating` | integer or null | `1` |  |
| `reviews[].helpful_votes` | integer | `4` |  |
| `reviews[].reviewer_nickname` | string or null | `"Ellamh"` |  |
| `reviews[].verified_purchase` | boolean | `false` |  |
| `reviews[].received_free_product` | boolean | `false` |  |
| `page_link` | string | `"https://www.sephora.com/product/rare-beauty-by-selena-gomez-soft-pinch-liquid-blush-P97989778"` |  |
| `product_name` | string | `"Soft Pinch Liquid Blush"` |  |
| `review_count` | integer | `12603` |  |
| `overall_rating` | number or null | `4.542331190986273` |  |
| `percent_who_recommend` | number or null | `91` |  |

**Example input**

```json
{
  "sort": "lowest_rating",
  "brand": "Rare Beauty by Selena Gomez",
  "product": "Soft Pinch Liquid Blush",
  "skin_type": "combination",
  "max_results": 4
}
```

**Example output**

```json
{
  "reviews": [
    {
      "date": "2026-07-29",
      "title": "Problem with leaking product",
      "page_link": "https://www.sephora.com/product/rare-beauty-by-selena-gomez-soft-pinch-liquid-blush-P97989778#ratings-reviews-container",
      "skin_tone": "Fair",
      "skin_type": "Combination",
      "review_text": "This is a delayed review but I just threw this product out because it consistently leaks product out of the top and gets all over everything in my makeup bag and vanity. It makes me not want to use th…",
      "star_rating": 1,
      "helpful_votes": 4,
      "reviewer_nickname": "Ellamh",
      "verified_purchase": false,
      "received_free_product": false
    },
    {
      "date": "2026-06-16",
      "title": "Very Disappointed",
      "page_link": "https://www.sephora.com/product/rare-beauty-by-selena-gomez-soft-pinch-liquid-blush-P97989778#ratings-reviews-container",
      "skin_tone": "Fair Light",
      "skin_type": "Combination",
      "review_text": "The color is much more warm than the marketing shows. Despite being very pale it barely showed up on my skin and when it did, it looked bad. My powder made it completely disappear. I could wash it off…",
      "star_rating": 1,
      "helpful_votes": 5,
      "reviewer_nickname": "EllaHitchman",
      "verified_purchase": false,
      "received_free_product": true
    }
  ],
  "page_link": "https://www.sephora.com/product/rare-beauty-by-selena-gomez-soft-pinch-liquid-blush-P97989778",
  "product_name": "Soft Pinch Liquid Blush",
  "review_count": 12603,
  "overall_rating": 4.542331190986273,
  "percent_who_recommend": 91
}
```

### Search products

Operation `search_products`, version 1. 1 credit per call.

Search Sephora US beauty products in the site’s order, with brand and USD price filters and shopper sort options. Loves counts may be unavailable when a product page cannot be loaded.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `sort` | string | no | `"price_high_to_low"` | Order products by relevance, popularity, rating, newest, or price; for example top_rated. |
| `brand` | string | no | `"Drunk Elephant"` | Only show this brand, for example Drunk Elephant. |
| `query` | string | yes | `"vitamin C serum"` | Words describing what to find, for example vitamin C serum. |
| `max_price` | number | no | `90` | Highest price in USD, for example 90. |
| `min_price` | number | no | `20` | Lowest price in USD, for example 20. |
| `max_results` | integer | no | `6` | Maximum number of products to return, for example 24. |

**Input schema**

```json
{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "sort": {
      "enum": [
        "relevance",
        "best_selling",
        "top_rated",
        "newest",
        "price_low_to_high",
        "price_high_to_low"
      ],
      "type": "string",
      "default": "relevance",
      "description": "Order products by relevance, popularity, rating, newest, or price; for example top_rated.",
      "examples": [
        "price_high_to_low",
        "top_rated"
      ]
    },
    "brand": {
      "type": "string",
      "description": "Only show this brand, for example Drunk Elephant.",
      "examples": [
        "Drunk Elephant"
      ]
    },
    "query": {
      "type": "string",
      "minLength": 1,
      "description": "Words describing what to find, for example vitamin C serum.",
      "examples": [
        "vitamin C serum",
        "moisturizer",
        "__!!"
      ]
    },
    "max_price": {
      "type": "number",
      "minimum": 0,
      "description": "Highest price in USD, for example 90.",
      "examples": [
        90
      ]
    },
    "min_price": {
      "type": "number",
      "minimum": 0,
      "description": "Lowest price in USD, for example 20.",
      "examples": [
        20
      ]
    },
    "max_results": {
      "type": "integer",
      "default": 24,
      "maximum": 60,
      "minimum": 1,
      "description": "Maximum number of products to return, for example 24.",
      "x-fous-developer": true,
      "examples": [
        6,
        60,
        5
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "sort": "price_high_to_low",
      "brand": "Drunk Elephant",
      "query": "vitamin C serum",
      "max_price": 90,
      "min_price": 20,
      "max_results": 6
    },
    {
      "sort": "top_rated",
      "query": "moisturizer",
      "max_results": 60
    },
    {
      "query": "__!!",
      "max_results": 5
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `products` | array |  | Products in Sephora search order. |
| `products[].brand` | string or null | `"Drunk Elephant"` | Brand name. |
| `products[].price` | number or null | `79` | Lowest listed size price in USD. |
| `products[].sku_id` | string or null | `"2464949"` | Sephora displayed SKU ID. |
| `products[].currency` | string | `"USD"` | Currency of the price. |
| `products[].image_link` | string or null | `"https://www.sephora.com/productimages/sku/s2464949-main-zoom.jpg?imwidth=270&pb=clean-at-sephora"` | Product image link. |
| `products[].product_id` | string or null | `"P400259"` | Sephora product ID. |
| `products[].loves_count` | integer or null | `350239` | Number of shoppers who loved this product; null if unavailable. |
| `products[].star_rating` | number or null | `4.0287` | Average star rating, from 0 to 5. |
| `products[].product_link` | string | `"https://www.sephora.com/product/c-firma-day-serum-P400259?skuId=2464949"` | Sephora product page link. |
| `products[].product_name` | string | `"C-Firma Fresh Vitamin-C Day Serum"` | Product name. |
| `products[].review_count` | integer or null | `2265` | Number of reviews. |
| `products[].price_display` | string or null | `"$79.00"` | Price shown on Sephora, including a size range when applicable. |

**Example input**

```json
{
  "sort": "price_high_to_low",
  "brand": "Drunk Elephant",
  "query": "vitamin C serum",
  "max_price": 90,
  "min_price": 20,
  "max_results": 6
}
```

**Example output**

```json
{
  "products": [
    {
      "brand": "Drunk Elephant",
      "price": 79,
      "sku_id": "2464949",
      "currency": "USD",
      "image_link": "https://www.sephora.com/productimages/sku/s2464949-main-zoom.jpg?imwidth=270&pb=clean-at-sephora",
      "product_id": "P400259",
      "loves_count": 350239,
      "star_rating": 4.0287,
      "product_link": "https://www.sephora.com/product/c-firma-day-serum-P400259?skuId=2464949",
      "product_name": "C-Firma Fresh Vitamin-C Day Serum",
      "review_count": 2265,
      "price_display": "$79.00"
    },
    {
      "brand": "Drunk Elephant",
      "price": 68,
      "sku_id": "2797355",
      "currency": "USD",
      "image_link": "https://www.sephora.com/productimages/sku/s2797355-main-zoom.jpg?imwidth=270&pb=clean-at-sephora",
      "product_id": "P512789",
      "loves_count": 23660,
      "star_rating": 4.6429,
      "product_link": "https://www.sephora.com/product/drunk-elephant-c-luma-hydrabright-serum-P512789?skuId=2797355",
      "product_name": "C-Luma Hydrabright Gentle Hydrating Vitamin C Serum",
      "review_count": 364,
      "price_display": "$68.00"
    }
  ]
}
```

## Quick start

Call the API with a Fous API key (`FOUS_API_KEY`). To create one, turn on Developer mode in Fous Studio, then open Keys & connections → API keys (https://app.fous.com/keys).

```bash
# First set your key: export FOUS_API_KEY='YOUR_FOUS_API_KEY'
: "${FOUS_API_KEY:?Set FOUS_API_KEY before running this example}"

curl 'https://api.fous.com/v1/query' \
  --fail-with-body --silent --show-error --max-time 120 \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "api": "@sephora",
  "visibility": "public",
  "operation": "get_product",
  "version": 1,
  "input": {
    "product": "https://www.sephora.com/product/rare-beauty-by-selena-gomez-soft-pinch-liquid-blush-P97989778"
  },
  "response": {
    "format": "json"
  }
}'
```

```python
# Save as fous.py and run with python3 fous.py. No packages needed.
# First set your key: export FOUS_API_KEY='YOUR_FOUS_API_KEY'
import json
import os
import urllib.error
import urllib.request

api_key = os.environ.get("FOUS_API_KEY")
if not api_key:
    raise RuntimeError("Set FOUS_API_KEY before running this example")

body = json.loads("{\n  \"api\": \"@sephora\",\n  \"visibility\": \"public\",\n  \"operation\": \"get_product\",\n  \"version\": 1,\n  \"input\": {\n    \"product\": \"https://www.sephora.com/product/rare-beauty-by-selena-gomez-soft-pinch-liquid-blush-P97989778\"\n  },\n  \"response\": {\n    \"format\": \"json\"\n  }\n}")
request = urllib.request.Request(
    "https://api.fous.com/v1/query",
    data=json.dumps(body).encode("utf-8"),
    headers={
        "Authorization": f"Bearer {api_key}",
        "Content-Type": "application/json",
    },
    method="POST",
)
try:
    with urllib.request.urlopen(request, timeout=120) as response:
        result = json.load(response)
except urllib.error.HTTPError as error:
    raise RuntimeError(f"HTTP {error.code}: {error.read().decode('utf-8', errors='replace')}") from error
if result.get("success") is False:
    raise RuntimeError(result.get("error", {}).get("message", "Request failed"))
print(json.dumps(result["data"]["output"], indent=2))
```

```typescript
// Save as fous.mts and run with npx tsx fous.mts.
// First set your key: export FOUS_API_KEY='YOUR_FOUS_API_KEY'
const apiKey = process.env.FOUS_API_KEY;
if (!apiKey) throw new Error("Set FOUS_API_KEY before running this example");

const response = await fetch("https://api.fous.com/v1/query", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${apiKey}`,
    "Content-Type": "application/json",
  },
  signal: AbortSignal.timeout(120_000),
  body: JSON.stringify({
  "api": "@sephora",
  "visibility": "public",
  "operation": "get_product",
  "version": 1,
  "input": {
    "product": "https://www.sephora.com/product/rare-beauty-by-selena-gomez-soft-pinch-liquid-blush-P97989778"
  },
  "response": {
    "format": "json"
  }
}),
});
type ApiResult = { success: boolean; data?: { output: unknown }; error?: { message: string } };
const result: ApiResult = await response.json();
if (!response.ok || result.success === false) {
  throw new Error(result.error?.message ?? `HTTP ${response.status}`);
}
if (!result.data) throw new Error("Missing API response data");
console.log(result.data.output);
```

Or describe the data in plain language: send `{"api":"@sephora","prompt":"Describe the data you need, with every detail"}` to the same URL. Fous fills in the input, runs the method that fits and returns only the fields you asked for; `data.route.calls[].request` is the exact call it made. Routing is free; the run costs the same.

## Use cases

- Compare beauty products by brand, price, and rating.
- Find product details, ingredients, and shades.
- Review customer feedback by rating and skin type.
- Track product prices and available sizes.

## FAQ

### Is Fous affiliated with Sephora?

No. Fous is not affiliated with Sephora. This workflow reads the public sephora.com website and returns its data.

### How much does it cost?

Each run costs 1 credit. With pay-as-you-go, a credit costs 1¢; monthly plans cost less per credit.

### Do I need a Sephora account?

No. You only need a Fous account.

### How current is the data?

Fous gets the data from sephora.com when you run it; repeating the same request within a day may return the saved result. Fous checks this workflow automatically; it last passed a check on Sep 29, 2026.

### What beauty products match a search or price range?

Search products returns results for a required query, with optional brand, price range, and sort options.

### What ingredients and shades does a product have?

Get product returns product details, including ingredients and sizes and shades, from a product name or Sephora link.

### What do customers say about a product?

Get product reviews returns an overall review summary and customer reviews, with optional sorting and skin type.

## Related

- [Ulta Beauty API](https://fous.com/workflows/ulta-beauty.md): Ulta Beauty returns searchable beauty products and product details, including current pricing and availability that may change.
- [Walmart API](https://fous.com/workflows/walmart.md): Walmart helps shoppers find products from Walmart and marketplace sellers, view details, prices, ratings and reviews; availability uses Walmart’s default location, not ZIP codes.
- [Nordstrom API](https://fous.com/workflows/nordstrom.md): Search clothing, shoes, and beauty products at Nordstrom.
- [Amazon API](https://fous.com/workflows/amazon.md): Amazon returns publicly shown product listings, prices, details, ratings, reviews, current best sellers, and Today's Deals; availability and content vary by store, location, and access.
- [Macy's API](https://fous.com/workflows/macys.md): Shop Macy's products and sales.
- [Costco API](https://fous.com/workflows/costco.md): Costco returns US product prices/details and warehouse hours/services/gas prices; delivery affects availability, member prices may be hidden, and posted gas and holiday hours may differ.
- [Shopify API](https://fous.com/workflows/shopify.md): Shopify provides public products, prices, and availability from Shopify-powered stores, reflecting storefront information that may be restricted by some stores.
- [Nike API](https://fous.com/workflows/nike.md): Nike returns country-specific listings and details, including prices, sizes, availability and reviews, plus publicly shown upcoming or recently stocked SNKRS releases with local launch times.
- [All Commerce workflows](https://fous.com/workflows/category/commerce)