# Sephora API: Get product details

> 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.

Unofficial. Not affiliated with or endorsed by Sephora.

- Page: https://fous.com/methods/sephora.com/get-product
- Method: `sephora.com/get_product`, version 1
- Website: sephora.com
- Returns: name, brand, price, sizes and shades, highlights, what it is, ingredients, how to use, rating, reviews, loves, images, link, IDs
- 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 |
|---|---|---|---|---|
| `brand` | string | no |  | Optional brand to distinguish matches, for example Rare Beauty. Default "". |
| `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. |

## Output

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

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

Its output:

```json
{
  "brand": "Rare Beauty by Selena Gomez",
  "price": 25,
  "sku_ids": [
    "2911741",
    "2518959",
    "2518983"
  ],
  "currency": "USD",
  "highlights": [
    "Medium Coverage",
    "Vegan",
    "Long-wearing"
  ],
  "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) and gently pat into skin for a seamless finish. -For more control, apply blush to the back of your han…",
  "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",
    "https://www.sephora.com/productimages/sku/s2911741-av-2202507170933333510700-zoom.jpg"
  ],
  "ingredients": "Hydrogenated Polyisobutene, Hydrogenated Poly(C6-14 Olefin), Mica, Octyldodecanol, Ethylene/Propylene/Styrene Copolymer, Trimethylsiloxysilicate, Isododecane, 1,2-Hexanediol, Disteardimonium Hectorite, Sorbitan Sesquioleate, Propylene Carbonate, Triethoxycaprylylsilane, Aluminum Hydroxide, Helianthu…",
  "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"
    },
    {
      "name": "Hope",
      "size": "0.25 oz/ 7.5 mL",
      "price": 25,
      "sku_id": "2518983",
      "in_stock": true,
      "product_link": "https://www.sephora.com/product/rare-beauty-by-selena-gomez-soft-pinch-liquid-blush-P97989778?skuId=2518983"
    }
  ]
}
```

## 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","input":{"product":"https://www.sephora.com/product/rare-beauty-by-selena-gomez-soft-pinch-liquid-blush-P97989778"}}'
```

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

- What's the full ingredient list and price for Fenty Beauty Gloss Bomb Universal Lip Luminizer?
- Pull up the shades and which ones are in stock for Rare Beauty Positive Light Liquid Luminizer on Sephora
- Can you get me the details on this: https://www.sephora.com/product/drunk-elephant-protini-polypeptide-cream-P427421 — sizes, rating, and how to use it
- How many reviews and loves does Summer Fridays Lip Butter Balm have, and what sizes does it come in?
- I'm looking at Glow Recipe Watermelon Glow Niacinamide Dew Drops at Sephora — what does it claim to do and what's in it?

## Input schema

```json
{
  "type": "object",
  "required": [
    "product"
  ],
  "properties": {
    "brand": {
      "type": "string",
      "default": "",
      "description": "Optional brand to distinguish matches, for example 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."
    }
  }
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "product_name",
    "brand",
    "price",
    "currency",
    "sizes_and_shades",
    "highlights",
    "what_it_is",
    "ingredients",
    "how_to_use",
    "star_rating",
    "review_count",
    "loves_count",
    "image_links",
    "product_link",
    "product_id",
    "sku_ids"
  ],
  "properties": {
    "brand": {
      "type": "string"
    },
    "price": {
      "type": [
        "number",
        "null"
      ]
    },
    "sku_ids": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "currency": {
      "type": "string"
    },
    "highlights": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "how_to_use": {
      "type": [
        "string",
        "null"
      ]
    },
    "product_id": {
      "type": "string"
    },
    "what_it_is": {
      "type": [
        "string",
        "null"
      ]
    },
    "image_links": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "ingredients": {
      "type": [
        "string",
        "null"
      ]
    },
    "loves_count": {
      "type": [
        "integer",
        "null"
      ]
    },
    "star_rating": {
      "type": [
        "number",
        "null"
      ]
    },
    "product_link": {
      "type": "string"
    },
    "product_name": {
      "type": "string"
    },
    "review_count": {
      "type": [
        "integer",
        "null"
      ]
    },
    "sizes_and_shades": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "name",
          "size",
          "price",
          "in_stock",
          "sku_id",
          "product_link"
        ],
        "properties": {
          "name": {
            "type": [
              "string",
              "null"
            ]
          },
          "size": {
            "type": [
              "string",
              "null"
            ]
          },
          "price": {
            "type": [
              "number",
              "null"
            ]
          },
          "sku_id": {
            "type": "string"
          },
          "in_stock": {
            "type": "boolean"
          },
          "product_link": {
            "type": "string"
          }
        },
        "additionalProperties": false
      }
    }
  },
  "additionalProperties": false
}
```

## See more

- [Sephora API: Get product reviews](https://fous.com/methods/sephora.com/get-product-reviews.md): 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.
- [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.
- [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.
- [bhphotovideo.com API: Get B&H Photo product](https://fous.com/methods/bhphotovideo.com/get-product.md): Gets a B&H Photo product's details by name, product link, or B&H number. A name uses the best matching search result; details and prices reflect the public page.
- [Lowe's API: Get product details](https://fous.com/methods/lowes.com/get-product.md): Finds a Lowe's product by name, item number or product link and returns its details, price, specifications, images and availability at the nearest store for a ZIP code (or the site's default store).
- [Newegg API: Get product details](https://fous.com/methods/newegg.com/get-product.md): Gets full details for a Newegg US product by name, product link, or item number. Seller, price, stock and shipping reflect the selected public offer; shipping may be unavailable when not displayed.
- [Walmart API: Get product](https://fous.com/methods/walmart.com/get-product.md): Gets details, price and availability for a Walmart product by name or product link, using Walmart's default location.
- [Amazon API: Get product](https://fous.com/methods/amazon.com/get-product.md): Gets details for an Amazon product, found by name or by link, in a chosen country store. Offer prices, delivery and variants may be missing when Amazon does not show them publicly.
- [All Sephora methods](https://fous.com/methods/sephora.com.md)