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.
Inputs
Values from the run on Oct 31, 2026, shown under Output.
- Brand optional
brand Optional brand to distinguish matches, for example Rare Beauty.
(default)
- Product, required
product 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.
https://www.sephora.com/product/rare-beauty-by-selena-gomez-soft-pinch-liquid-blush-P97989778
Input as JSON
{ "product": "https://www.sephora.com/product/rare-beauty-by-selena-gomez-soft-pinch-liquid-blush-P97989778" }Output
{ "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" } ]}Code
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"}}' # Save as fous.py, then run: python3 fous.pyimport json, os, timefrom urllib.error import HTTPErrorfrom urllib.request import Request, urlopenAPI = "https://api.fous.com/v1/runs" KEY = os.environ["FOUS_API_KEY"]HEADERS = { "Authorization": f"Bearer {KEY}", "Content-Type": "application/json" ,}def call(url, body=None): data = json.dumps(body).encode() if body else None request = Request(url, data, HEADERS) try: with urlopen(request, timeout=120) as r: return r.status, json.load(r) except HTTPError as error: message = json.load(error)["error"]["message"] raise RuntimeError(message) from errorstatus, run = call(API, { "method": "sephora.com/get_product" , "input": { "product": "https://www.sephora.com/product/rare-beauty-by-selena-gomez-soft-pinch-liquid-blush-P97989778" }})# 202: still going after 30 s. Ask again until it ends.while status == 202: time.sleep(2) status, run = call(f"{API}/{run['id']}")print(json.dumps(run["data"], indent=2))// Save as fous.mjs, then run: node fous.mjsconst api = "https://api.fous.com/v1/runs" ;const headers = { Authorization: `Bearer ${process.env.FOUS_API_KEY}`, "Content-Type": "application/json" ,};let response = await fetch(api, { method: "POST", headers, body: JSON.stringify({ "method": "sephora.com/get_product" , "input": { "product": "https://www.sephora.com/product/rare-beauty-by-selena-gomez-soft-pinch-liquid-blush-P97989778" } }), signal: AbortSignal.timeout(120_000),});let run = await response.json();// 202: still going after 30 s. Ask again until it ends.while (response.status === 202) { await new Promise((done) => setTimeout(done, 2_000)); response = await fetch(`${api}/${run.id}`, { headers }); run = await response.json();}if (!response.ok) throw new Error(run.error.message);console.log(run.data);# Connect your agent to Fous once, over MCP (Streamable HTTP):# https://api.fous.com/mcp# Set FOUS_API_KEY first: create a key at https://app.fous.com/keys.# Claude Codeclaude mcp add \ --scope user \ --transport http fous https://api.fous.com/mcp \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Codexcodex mcp add fous \ --url https://api.fous.com/mcp \ --bearer-token-env-var FOUS_API_KEY# Cursor, VS Code, Windsurf, Cline and morenpx -y add-mcp https://api.fous.com/mcp -g -n fous \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Then ask your agent:# "Use Fous to run sephora.com/get_product# with {"product":"https://www.sephora.com/product/rare-beauty-by-selena-gomez-soft-pinch-liquid-blush-P97989778"}"Over HTTP, the answer’s data holds the output. A run still going after 30 seconds answers 202 with its id: ask GET /v1/runs/{id} until it ends.
Schema
Input schema
{ "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
{ "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}- Price
- 1 credit per completed run (1¢ with pay as you go); failed runs are free.
- Method
sephora.com/get_product- Returns
- name, brand, price, sizes and shades, highlights, what it is, ingredients, how to use, rating, reviews, loves, images, link, IDs
Use it from your agent
Give your agent this line. It reads SKILL.md, gets a Fous API key and connects the Fous MCP server. Its run then takes the method sephora.com/get_product with the inputs above.
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?
See more
All Sephora methodsFinds 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.com/get_product_reviewsSearches 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.com/search_productsLooks 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.com/get_productGets 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.
bhphotovideo.com/get_productFinds 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).
lowes.com/get_productGets 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.
newegg.com/get_productGets details, price and availability for a Walmart product by name or product link, using Walmart's default location.
walmart.com/get_productGets 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.
amazon.com/get_product
