Ulta Beauty API endpoint
Returns Ulta Beauty's own search-suggestion (typeahead) result for a partial search term: suggested search terms, each with its own top product matches, plus a featured top result matching what a real user sees at the top of the dropdown. A partial term with no matches returns a normal, empty result rather than an error.
/ulta/suggestquery is required, 1 to 200 characters (a partial term, e.g. masc).
Notable response behavior:
suggestions lists each suggested search term with its own label, url (a category/search page), and top_results (up to a handful of matching products).first_top_result mirrors what a real user sees featured at the top of the dropdown -- it is one of suggestions' own top results, not a separate search.count: 0, empty suggestions) rather than an error.| Field | Filled in, of 8 checked | Values in the sample |
|---|---|---|
| brand_name | 8 | “Tarte” and 5 other values |
| product_name | 8 | “Tartelette Tubing Mascara” and 7 other values |
| image_url | 8 | media.ultainc.com |
| url | 8 | ulta.com |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| query | string | Yes | Partial search term | masc | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/ulta/suggest?query=masc" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"query": "masc",
"count": 10,
"source_url": "https://www.ulta.com/dxl/graphql?...",
"fetched_at": "2026-08-11T10:00:00Z",
"suggestions": [
{
"label": "Mascara",
"url": "https://www.ulta.com/shop/makeup/eyes/mascara",
"top_results": [
{
"brand_name": "Tarte",
"product_name": "Tartelette Tubing Mascara",
"image_url": "https://media.ultainc.com/i/ulta/2596644",
"url": "https://www.ulta.com/p/tartelette-tubing-mascara-pimprod2033171?sku=2596644"
}
]
}
],
"first_top_result": [
{
"brand_name": "Tarte",
"product_name": "Tartelette Tubing Mascara",
"image_url": "https://media.ultainc.com/i/ulta/2596644",
"url": "https://www.ulta.com/p/tartelette-tubing-mascara-pimprod2033171?sku=2596644"
}
]
}
}Request schema
No body schema
Response schema
#/definitions/ulta.suggestResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | ulta.SuggestResponse | No | ||||
| data.count | integer | No | ||||
| data.fetched_at | string | No | ||||
| data.first_top_result | array | No | ||||
| data.first_top_result[].brand_name | string | No | ||||
| data.first_top_result[].image_url | string | No | ||||
| data.first_top_result[].product_name | string | No | ||||
| data.first_top_result[].url | string | No | ||||
| data.query | string | No | ||||
| data.source_url | string | No | ||||
| data.suggestions | array | No | ||||
| data.suggestions[].label | string | No | ||||
| data.suggestions[].top_results | array | No | ||||
| data.suggestions[].top_results[].brand_name | string | No | ||||
| data.suggestions[].top_results[].image_url | string | No | ||||
| data.suggestions[].top_results[].product_name | string | No | ||||
| data.suggestions[].top_results[].url | string | No | ||||
| data.suggestions[].url | string | No | ||||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 429 | Too Many Requests | #/definitions/app.Response |
| 503 | Service Unavailable | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/ulta/suggest?query=masc" \
-H "x-api-key: $CRAWLORA_API_KEY"