# Urban Decay (urbandecay.com) product data API

> Search Urban Decay products with StoreRouter’s API. Get prices, images, and details as JSON. See coverage and curl, Python, and TypeScript examples.

- Catalog key: `urbandecay` (pass in `"catalogs"` to narrow a search to this store)
- Products: 44
- Snapshot: 2026-10-14T16:57:15Z (counts are approximate and refreshed about daily)
- Search endpoint: `POST https://api.storerouter.ai/v1/products/search`
- Human page: https://storerouter.ai/catalog-coverage/stores/urbandecay
- Get an API key: https://platform.storerouter.ai/auth/organization

## Questions

### What does Urban Decay sell?

Almost entirely Beauty: 100% of its 44 products. Makeup is the largest department with 44 products. The most common Urban Decay categories are Eyes (26), Face (11) and Lips (7).

### How are Urban Decay products categorized?

Into a shared taxonomy 5 levels deep. The first level separates Beauty; the second separates departments such as Makeup; 4 levels down, categories are as specific as Eye Shadows (11 products). Every level is a search facet.

### What can I filter Urban Decay products by?

32 searchable fields. Well-covered attributes include makeup features (77% of products), product form (70%) and cosmetic finish (61%). For makeup features, the most common values are Long Lasting, Waterproof and High Pigmentation; for product form, the most common values are Liquid, Pressed Powder and Pencil.

### Is this API provided by Urban Decay or StoreRouter?

StoreRouter. One API key gives your app or agent access to Urban Decay product data and thousands more stores.

### Can I get Urban Decay product prices and stock status?

Yes. Bring pricing and availability into your shopping experience with structured data for selling prices, original prices, currency, and stock status.

### Can I get sizes and variants for Urban Decay products?

Yes. Help shoppers find their perfect match with size, color, SKU, and stock details from product lookup.

### How fresh is the data?

StoreRouter continually recrawls product pages to update product details. This page tracks 44 Urban Decay products, with coverage counts refreshed about daily.

### Where does the data come from?

Straight from urbandecay.com. StoreRouter turns product pages into rich, searchable data—organized into consistent categories and attributes so your app can connect shoppers with the right products.

## Example product

### Lip Toy pH Staining Lip Oil

Hybrid lip-caring oil with up to 24 hours of hydration + a long-lasting pH-reactive stain.

Indexed response retrieved 2026-10-15T06:20:14.080Z. Price and availability may change.
Availability: In stock

### Product details

Product content returned by the lookup API, ready for a product page.

```json
{
  "source": "indexed",
  "catalogKey": "urbandecay",
  "product": {
    "title": "Lip Toy pH Staining Lip Oil",
    "brand": {
      "name": "Urban Decay"
    },
    "productUrl": "https://www.urbandecay.com/lips/lip-toy-ph-staining-lip-oil/ud1313.html",
    "currentPrice": 24,
    "currency": "USD",
    "inStock": true,
    "description": "Hybrid lip-caring oil with up to 24 hours of hydration + a long-lasting pH-reactive stain.",
    "primaryImage": {
      "url": "https://www.urbandecay.com/dw/image/v2/AAFM_PRD/on/demandware.static/-/Sites-urbandecay-master-catalog/default/dwf4c0d319/ProductImages/Lips/ud1313/Lip%20Toy%20Launch%20PDP%20Assets/3605973103078,%20Caked%20Up/ALT0-3605973103078--PACKSHOT.jpg",
      "cdnUrl": "https://cdn.octogen.ai/b004de2c1bc5614853005946ffd21c22/955602c05a161b957e1bfcc7500a9214.webp?request_id=db915677-fde8-43c3-aaf7-ccb79c005a51",
      "width": 2000,
      "height": 2000,
      "sizeBytes": 74988,
      "mimeType": "image/webp"
    },
    "details": {
      "materials": [],
      "fit": [],
      "dimensions": null,
      "patterns": []
    }
  }
}
```

### Enrichment

StoreRouter classification and attributes. Use attribute_handles as search facet values.

```json
{
  "source": "indexed",
  "catalogKey": "urbandecay",
  "product": {
    "enrichment": {
      "type": "lip oil",
      "category_path": [
        "Beauty",
        "Makeup",
        "Lips",
        "Lip & Cheek Stains"
      ],
      "styles": [
        "cosmetic"
      ],
      "attributes": {
        "Cosmetic finish": [
          "Glossy"
        ],
        "Makeup features": [
          "Conditioning",
          "Hydrating",
          "Long Lasting",
          "Moisturizing"
        ]
      },
      "attribute_handles": {
        "cosmetic_finish": [
          "cosmetic_finish__glossy"
        ],
        "makeup_features": [
          "makeup_features__conditioning",
          "makeup_features__hydrating",
          "makeup_features__long_lasting",
          "makeup_features__moisturizing"
        ]
      }
    }
  }
}
```

