{"uid":"cap_wvm9TkmjaD1TsTJQKP6Pj","slug":"sitecheck-shop-social-sephora-product-search-f75cc63c","name":"SiteCheck Shop & Social: Sephora Product Search","description":"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.","url":"https://api.shopsocial-api.workers.dev/api/ecommerce/sephora-products?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"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"}}}}},"responseSchema":{"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}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_-9UGjz4jZVPW1L7NSkl9M","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Searches Sephora's US product catalog by keyword and returns up to 60 products per page with pricing, ratings, flags, and category breakdowns.","exampleAgentPrompt":"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?","exampleUseCases":[{"title":"Beauty product price comparison","prompt":"Search Sephora for 'foundation' and give me the first page of results with prices, ratings, and review counts so I can compare options."},{"title":"Brand catalog lookup on Sephora","prompt":"Find all Anastasia Beverly Hills products on Sephora — I want to see prices, how many shades each has, and which ones are bestsellers."},{"title":"Deal hunting for sale items","prompt":"Search Sephora for 'moisturizer' and flag any products that are on sale or have a sale price listed — show me the regular and sale prices."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T00:34:27.198Z","isFirstParty":false,"canonicalSlug":"sitecheck-shop-social-sephora-product-search-f75cc63c"}