# Ulta Beauty Product Search

Search the public Ulta Beauty catalogue by keyword or category path. Returns product cards with product id, sku, brand, name, full-size image, list and sale price in USD, discount, promo, rating, review count, badge, sponsored and stock flag. Sort, brand, price range and page are honoured. Brand and price apply to the current page; has_more describes the unfiltered page. Page N is a real page, never page 1 relabelled. One upstream lookup per request, plus one fallback lookup only when the first fails. Costs 1 credit when rows are returned. An empty page is not billed (0 credits).

- **Documentation:** [https://scrappa.co/docs/ulta-api/ulta_search](https://scrappa.co/docs/ulta-api/ulta_search)
- **API group:** Ulta Beauty API
- **Endpoint:** `GET https://scrappa.co/api/ulta/search`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `query` | string | No | Search text, for example mascara. Send this or category. |
| `category` | string | No | Category path from Ulta, for example /shop/makeup/lips/lipstick. |
| `sort` | string | No | best_sellers, new_arrivals, price_asc, price_desc or top_rated. |
| `page` | integer | No | One-based page number, 1 to 10. Default: 1. |
| `brand` | string | No | Brand name filter. |
| `min_price` | number | No | Lowest USD price. Send with max_price. |
| `max_price` | number | No | Highest USD price. Send with min_price. |

## Errors

| Status | Error | Description |
| --- | --- | --- |
|  | A parameter is unsupported or out of range. This response is not billed. |  |
|  | Ulta is temporarily unavailable. This response is not billed. |  |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)
