# NARS (narscosmetics.com) product data API

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

- Catalog key: `narscosmetics` (pass in `"catalogs"` to narrow a search to this store)
- Products: 155
- Snapshot: 2026-10-14T16:56:55Z (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/narscosmetics
- Get an API key: https://platform.storerouter.ai/auth/organization

## Questions

### What does NARS sell?

Almost entirely Beauty: 98.7% of its 155 products. Makeup is the largest department with 140 products, followed by Skincare (13) and Bags (1). The most common NARS categories are Face (83), Eyes (23) and Lips (21).

### How are NARS products categorized?

Into a shared taxonomy 5 levels deep. The first level separates Beauty, Apparel & Accessories and Media; the second separates departments such as Makeup; 4 levels down, categories are as specific as Blushes & Bronzers (39 products). Every level is a search facet.

### What can I filter NARS products by?

44 searchable fields. Well-covered attributes include product form (66% of products), cosmetic finish (56%) and dispenser type (52%). For product form, the most common values are Pressed Powder, Liquid and Powder; for cosmetic finish, the most common values are Radiant, Matte and Luminous.

### Is this API provided by NARS or StoreRouter?

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

### Can I get NARS 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 NARS 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 155 NARS products, with coverage counts refreshed about daily.

### Where does the data come from?

Straight from narscosmetics.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

### Light Reflecting™ Toning Treatment Lotion

Toner that gently softens by exfoliating, while smoothing and moisturizing.

Indexed response retrieved 2026-10-15T06:19:55.425Z. 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": "narscosmetics",
  "product": {
    "title": "Light Reflecting™ Toning Treatment Lotion",
    "brand": {
      "name": "NARS"
    },
    "productUrl": "https://www.narscosmetics.com/USA/light-reflecting%E2%84%A2-toning-treatment-lotion/0194251039442.html",
    "currentPrice": 39,
    "currency": "USD",
    "inStock": true,
    "description": "Toner that gently softens by exfoliating, while smoothing and moisturizing.",
    "primaryImage": {
      "url": "https://www.narscosmetics.com/dw/image/v2/BBSK_PRD/on/demandware.static/-/Sites-itemmaster_NARS/default/dw66bfc125/2022/February/Nars_Skin_Launch/0194251039442_1.jpg?sw=856&sh=750&sm=fit",
      "cdnUrl": "https://cdn.octogen.ai/20ac60229150356c4089f337fbf441c3/f780ee4de5a6a1fd21bcb444861eebdb.webp?request_id=9261fdae-0378-40d9-9036-cda5c111e071",
      "width": 750,
      "height": 750,
      "sizeBytes": 7632,
      "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": "narscosmetics",
  "product": {
    "enrichment": {
      "type": "toner",
      "category_path": [
        "Beauty",
        "Skincare",
        "Cleansers & Makeup Removal",
        "Toners & Astringents",
        "Toners"
      ],
      "styles": [
        "minimalist",
        "modern"
      ],
      "attributes": {
        "Package type": [
          "Bottle"
        ],
        "Product form": [
          "Liquid",
          "Lotion"
        ],
        "Cosmetic function": [
          "Exfoliating",
          "Moisturizing",
          "Soothing"
        ]
      },
      "attribute_handles": {
        "package_type": [
          "package_type__bottle"
        ],
        "product_form": [
          "product_form__liquid",
          "product_form__lotion"
        ],
        "cosmetic_function": [
          "cosmetic_function__exfoliating",
          "cosmetic_function__moisturizing",
          "cosmetic_function__soothing"
        ]
      }
    }
  }
}
```

## 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": ["narscosmetics"],
    "q": "face",
    "limit": 5
  }'
```

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

- [Light Reflecting™ Toning Treatment Lotion](https://www.narscosmetics.com/USA/light-reflecting%E2%84%A2-toning-treatment-lotion/0194251039442.html) — $39.00
- [Light Reflecting™ Cleansing Oil](https://www.narscosmetics.com/USA/light-reflecting%E2%84%A2-cleansing-oil/0194251148984.html) — $52.00
- [Mini Light Reflecting™ Moisturizer](https://www.narscosmetics.com/USA/mini-light-reflecting%E2%84%A2-moisturizer/0194251139456.html) — $28.50
- [The Dry Skin Set](https://www.narscosmetics.com/USA/the-dry-skin-set/thedryskinset.html) — $44.00
- [Aqua-Infused Makeup Removing Water](https://www.narscosmetics.com/USA/aqua-infused-makeup-removing-water/0607845048374.html) — $23.20

## Categories

| Category | Products |
| --- | --- |
| Face | 83 |
| Eyes | 23 |
| Lips | 21 |
| Makeup Tools | 12 |
| Cleansers & Makeup Removal | 4 |
| Lip Care | 4 |
| Moisturizers & Everyday Care | 4 |
| Finishing | 1 |
| Luggage, Travel & Utility | 1 |
| Print Books | 1 |

## 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 | 99% | 1 | `false` = False, 154 |
| `color` | Product color | Merchant data | 26% | 16 | `black` = Black, 11; `multi` = Multi, 11; `pink` = Pink, 9; `brown` = Brown, 8; `tan` = Tan, 4 |
| `color_family` | Color family | Merchant data | 26% | 8 | `Pink` = Pink, 12; `Black` = Black, 11; `Brown` = Brown, 11; `Multicolor` = Multicolor, 11; `Red` = Red, 4 |
| `category_path.depth_0` | Category at depth 0 | StoreRouter enrichment | 100% | 3 | `beauty` = Beauty, 153; `apparel & accessories` = Apparel & Accessories, 1; `media` = Media, 1 |
| `category_path.depth_1` | Category at depth 1 | StoreRouter enrichment | 100% | 4 | `makeup` = Makeup, 140; `skincare` = Skincare, 13; `bags` = Bags, 1; `books` = Books, 1 |
| `category_path.depth_2` | Category at depth 2 | StoreRouter enrichment | 100% | 11 | `face` = Face, 83; `eyes` = Eyes, 23; `lips` = Lips, 21; `makeup tools` = Makeup Tools, 12; `cleansers & makeup removal` = Cleansers & Makeup Removal, 4 |
| `category_path.depth_3` | Category at depth 3 | StoreRouter enrichment | 99% | 25 | `blushes & bronzers` = Blushes & Bronzers, 39; `foundations & concealers` = Foundations & Concealers, 27; `eye shadows` = Eye Shadows, 12; `lipsticks` = Lipsticks, 12; `brushes & applicators` = Brushes & Applicators, 11 |
| `age_groups` | Age Group | StoreRouter enrichment | 87% | 1 | `adult` = Adult, 135 |
| `gender` | Gender | StoreRouter enrichment | 87% | 2 | `unisex` = Unisex, 109; `female` = Female, 25 |
| `product_form` | Product form | StoreRouter enrichment | 67% | 14 | `product_form__pressed_powder` = Pressed Powder, 44; `product_form__liquid` = Liquid, 28; `product_form__powder` = Powder, 15; `product_form__stick` = Stick, 15; `product_form__cream` = Cream, 14 |
| `cosmetic_finish` | Cosmetic finish | StoreRouter enrichment | 57% | 21 | `cosmetic_finish__radiant` = Radiant, 38; `cosmetic_finish__matte` = Matte, 31; `cosmetic_finish__luminous` = Luminous, 24; `cosmetic_finish__shimmer` = Shimmer, 21; `cosmetic_finish__natural` = Natural, 11 |
| `dispenser_type` | Dispenser type | StoreRouter enrichment | 52% | 10 | `dispenser_type__case` = Case, 27; `dispenser_type__pan` = Pan, 21; `dispenser_type__tube` = Tube, 16; `dispenser_type__bottle` = Bottle, 11; `dispenser_type__stick` = Stick, 10 |
| `makeup_features` | Makeup features | StoreRouter enrichment | 34% | 7 | `makeup_features__long_lasting` = Long Lasting, 36; `makeup_features__high_pigmentation` = High Pigmentation, 16; `makeup_features__hydrating` = Hydrating, 10; `makeup_features__buildable_coverage` = Buildable Coverage, 8; `makeup_features__conditioning` = Conditioning, 2 |
| `pattern` | Pattern | StoreRouter enrichment | 26% | 12 | `pattern__solid` = Solid, 28; `pattern__logo` = Logo, 5; `pattern__floral` = Floral, 4; `pattern__striped` = Striped, 2; `pattern__texture` = Texture, 2 |
| `skin_care_effect` | Skin care effect | StoreRouter enrichment | 19% | 22 | `skin_care_effect__mattifying` = Mattifying, 12; `skin_care_effect__hydrating` = Hydrating, 6; `skin_care_effect__illuminating` = Illuminating, 6; `skin_care_effect__priming` = Priming, 6; `skin_care_effect__smoothing` = Smoothing, 5 |
| `product_benefits` | Product benefits | StoreRouter enrichment | 19% | 6 | `product_benefits__coloring` = Coloring, 16; `product_benefits__bronzing` = Bronzing, 9; `product_benefits__radiant` = Radiant, 8; `product_benefits__highlighting` = Highlighting, 7; `product_benefits__brightening` = Brightening, 3 |
| `category_path.depth_4` | Category at depth 4 | StoreRouter enrichment | 6% | 4 | `mascaras` = Mascaras, 6; `eyelash curlers` = Eyelash Curlers, 1; `makeup bags` = Makeup Bags, 1; `toners` = Toners, 1 |
| `face_powder_type` | Face powder type | StoreRouter enrichment | 6% | 4 | `face_powder_type__setting` = Setting, 9; `face_powder_type__pressed` = Pressed, 5; `face_powder_type__finishing` = Finishing, 4; `face_powder_type__loose` = Loose, 3 |
| `bristle_shape` | Bristle shape | StoreRouter enrichment | 5% | 4 | `bristle_shape__rounded` = Rounded, 4; `bristle_shape__tapered` = Tapered, 2; `bristle_shape__angled` = Angled, 1; `bristle_shape__flat` = Flat, 1 |
| `package_type` | Package type | StoreRouter enrichment | 5% | 6 | `package_type__bottle` = Bottle, 4; `package_type__stick` = Stick, 3; `package_type__box` = Box, 1; `package_type__dispenser` = Dispenser, 1; `package_type__plastic_bottle` = Plastic Bottle, 1 |
| `product_certifications_standards` | Product certifications & standards | StoreRouter enrichment | 5% | 4 | `product_certifications_standards__spf_protection` = SPF Protection, 3; `product_certifications_standards__talc_free` = Talc Free, 2; `product_certifications_standards__eco_friendly` = Eco Friendly, 1; `product_certifications_standards__oil_free` = Oil Free, 1 |
| `mascara_effect` | Mascara effect | StoreRouter enrichment | 3% | 3 | `mascara_effect__volumizing` = Volumizing, 5; `mascara_effect__lengthening` = Lengthening, 2; `mascara_effect__thickening` = Thickening, 2 |
| `suitable_for_skin_tone` | Suitable for skin tone | StoreRouter enrichment | 3% | 2 | `suitable_for_skin_tone__all_skin_tones` = All Skin Tones, 4; `suitable_for_skin_tone__medium_skin` = Medium Skin, 1 |
| `suitable_for_skin_type` | Suitable for skin type | StoreRouter enrichment | 3% | 5 | `suitable_for_skin_type__all_skin_types` = All Skin Types, 2; `suitable_for_skin_type__combination` = Combination, 1; `suitable_for_skin_type__dry` = Dry, 1; `suitable_for_skin_type__normal` = Normal, 1; `suitable_for_skin_type__oily` = Oily, 1 |
| `texture` | Texture | StoreRouter enrichment | 3% | 4 | `texture__smooth` = Smooth, 3; `texture__creamy` = Creamy, 2; `texture__lightweight` = Lightweight, 2; `texture__velvety` = Velvety, 1 |
| `cosmetic_function` | Cosmetic function | StoreRouter enrichment | 2% | 4 | `cosmetic_function__cleansing` = Cleansing, 2; `cosmetic_function__exfoliating` = Exfoliating, 1; `cosmetic_function__moisturizing` = Moisturizing, 1; `cosmetic_function__soothing` = Soothing, 1 |
| `eye_shadow_effect` | Eye shadow effect | StoreRouter enrichment | 2% | 2 | `eye_shadow_effect__glitter` = Glitter, 2; `eye_shadow_effect__metallic` = Metallic, 1 |
| `face_powder_color` | Face powder color | StoreRouter enrichment | 2% | 3 | `face_powder_color__gold` = Gold, 1; `face_powder_color__pink` = Pink, 1; `face_powder_color__white` = White, 1 |
| `bristle_material` | Bristle material | StoreRouter enrichment | 1% | 2 | `bristle_material__natural_bristle` = Natural Bristle, 1; `bristle_material__synthetic_bristle` = Synthetic Bristle, 1 |
| `eyebrow_enhancer_color` | Eyebrow enhancer color | StoreRouter enrichment | 1% | 2 | `eyebrow_enhancer_color__brown` = Brown, 1; `eyebrow_enhancer_color__clear` = Clear, 1 |
| `lip_gloss_effect` | Lip gloss effect | StoreRouter enrichment | 1% | 2 | `lip_gloss_effect__hydrating` = Hydrating, 2; `lip_gloss_effect__mirroring` = Mirroring, 1 |
| `lip_liner_design` | Lip liner design | StoreRouter enrichment | 1% | 1 | `lip_liner_design__retractable` = Retractable, 2 |
| `lipstick_effect` | Lipstick effect | StoreRouter enrichment | 1% | 3 | `lipstick_effect__coloring` = Coloring, 2; `lipstick_effect__conditioning` = Conditioning, 1; `lipstick_effect__hydrating` = Hydrating, 1 |
| `bag_case_material` | Bag/Case material | StoreRouter enrichment | <1% | 1 | `bag_case_material__plastic` = Plastic, 1 |
| `bag_closure_type` | Bag closure type | StoreRouter enrichment | <1% | 1 | `bag_closure_type__zipper` = Zipper, 1 |
| `carry_options` | Carry options | StoreRouter enrichment | <1% | 1 | `carry_options__handle` = Handle, 1 |
| `constitutive_ingredients` | Constitutive ingredients | StoreRouter enrichment | <1% | 1 | `constitutive_ingredients__coconut_oil` = Coconut Oil, 1 |
| `genre` | Genre | StoreRouter enrichment | <1% | 2 | `genre__arts` = Arts, 1; `genre__fashion_beauty` = Fashion & beauty, 1 |
| `graphic_type` | Graphic Type | StoreRouter enrichment | <1% | 1 | `graphic_type__logo_branded` = Logo Print, 1 |
| `hardware_finish` | Hardware finish | StoreRouter enrichment | <1% | 1 | `hardware_finish__silver` = Silver, 1 |
| `skin_tone` | Skin tone | StoreRouter enrichment | <1% | 1 | `skin_tone__medium_skin` = Medium Skin, 1 |
| `sustainability_features` | Sustainability Features | StoreRouter enrichment | <1% | 1 | `sustainability_features__eco_friendly` = Eco-Friendly, 1 |
| `target_audience` | Target audience | StoreRouter enrichment | <1% | 1 | `target_audience__adults` = Adults, 1 |
| `brand_name` | Canonical brand name | Brand | 100% | 1 | `NARS` = NARS, 155 |