urbanoutfitters.com APIurbanoutfitters.com ↗
Search Urban Outfitters products, browse categories, and get color/size stock levels via 4 endpoints. Real-time prices, sale counts, and availability data.
curl -X GET 'https://api.parse.bot/scraper/d1270442-5389-40c1-b12f-7b07cc190faf/search_products?query=dresses' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for products by keyword query. Returns paginated results with product names, prices, and images.
| Param | Type | Description |
|---|---|---|
| size | integer | Number of results per page |
| sort | string | Sort option (e.g. 'price-asc', 'price-desc', 'newest') |
| queryrequired | string | Search keyword (e.g. 'dresses', 'jackets') |
| start | integer | Starting index for pagination |
{
"type": "object",
"fields": {
"items": "array of product objects with name, id, price, url, and image",
"total": "integer total number of matching products"
},
"sample": {
"data": {
"items": [
{
"id": "UO-89255574-000",
"url": "https://www.urbanoutfitters.com/shop/taylor-swift-lover-2xlp",
"name": "Taylor Swift - Lover 2XLP",
"image": "https://images.urbndata.com/is/image/UrbanOutfitters/89255574_001_b",
"price": 37.99
}
],
"total": 21
},
"status": "success"
}
}About the urbanoutfitters.com API
The Urban Outfitters API provides 4 endpoints covering product search, category browsing, detailed product data, and sale inventory. The get_product_details endpoint returns per-color, per-size stock availability — including which sizes are in stock — alongside brand, price, and a full product URL. search_products accepts keyword queries with sorting and pagination controls so you can pull structured catalog data at scale.
Search and Category Browsing
The search_products endpoint accepts a required query string (e.g. 'dresses', 'jackets') and returns an array of product objects, each with name, id, price, url, and image, plus a total count of matching results. Pagination is controlled via start (offset index) and size (results per page). The sort parameter accepts values like price-asc, price-desc, and newest.
The get_category_listing endpoint works identically but takes a category_slug instead of a keyword — for example 'womens-clothing', 'mens-clothing', 'sale', or 'vinyl-records-cassettes'. It returns the same paginated product array structure and total count, making it straightforward to iterate through an entire category.
Product Details and Stock
get_product_details takes a product_slug (the URL path segment, e.g. 'floral-wrap-midi-dress') and returns a detailed object: name, brand, price, url, and a colors array. Each color object contains the color name and a sizes array, where each entry includes the size label, a stock level, and an available boolean. This is the primary endpoint for inventory checking and availability monitoring.
Sale Coverage
get_sale_item_count requires no inputs and returns the current sale product list using the same items array and total integer structure as the category endpoint. It reflects site-wide sale items and their current prices, making it useful for tracking sale depth over time or alerting on new sale additions.
- Monitor size and color availability for specific products using
get_product_detailsto trigger restock alerts - Build a price comparison tool by polling
search_productsacross multiple keywords and sorting byprice-asc - Track how many items are on sale over time using
get_sale_item_countto detect promotion cycles - Populate a product feed for affiliate or fashion content sites using category listings from
get_category_listing - Identify new arrivals in a category by querying
get_category_listingwithsort=neweston a schedule - Aggregate brand presence across search results by extracting the
brandfield fromget_product_detailsresponses - Build a size-specific availability checker for hard-to-find sizes using the
sizesarray in product detail responses
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Urban Outfitters have an official developer API?+
What does `get_product_details` return for stock information?+
colors array where each entry has a color name and a sizes array. Each size entry includes the size label, a stock value, and an available boolean. This lets you determine, per color and size combination, whether a variant is currently in stock.Does the API return product reviews or ratings?+
Are product descriptions or detailed copy included in any endpoint?+
get_product_details returns structured fields — name, brand, price, URL, and color/size availability — but does not include long-form product description text. You can fork the API on Parse and revise it to add that field to the product detail response.How does pagination work across the listing endpoints?+
search_products and get_category_listing accept a start integer (the zero-based offset) and a size integer (results per page). The total field in each response tells you the full result count, so you can compute how many pages exist and iterate through them with successive start increments.