# Sephora API: Get product reviews

> Finds a Sephora US product by name or Sephora link and returns its review summary and customer reviews, sorted and optionally filtered by skin type.

Unofficial. Not affiliated with or endorsed by Sephora.

- Page: https://fous.com/methods/sephora.com/get-product-reviews
- Method: `sephora.com/get_product_reviews`, version 1
- Website: sephora.com
- Returns: product name, overall rating, review count, percent who recommend, reviews
- Effect: read (it gets data and changes nothing)
- Sign-in: none needed
- Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free
- Verified: Nov 2, 2026

## Inputs

| Field | Type | Required | In the run below | Description |
|---|---|---|---|---|
| `sort` | string | no | `"highest_rating"` | Order reviews, for example newest. One of "most_helpful", "newest", "highest_rating", "lowest_rating". Default "most_helpful". |
| `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 |  | Reviewer skin type to include, for example dry. One of "any", "dry", "oily", "combination", "normal". Default "any". |
| `max_results` | integer | no | `100` | Maximum number of reviews, for example 20. Default 20. |

## Output

From a run on Oct 23, 2026, shortened. Its input:

```json
{
  "sort": "highest_rating",
  "brand": "LANEIGE",
  "product": "Lip Sleeping Mask",
  "max_results": 100
}
```

Its output:

```json
{
  "reviews": [
    {
      "date": "2026-10-22",
      "title": "Everyday NEED",
      "page_link": "https://www.sephora.com/product/lip-sleeping-mask-P420652#ratings-reviews-container",
      "skin_tone": null,
      "skin_type": "Normal",
      "review_text": "I love this product - wear it every night. It leaves my lips feeling very smooth and hydrated when I wake up.",
      "star_rating": 5,
      "helpful_votes": 0,
      "reviewer_nickname": "gduc",
      "verified_purchase": false,
      "received_free_product": false
    },
    {
      "date": "2026-10-21",
      "title": "Must buy",
      "page_link": "https://www.sephora.com/product/lip-sleeping-mask-P420652#ratings-reviews-container",
      "skin_tone": null,
      "skin_type": "Dry",
      "review_text": "My favourite forever. I’ve purchased the Berry sleeping mask 4 times and it never disappoints. Smells like a sweet strawberry banana smoothie, the color is beautiful and the texture is 10/10",
      "star_rating": 5,
      "helpful_votes": 0,
      "reviewer_nickname": "HCT24",
      "verified_purchase": true,
      "received_free_product": false
    },
    {
      "date": "2026-10-19",
      "title": "Your lips are gonnna be so smooth",
      "page_link": "https://www.sephora.com/product/lip-sleeping-mask-P420652#ratings-reviews-container",
      "skin_tone": null,
      "skin_type": null,
      "review_text": "Thank you for giving my lips an other chance you always would be in my priority products to used keep and refill",
      "star_rating": 5,
      "helpful_votes": 0,
      "reviewer_nickname": "k4t0",
      "verified_purchase": false,
      "received_free_product": false
    }
  ],
  "page_link": "https://www.sephora.com/product/lip-sleeping-mask-P420652",
  "product_name": "Lip Sleeping Mask – Intense Hydration Lip Treatment with Vitamin C",
  "review_count": 22464,
  "overall_rating": 4.315571581196581,
  "percent_who_recommend": 82.7
}
```

## Run it

From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output:

```bash
curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"method":"sephora.com/get_product_reviews","input":{"sort":"highest_rating","brand":"LANEIGE","product":"Lip Sleeping Mask","max_results":100}}'
```

From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`.

## Ask your agent

- Show me the newest reviews for the Lip Sleeping Mask from LANEIGE, filtered to dry skin reviewers, up to 15 entries
- What's the overall rating and percent who recommend the Fenty Beauty Pro Filt'r foundation? Pull the lowest-rated reviews first
- I have oily skin. Can you find the most helpful reviews for the CeraVe Hydrating Cleanser on Sephora?
- Get the review count and top 10 highest-rated reviews for https://www.sephora.com/product/the-ordinary-niacinamide-10-zinc-1-P427312 with combination skin filter
- Look up the Tatcha The Dewy Skin Cream and give me 25 normal skin reviews sorted by highest rating