## Query this store

```bash
curl -sS https://api.storerouter.ai/v1/products/search \
  -H "Authorization: Bearer $OCTOGEN_PLATFORM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "catalogs": ["urbandecay"],
    "limit": 5
  }'
```

Selected matching products on October 15, 2026 (not the complete search response):

- [Lip Toy pH Staining Lip Oil](https://www.urbandecay.com/lips/lip-toy-ph-staining-lip-oil/ud1313.html) — $24.00
- [Naked3 Soft Pink Eyeshadow Palette](https://www.urbandecay.com/naked-3-palette-by-urban-decay/409.html) — $59.00
- [24/7 Shadow](https://www.urbandecay.com/urban-decay-eyeshadow-singles-24-7-shadow/ud1053.html) — $23.00
- [24/7 Waterproof Waterline Eyeliner Pencil](https://www.urbandecay.com/24-7-waterline-eye-pencil-by-urban-decay/UD607.html) — $23.00
- [Moondust Liquid Glitter Eyeliner](https://www.urbandecay.com/eyes/eyeliner/moondust-liquid-glitter-eyeliner/ud1270.html) — $28.00

## Categories

| Category | Products |
| --- | --- |
| Eyes | 26 |
| Face | 11 |
| Lips | 7 |

## Searchable fields

Use `name` and a `value` as a facet: `{"name": "<name>", "values": ["<value>"]}`.

| name | Field | Source | Coverage | Distinct values | Top values (`value` = label, products) |
| --- | --- | --- | --- | --- | --- |
| `is_activewear` | Activewear | Merchant data | 100% | 1 | `false` = False, 44 |
| `color` | Product color | Merchant data | 52% | 31 | `brown` = Brown, 7; `black` = Black, 6; `multi` = Multi, 5; `pink` = Pink, 4; `red` = Red, 4 |
| `color_family` | Color family | Merchant data | 52% | 12 | `Brown` = Brown, 9; `Black` = Black, 6; `Red` = Red, 6; `Multicolor` = Multicolor, 5; `Purple` = Purple, 5 |
| `category_path.depth_0` | Category at depth 0 | StoreRouter enrichment | 100% | 1 | `beauty` = Beauty, 44 |
| `category_path.depth_1` | Category at depth 1 | StoreRouter enrichment | 100% | 1 | `makeup` = Makeup, 44 |
| `category_path.depth_2` | Category at depth 2 | StoreRouter enrichment | 100% | 3 | `eyes` = Eyes, 26; `face` = Face, 11; `lips` = Lips, 7 |
| `category_path.depth_3` | Category at depth 3 | StoreRouter enrichment | 100% | 15 | `eye shadows` = Eye Shadows, 11; `eyeliner` = Eyeliner, 7; `brow products` = Brow Products, 3; `face primers` = Face Primers, 3; `foundations & concealers` = Foundations & Concealers, 3 |
| `age_groups` | Age Group | StoreRouter enrichment | 89% | 1 | `adult` = Adult, 39 |
| `gender` | Gender | StoreRouter enrichment | 89% | 2 | `unisex` = Unisex, 37; `female` = Female, 2 |
| `makeup_features` | Makeup features | StoreRouter enrichment | 77% | 12 | `makeup_features__long_lasting` = Long Lasting, 24; `makeup_features__waterproof` = Waterproof, 12; `makeup_features__high_pigmentation` = High Pigmentation, 8; `makeup_features__hydrating` = Hydrating, 6; `makeup_features__easy_to_apply` = Easy to Apply, 4 |
| `product_form` | Product form | StoreRouter enrichment | 71% | 10 | `product_form__liquid` = Liquid, 12; `product_form__pressed_powder` = Pressed Powder, 8; `product_form__pencil` = Pencil, 5; `product_form__brush_on` = Brush-On, 4; `product_form__stick` = Stick, 3 |
| `cosmetic_finish` | Cosmetic finish | StoreRouter enrichment | 61% | 17 | `cosmetic_finish__matte` = Matte, 12; `cosmetic_finish__shimmer` = Shimmer, 10; `cosmetic_finish__metallic` = Metallic, 5; `cosmetic_finish__dewy` = Dewy, 4; `cosmetic_finish__glitter` = Glitter, 4 |
| `dispenser_type` | Dispenser type | StoreRouter enrichment | 46% | 6 | `dispenser_type__tube` = Tube, 9; `dispenser_type__pencil` = Pencil, 5; `dispenser_type__pump_bottle` = Pump Bottle, 3; `dispenser_type__case` = Case, 2; `dispenser_type__bottle` = Bottle, 1 |
| `product_certifications_standards` | Product certifications & standards | StoreRouter enrichment | 21% | 2 | `product_certifications_standards__vegan` = Vegan, 7; `product_certifications_standards__cruelty_free` = Cruelty Free, 3 |
| `sustainability_features` | Sustainability Features | StoreRouter enrichment | 21% | 2 | `sustainability_features__vegan` = Vegan, 7; `sustainability_features__cruelty_free` = Cruelty-Free, 3 |
| `skin_care_effect` | Skin care effect | StoreRouter enrichment | 16% | 9 | `skin_care_effect__priming` = Priming, 5; `skin_care_effect__smoothing` = Smoothing, 3; `skin_care_effect__hydrating` = Hydrating, 2; `skin_care_effect__mattifying` = Mattifying, 2; `skin_care_effect__anti_aging` = Anti Aging, 1 |
| `eye_shadow_effect` | Eye shadow effect | StoreRouter enrichment | 14% | 3 | `eye_shadow_effect__metallic` = Metallic, 4; `eye_shadow_effect__glitter` = Glitter, 2; `eye_shadow_effect__smoky` = Smoky, 1 |
| `pattern` | Pattern | StoreRouter enrichment | 11% | 2 | `pattern__solid` = Solid, 5; `pattern__text` = Text, 1 |
| `category_path.depth_4` | Category at depth 4 | StoreRouter enrichment | 7% | 1 | `mascaras` = Mascaras, 3 |
| `eyebrow_enhancer_color` | Eyebrow enhancer color | StoreRouter enrichment | 7% | 3 | `eyebrow_enhancer_color__black` = Black, 2; `eyebrow_enhancer_color__brown` = Brown, 2; `eyebrow_enhancer_color__clear` = Clear, 1 |
| `mascara_effect` | Mascara effect | StoreRouter enrichment | 7% | 4 | `mascara_effect__lengthening` = Lengthening, 2; `mascara_effect__volumizing` = Volumizing, 2; `mascara_effect__coloring` = Coloring, 1; `mascara_effect__definition` = Definition, 1 |
| `face_powder_type` | Face powder type | StoreRouter enrichment | 5% | 3 | `face_powder_type__setting` = Setting, 2; `face_powder_type__finishing` = Finishing, 1; `face_powder_type__pressed` = Pressed, 1 |
| `lip_liner_design` | Lip liner design | StoreRouter enrichment | 5% | 2 | `lip_liner_design__brush` = Brush, 1; `lip_liner_design__retractable` = Retractable, 1 |
| `product_benefits` | Product benefits | StoreRouter enrichment | 5% | 2 | `product_benefits__coloring` = Coloring, 1; `product_benefits__hydrating` = Hydrating, 1 |
| `skin_tone` | Skin tone | StoreRouter enrichment | 5% | 5 | `skin_tone__deep_skin` = Deep Skin, 2; `skin_tone__fair_skin` = Fair Skin, 2; `skin_tone__light_skin` = Light Skin, 2; `skin_tone__medium_skin` = Medium Skin, 2; `skin_tone__dark_skin` = Dark Skin, 1 |
| `suitable_for_skin_tone` | Suitable for skin tone | StoreRouter enrichment | 5% | 5 | `suitable_for_skin_tone__all_skin_tones` = All Skin Tones, 1; `suitable_for_skin_tone__deep_skin` = Deep Skin, 1; `suitable_for_skin_tone__fair_skin` = Fair Skin, 1; `suitable_for_skin_tone__light_skin` = Light Skin, 1; `suitable_for_skin_tone__medium_skin` = Medium Skin, 1 |
| `texture` | Texture | StoreRouter enrichment | 5% | 2 | `texture__creamy` = Creamy, 1; `texture__smooth` = Smooth, 1 |
| `lip_gloss_effect` | Lip gloss effect | StoreRouter enrichment | 2% | 1 | `lip_gloss_effect__hydrating` = Hydrating, 1 |
| `lipstick_effect` | Lipstick effect | StoreRouter enrichment | 2% | 2 | `lipstick_effect__hydrating` = Hydrating, 1; `lipstick_effect__moisturizing` = Moisturizing, 1 |
| `skin_undertone` | Skin undertone | StoreRouter enrichment | 2% | 3 | `skin_undertone__cool` = Cool, 1; `skin_undertone__neutral` = Neutral, 1; `skin_undertone__warm` = Warm, 1 |
| `suitable_for_skin_type` | Suitable for skin type | StoreRouter enrichment | 2% | 1 | `suitable_for_skin_type__universal` = Universal, 1 |
| `brand_name` | Canonical brand name | Brand | 100% | 1 | `Urban Decay` = Urban Decay, 44 |