# Sephora API: Search products

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

Unofficial. Not affiliated with or endorsed by Sephora.

- Page: https://fous.com/methods/sephora.com/search-products
- Method: `sephora.com/search_products`, version 1
- Website: sephora.com
- Returns: product name, brand, price, rating, review count, loves count, image, product link, product and SKU 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 |
|---|---|---|---|---|
| `sort` | string | no | `"top_rated"` | Order products by relevance, popularity, rating, newest, or price; for example top_rated. One of "relevance", "best_selling", "top_rated", "newest", "price_low_to_high", "price_high_to_low". Default "relevance". |
| `brand` | string | no |  | Only show this brand, for example Drunk Elephant. |
| `query` | string | yes | `"moisturizer"` | Words describing what to find, for example vitamin C serum. |
| `max_price` | number | no |  | Highest price in USD, for example 90. |
| `min_price` | number | no |  | Lowest price in USD, for example 20. |
| `max_results` | integer | no | `60` | Maximum number of products to return, for example 24. Default 24. |

## Output

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

```json
{
  "sort": "top_rated",
  "query": "moisturizer",
  "max_results": 60
}
```

Its output:

```json
{
  "products": [
    {
      "brand": "Arencia",
      "price": 24,
      "sku_id": "3039666",
      "currency": "USD",
      "image_link": "https://www.sephora.com/productimages/sku/s3039666-main-zoom.jpg?imwidth=270&pb=olive-young-kbeauty",
      "product_id": "P521609",
      "loves_count": null,
      "star_rating": 5,
      "product_link": "https://www.sephora.com/product/arencia-deep-water-surge-soothing-cream-P521609?skuId=3039666",
      "product_name": "Deep Water Surge Hydrating Cream Moisturizer with Cica PDRN, Hyaluronic Acid, and Ceramide",
      "review_count": 5,
      "price_display": "$24.00"
    },
    {
      "brand": "Dieux",
      "price": 49,
      "sku_id": "3009321",
      "currency": "USD",
      "image_link": "https://www.sephora.com/productimages/sku/s3009321-main-zoom.jpg?imwidth=270",
      "product_id": "P526366",
      "loves_count": null,
      "star_rating": 5,
      "product_link": "https://www.sephora.com/product/holiday-set-instant-angel-h-a-P526366?skuId=3009321",
      "product_name": "Hydration-on-Loop – Instant Angel Firming Moisturizer Gift Set",
      "review_count": 30,
      "price_display": "$49.00"
    },
    {
      "brand": "Tatcha",
      "price": 28,
      "sku_id": "3027786",
      "currency": "USD",
      "image_link": "https://www.sephora.com/productimages/sku/s3027786-main-zoom.jpg?imwidth=270",
      "product_id": "P527312",
      "loves_count": null,
      "star_rating": 5,
      "product_link": "https://www.sephora.com/product/tatcha-the-longevity-youth-restoring-cream-moisturizer-for-elasticity-brightness-P527312?skuId=3027786",
      "product_name": "The Mini Longevity Youth Restoring Cream Moisturizer for Elasticity & Brightness",
      "review_count": 1,
      "price_display": "$28.00"
    }
  ]
}
```

## 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/search_products","input":{"sort":"top_rated","query":"moisturizer","max_results":60}}'
```

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

- Find hydrating moisturizers under $40 on Sephora, sorted by top rated
- Show me the best selling vitamin C serums between $15 and $60
- I need a Drunk Elephant cleanser, newest arrivals first
- Search for sunscreen SPF 50 priced under 30 dollars, lowest price first
- List 10 top rated retinol products from any brand, max 90 dollars

## 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."
    },
    "brand": {
      "type": "string",
      "description": "Only show this brand, for example Drunk Elephant."
    },
    "query": {
      "type": "string",
      "minLength": 1,
      "description": "Words describing what to find, for example vitamin C serum."
    },
    "max_price": {
      "type": "number",
      "minimum": 0,
      "description": "Highest price in USD, for example 90."
    },
    "min_price": {
      "type": "number",
      "minimum": 0,
      "description": "Lowest price in USD, for example 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
    }
  },
  "additionalProperties": false
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "products"
  ],
  "properties": {
    "products": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "product_name",
          "brand",
          "price",
          "currency",
          "price_display",
          "star_rating",
          "review_count",
          "loves_count",
          "image_link",
          "product_link",
          "product_id",
          "sku_id"
        ],
        "properties": {
          "brand": {
            "type": [
              "string",
              "null"
            ],
            "description": "Brand name."
          },
          "price": {
            "type": [
              "number",
              "null"
            ],
            "description": "Lowest listed size price in USD."
          },
          "sku_id": {
            "type": [
              "string",
              "null"
            ],
            "description": "Sephora displayed SKU ID.",
            "x-fous-developer": true
          },
          "currency": {
            "type": "string",
            "description": "Currency of the price."
          },
          "image_link": {
            "type": [
              "string",
              "null"
            ],
            "description": "Product image link."
          },
          "product_id": {
            "type": [
              "string",
              "null"
            ],
            "description": "Sephora product ID.",
            "x-fous-developer": true
          },
          "loves_count": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Number of shoppers who loved this product; null if unavailable."
          },
          "star_rating": {
            "type": [
              "number",
              "null"
            ],
            "description": "Average star rating, from 0 to 5."
          },
          "product_link": {
            "type": "string",
            "description": "Sephora product page link."
          },
          "product_name": {
            "type": "string",
            "description": "Product name."
          },
          "review_count": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Number of reviews."
          },
          "price_display": {
            "type": [
              "string",
              "null"
            ],
            "description": "Price shown on Sephora, including a size range when applicable."
          }
        },
        "additionalProperties": false
      },
      "description": "Products in Sephora search order."
    }
  },
  "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: 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: 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.
- [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.
- [Macy's API: Search products](https://fous.com/methods/macys.com/search-products.md): Searches Macy's products in the site's order with optional USD price bounds, sale-only results and sorting. Prices for products with a range use the lowest shown price.
- [Kohl's API: Search products](https://fous.com/methods/kohls.com/search-products.md): Searches Kohl's products in site order and returns prices, offers, ratings and links for each result.
- [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.
- [Chewy API: Search products](https://fous.com/methods/chewy.com/search-products.md): Search Chewy products by words, pet type, and sort order. Returns up to 72 products in Chewy's order, including listed and first-order Autoship prices when shown.
- [All Sephora methods](https://fous.com/methods/sephora.com.md)