Ulta Beauty API endpoint
Returns Ulta Beauty physical retail store locations near a point: name, phone, full address, hours, services, and coordinates. Either search, or both lat and lng, is required. search is a free-text zip code, city, or address that is first resolved to coordinates; if it does not resolve to any location, a well-formed empty result is returned rather than an error. lat and lng, when given directly, skip that resolution step. radius_meters is optional (1000 to 50000, defaults to 25000). A location with no stores within the radius returns a well-formed empty result rather than an error.
/ulta/storesSearches Ulta Beauty's own physical retail store locator. Provide search (a free-text zip code, city, or address, resolved to coordinates first), or both lat and lng directly.
radius_meters is optional, in meters, 1000 to 50000, defaults to 25000.
Notable response behavior:
lat/lng in the response always reflect the coordinates actually searched -- the caller's own values when given directly, or the coordinates resolved from search otherwise.search value that does not resolve to any location returns a well-formed empty result (count: 0, stores: []), not an error.hours maps a three-letter day abbreviation (Mon..Sun) to that day's opening range, e.g. "09:00-21:00".| Field | Filled in, of 15 checked | Values in the sample |
|---|---|---|
| id | 15 | |
| slug | 15 | |
| name | 15 | Ulta Beauty in all 15 |
| phone | 15 | |
| address | 15 | |
| city | 15 | Chicago (7), Skokie (2), River Forest (1) and 5 more |
| state | 15 | IL in all 15 |
| postal_code | 15 | |
| country | 15 | US in all 15 |
| latitude | 15 | |
| longitude | 15 | |
| is_permanently_closed | 15 | true in 0 of 15 |
| services | 13 | median 3 entries |
| hours | 15 | |
| url | 15 | ulta.com |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| search | string | No | Free-text zip code, city, or address to resolve to coordinates | 60601 | |
| lat | number | No | Latitude, requires lng | 41.8781 | |
| lng | number | No | Longitude, requires lat | -87.6298 | |
| radius_meters | integer | No | 25000 | Search radius in meters, 1000 to 50000, defaults to 25000 | 25000 |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/ulta/stores" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"search": "60601",
"lat": 41.885769,
"lng": -87.624599,
"radius_meters": 25000,
"count": 1,
"stores": [
{
"id": 2806899,
"slug": "chicago-il-1357",
"name": "Ulta Beauty",
"phone": "+1 312-527-9045",
"address": "430 North Michigan Avenue",
"city": "Chicago",
"state": "IL",
"postal_code": "60611",
"country": "US",
"latitude": 41.8903696,
"longitude": -87.6247778,
"is_permanently_closed": false,
"services": [
"Hair Services",
"Brow Services",
"Makeup Services"
],
"hours": {
"Mon": "09:00-21:00",
"Sun": "10:00-20:00"
},
"url": "https://www.ulta.com/stores/chicago-il-1357"
}
]
}
}Request schema
No body schema
Response schema
#/definitions/ulta.storesResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | ulta.StoreResponse | No | ||||
| data.count | integer | No | ||||
| data.fetched_at | string | No | ||||
| data.lat | number | No | ||||
| data.lng | number | No | ||||
| data.radius_meters | integer | No | ||||
| data.search | string | No | ||||
| data.source_url | string | No | ||||
| data.stores | array | No | ||||
| data.stores[].address | string | No | ||||
| data.stores[].city | string | No | ||||
| data.stores[].country | string | No | ||||
| data.stores[].hours | object | No | Hours maps a three-letter day abbreviation ("Mon".."Sun") to that day's opening range(s), e.g. "09:00-21:00" -- joined with ", " for the rare split-hours day (the upstream's own hoursOfOperation shape supports more than one range per day). | |||
| data.stores[].id | integer | No | ||||
| data.stores[].is_permanently_closed | boolean | No | ||||
| data.stores[].latitude | number | No | ||||
| data.stores[].longitude | number | No | ||||
| data.stores[].name | string | No | ||||
| data.stores[].phone | string | No | ||||
| data.stores[].postal_code | string | No | ||||
| data.stores[].services | array | No | ||||
| data.stores[].slug | string | No | ||||
| data.stores[].state | string | No | ||||
| data.stores[].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/stores" \
-H "x-api-key: $CRAWLORA_API_KEY"