## 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."
    },
    "brand": {
      "type": "string",
      "description": "Optional brand to distinguish products, for example LANEIGE."
    },
    "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."
    },
    "skin_type": {
      "enum": [
        "any",
        "dry",
        "oily",
        "combination",
        "normal"
      ],
      "type": "string",
      "default": "any",
      "description": "Reviewer skin type to include, for example dry."
    },
    "max_results": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1,
      "description": "Maximum number of reviews, for example 20."
    }
  }
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "product_name",
    "overall_rating",
    "review_count",
    "percent_who_recommend",
    "page_link",
    "reviews"
  ],
  "properties": {
    "reviews": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "star_rating",
          "title",
          "review_text",
          "date",
          "reviewer_nickname",
          "skin_type",
          "skin_tone",
          "verified_purchase",
          "received_free_product",
          "helpful_votes",
          "page_link"
        ],
        "properties": {
          "date": {
            "type": [
              "string",
              "null"
            ],
            "format": "date"
          },
          "title": {
            "type": [
              "string",
              "null"
            ]
          },
          "page_link": {
            "type": "string"
          },
          "skin_tone": {
            "type": [
              "string",
              "null"
            ]
          },
          "skin_type": {
            "type": [
              "string",
              "null"
            ]
          },
          "review_text": {
            "type": [
              "string",
              "null"
            ]
          },
          "star_rating": {
            "type": [
              "integer",
              "null"
            ]
          },
          "helpful_votes": {
            "type": "integer"
          },
          "reviewer_nickname": {
            "type": [
              "string",
              "null"
            ]
          },
          "verified_purchase": {
            "type": "boolean"
          },
          "received_free_product": {
            "type": "boolean"
          }
        },
        "additionalProperties": false
      }
    },
    "page_link": {
      "type": "string"
    },
    "product_name": {
      "type": "string"
    },
    "review_count": {
      "type": "integer"
    },
    "overall_rating": {
      "type": [
        "number",
        "null"
      ]
    },
    "percent_who_recommend": {
      "type": [
        "number",
        "null"
      ]
    }
  },
  "additionalProperties": false
}
```

## See more

- [Sephora API: Search products](https://fous.com/methods/sephora.com/search-products.md): Searches Sephora US beauty products in Sephora's order, with brand and USD price filters and shopper sort options. Loves counts are null when a product page cannot be loaded.
- [Sephora API: Get product details](https://fous.com/methods/sephora.com/get-product.md): Gets a Sephora US product's full details from its name (optionally narrowed by brand) or its Sephora product link: price, sizes and shades with stock, highlights, description, ingredients, usage, ratings and images.
- [Ulta Beauty API: Get product](https://fous.com/methods/ulta.com/get-product.md): Looks up one Ulta Beauty product by name or product link and returns its details, prices, sizes or shades, ingredients, directions, ratings and images. Prices and availability may change.
- [Ulta Beauty API: Search products](https://fous.com/methods/ulta.com/search-products.md): Searches Ulta Beauty products by keyword, brand, USD price range and sort order, and returns each product with its starting prices.
- [Apple API: Get app reviews](https://fous.com/methods/apps.apple.com/get-app-reviews.md): Gets customer reviews for an iPhone or iPad app, found by name or App Store link, from the selected country's App Store.
- [G2 API: Get product reviews](https://fous.com/methods/g2.com/get-product-reviews.md): Gets the newest public G2 reviews for a software product, with reviewer details and review text, plus the product's overall rating and review count when G2's profile shows them. The public feed exposes up to 25 recent reviews.
- [Nordstrom API: Search products](https://fous.com/methods/nordstrom.com/search-products.md): Search Nordstrom products by words, price, sale status and sort order. Prices are the lowest listed price. Available sizes may be empty when a product page is unavailable.
- [Google API: Get app reviews](https://fous.com/methods/play.google.com/get-app-reviews.md): Gets public user reviews for an Android app on Google Play. The app can be given by name, Play Store link, or app ID.
- [All Sephora methods](https://fous.com/methods/sephora.com.md)