# SiteCheck Shop & Social: Sephora Product Search

> SiteCheck Shop & Social: Sephora Product Search is a paid API for AI agents from api.shopsocial-api.workers.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-29).

Searches Sephora's US product catalog by keyword and returns up to 60 products per page with pricing, ratings, flags, and category breakdowns.

## Facts

- Endpoint: GET https://api.shopsocial-api.workers.dev/api/ecommerce/sephora-products?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/sitecheck-shop-social-sephora-product-search-f75cc63c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_wvm9TkmjaD1TsTJQKP6Pj

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability sitecheck-shop-social-sephora-product-search-f75cc63c
```

Example prompt: Can you search Sephora for 'vitamin C serum' and show me the top products with their prices, ratings, and whether any are bestsellers or on sale?

## When to prefer this

Choose this endpoint when you need structured product data directly from Sephora's own US catalog, including prices, ratings, shade counts, and merchandising flags (bestseller, sale, exclusive, etc.). Prefer it over generic web scraping when you need clean, paginated, machine-readable Sephora product listings. It is ideal for price monitoring, product discovery, brand auditing, or building beauty-focused shopping assistants.

## Known failure modes

- Missing or too-short 'q' parameter (fewer than 2 characters) returns an error
- Query exceeding 80 characters may be rejected
- Page number outside 1–20 range returns an error or empty results
- Sephora's underlying catalog API being unavailable causes a failure
- No products found for the keyword returns an empty results array
- Rate limiting or payment failure (x402) prevents the call from completing

## How this service works

Pay-per-call e-commerce, product, price and social media data tools for AI agents, from public sources. Payment: x402, USDC on Base, Solana, Arc, Polygon, Arbitrum, Monad, World Chain, Optimism, Avalanche, Celo or Stellar, or RLUSD/XRP on the XRP Ledger. No signup, no API key; a failed call is not charged.

## Output

A JSON object containing the search keyword, current page, total product count, and a results array of up to 60 products. Each product includes product ID, SKU ID, brand, name, price (as a formatted string and min/max numbers), currency, sale price, rating, review count, number of shades, product and image URLs, and boolean flags for bestseller, new, online only, limited edition, Sephora exclusive, and sponsored status. Also includes a categories array showing Sephora's matched category names and product counts, plus a timestamp and the source URL.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "q"
     ],
     "properties": {
      "q": {
       "type": "string",
       "description": "Search keyword or brand (2 to 80 characters)"
      },
      "page": {
       "type": "string",
       "description": "Result page, 1 to 20 (default 1)"
      },
      "limit": {
       "type": "string",
       "description": "Products from this page, 1 to 60 (default 60)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "q": "lipstick",
  "page": 1,
  "total": 174,
  "source": "https://www.sephora.com/api/v2/catalog/search/?type=keyword&q=lipstick&content=true&includeRegionsMap=true&page=60&currentPage=1",
  "results": [
   {
    "new": false,
    "url": "https://www.sephora.com/product/mac-cosmetics-m-a-cximal-silky-matte-lipstick-P510799?skuId=2837425",
    "name": "M·A·Cximal Silky Matte 12HR Wear Lipstick",
    "brand": "MAC Cosmetics",
    "image": "https://www.sephora.com/productimages/sku/s2837425-main-zoom.jpg?imwidth=270",
    "price": "$16.00 - $25.00",
    "skuId": "2837425",
    "onSale": null,
    "rating": 4.59,
    "shades": 27,
    "reviews": 771,
    "currency": "USD",
    "priceMax": 25,
    "priceMin": 16,
    "productId": "P510799",
    "salePrice": null,
    "sponsored": false,
    "bestseller": true,
    "onlineOnly": false,
    "limitedEdition": false,
    "sephoraExclusive": false
   },
   {
    "new": false,
    "url": "https://www.sephora.com/product/anastasia-beverly-hills-matte-satin-velvet-lipstick-P480576?skuId=2882280",
    "name": "Full-Pigment Matte & Satin Velvet Lipstick",
    "brand": "Anastasia Beverly Hills",
    "image": "https://www.sephora.com/productimages/sku/s2882280-main-zoom.jpg?imwidth=270",
    "price": "$26.00",
    "skuId": "2882280",
    "onSale": null,
    "rating": 4.49,
    "shades": 24,
    "reviews": 1698,
    "currency": "USD",
    "priceMax": 26,
    "priceMin": 26,
    "productId": "P480576",
    "salePrice": null,
    "sponsored": false,
    "bestseller": false,
    "onlineOnly": false,
    "limitedEdition": false,
    "sephoraExclusive": false
   }
  ],
  "checkedAt": "2026-10-23T09:37:46.682Z",
  "categories": [
   {
    "name": "Makeup",
    "products": 173
   },
   {
    "name": "Mini Size",
    "products": 7
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/sitecheck-shop-social-sephora-product-search-f75cc63c/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.shopsocial-api.workers.dev](https://www.zero.xyz/host/api.shopsocial-api.workers.dev/llms.txt)
