# Cosrx (cosrx.com) product data API

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

- Catalog key: `cosrx` (pass in `"catalogs"` to narrow a search to this store)
- Products: 144
- Snapshot: 2026-10-15T10:37:24Z (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/cosrx
- Get an API key: https://platform.storerouter.ai/auth/organization

## Questions

### What does Cosrx sell?

Almost entirely Beauty: 100% of its 144 products. Skincare is the largest department with 134 products, followed by Hair Care (9) and Makeup (1). The most common Cosrx categories are Cleansers & Makeup Removal (36), Targeted Treatments (32) and Masks & Peels (28).

### How are Cosrx products categorized?

Into a shared taxonomy 6 levels deep. The first level separates Beauty; the second separates departments such as Skincare; 5 levels down, categories are as specific as Toners (16 products). Every level is a search facet.

### What can I filter Cosrx products by?

37 searchable fields. Well-covered attributes include product form (62% of products), constitutive ingredients (55%) and skin care effect (52%). For product form, the most common values are Cream, Serum and Liquid; for constitutive ingredients, the most common values are Hyaluronic Acid, Collagen and Vitamin E.

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

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

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

### Where does the data come from?

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

### ($100+ Free Gift) COSRX The Alpha-Arbutin Discoloration Care Hydrogel Mask_1ea

Free gift orders $100+

Indexed response retrieved 2026-10-15T12:21:38.045Z. 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": "cosrx",
  "product": {
    "title": "($100+ Free Gift) COSRX The Alpha-Arbutin Discoloration Care Hydrogel Mask_1ea",
    "brand": {
      "name": "COSRX"
    },
    "productUrl": "https://www.cosrx.com/products/100-free-gift-cosrx-the-alpha-arbutin-discoloration-care-hydrogel-mask_1ea",
    "currentPrice": 6.99,
    "currency": "USD",
    "inStock": true,
    "description": "Free gift orders $100+",
    "primaryImage": {
      "url": "https://cdn.shopify.com/s/files/1/0513/3775/6828/files/250407_HydrogelMask4457_R1.webp?v=1758260393",
      "cdnUrl": "https://cdn.octogen.ai/23b7552c56ad5c190da82e2a4af5768e/5623508b7bcc7a42eed8a59c38aa49f4.webp?request_id=cd2fadb8-1cf4-47f1-9b5d-ad8429f1752c",
      "width": 4044,
      "height": 6044,
      "sizeBytes": 391438,
      "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": "cosrx",
  "product": {
    "enrichment": {
      "type": "hydrogel mask",
      "category_path": [
        "Beauty",
        "Skincare",
        "Masks & Peels"
      ],
      "styles": [
        "minimalist"
      ],
      "attributes": {
        "Skin care effect": [
          "Anti Dark Spot",
          "Brightening",
          "Hydrating",
          "Uneven Skin Tone"
        ],
        "Skin care mask type": [
          "Sheet"
        ],
        "Constitutive ingredients": [
          "Collagen"
        ]
      },
      "attribute_handles": {
        "skin_care_effect": [
          "skin_care_effect__anti_dark_spot",
          "skin_care_effect__brightening",
          "skin_care_effect__hydrating",
          "skin_care_effect__uneven_skin_tone"
        ],
        "skin_care_mask_type": [
          "skin_care_mask_type__sheet"
        ],
        "constitutive_ingredients": [
          "constitutive_ingredients__collagen"
        ]
      }
    }
  }
}
```

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

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

- [($100+ Free Gift) COSRX The Alpha-Arbutin Discoloration Care Hydrogel Mask_1ea](https://www.cosrx.com/products/100-free-gift-cosrx-the-alpha-arbutin-discoloration-care-hydrogel-mask_1ea) — $6.99
- [(Free Gift) COSRX The Peptide Collagen Lifting Glow Hydrogel Mask_1ea](https://www.cosrx.com/products/free-gift-cosrx-the-peptide-collagen-lifting-glow-hydrogel-mask_1ea-1) — $6.99
- [($80+ Free Gift) Full Fit Propolis Nourishing Magnet Sheet Mask (1ea)](https://www.cosrx.com/products/80-free-gift-full-fit-propolis-nourishing-magnet-sheet-mask-1ea) — $6.99
- [PDRN Premium Routine Kit](https://www.cosrx.com/products/pdrn-premium-routine-kit) — $89.25
- [Clear Fit Master Patch](https://www.cosrx.com/products/clear-fit-master-patch) — $4.20

## Categories

| Category | Products |
| --- | --- |
| Cleansers & Makeup Removal | 36 |
| Targeted Treatments | 32 |
| Masks & Peels | 28 |
| Moisturizers & Everyday Care | 28 |
| Sun & Body Protection | 7 |
| Shampoo & Conditioner | 5 |
| Lip Care | 3 |
| Treatments & Solutions | 3 |
| Lips | 1 |
| Tools & Accessories | 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 | 100% | 1 | `false` = False, 144 |
| `color` | Product color | Merchant data | <1% | 5 | `black` = Black, 1; `brown` = Brown, 1; `peachpuff` = Peachpuff, 1; `purple` = Purple, 1; `red` = Red, 1 |
| `color_family` | Color family | Merchant data | <1% | 5 | `Black` = Black, 1; `Brown` = Brown, 1; `Orange` = Orange, 1; `Purple` = Purple, 1; `Red` = Red, 1 |
| `category_path.depth_0` | Category at depth 0 | StoreRouter enrichment | 100% | 1 | `beauty` = Beauty, 144 |
| `category_path.depth_1` | Category at depth 1 | StoreRouter enrichment | 100% | 3 | `skincare` = Skincare, 134; `hair care` = Hair Care, 9; `makeup` = Makeup, 1 |
| `category_path.depth_2` | Category at depth 2 | StoreRouter enrichment | 100% | 10 | `cleansers & makeup removal` = Cleansers & Makeup Removal, 36; `targeted treatments` = Targeted Treatments, 32; `masks & peels` = Masks & Peels, 28; `moisturizers & everyday care` = Moisturizers & Everyday Care, 28; `sun & body protection` = Sun & Body Protection, 7 |
| `category_path.depth_3` | Category at depth 3 | StoreRouter enrichment | 81% | 18 | `face moisturizers` = Face Moisturizers, 24; `anti-aging skin care` = Anti-Aging Skin Care, 19; `toners & astringents` = Toners & Astringents, 16; `acne treatments & kits` = Acne Treatments & Kits, 13; `facial cleansing kits` = Facial Cleansing Kits, 13 |
| `product_form` | Product form | StoreRouter enrichment | 63% | 12 | `product_form__cream` = Cream, 31; `product_form__serum` = Serum, 31; `product_form__liquid` = Liquid, 20; `product_form__gel` = Gel, 8; `product_form__pads` = Pads, 8 |
| `constitutive_ingredients` | Constitutive ingredients | StoreRouter enrichment | 56% | 21 | `constitutive_ingredients__hyaluronic_acid` = Hyaluronic Acid, 36; `constitutive_ingredients__collagen` = Collagen, 23; `constitutive_ingredients__vitamin_e` = Vitamin E, 12; `constitutive_ingredients__water` = Water, 9; `constitutive_ingredients__salicylic_acid` = Salicylic Acid, 8 |
| `skin_care_effect` | Skin care effect | StoreRouter enrichment | 52% | 42 | `skin_care_effect__hydrating` = Hydrating, 52; `skin_care_effect__firming` = Firming, 31; `skin_care_effect__smoothing` = Smoothing, 31; `skin_care_effect__moisturizing` = Moisturizing, 25; `skin_care_effect__brightening` = Brightening, 20 |
| `age_groups` | Age Group | StoreRouter enrichment | 47% | 1 | `adult` = Adult, 67 |
| `gender` | Gender | StoreRouter enrichment | 46% | 1 | `unisex` = Unisex, 66 |
| `suitable_for_skin_type` | Suitable for skin type | StoreRouter enrichment | 37% | 10 | `suitable_for_skin_type__sensitive` = Sensitive, 25; `suitable_for_skin_type__dry` = Dry, 17; `suitable_for_skin_type__all_skin_types` = All Skin Types, 12; `suitable_for_skin_type__aging` = Aging, 7; `suitable_for_skin_type__problem` = Problem, 5 |
| `package_type` | Package type | StoreRouter enrichment | 32% | 13 | `package_type__bottle` = Bottle, 25; `package_type__tube` = Tube, 16; `package_type__jar` = Jar, 15; `package_type__squeeze_tube` = Squeeze Tube, 14; `package_type__pump_bottle` = Pump Bottle, 11 |
| `product_certifications_standards` | Product certifications & standards | StoreRouter enrichment | 22% | 9 | `product_certifications_standards__sensitive_skin` = Sensitive Skin, 19; `product_certifications_standards__spf_protection` = SPF Protection, 7; `product_certifications_standards__natural_ingredients` = Natural Ingredients, 2; `product_certifications_standards__oil_free` = Oil Free, 2; `product_certifications_standards__alcohol_free` = Alcohol Free, 1 |
| `cosmetic_function` | Cosmetic function | StoreRouter enrichment | 13% | 11 | `cosmetic_function__hydrating` = Hydrating, 12; `cosmetic_function__hydration` = Hydration, 8; `cosmetic_function__brightening` = Brightening, 5; `cosmetic_function__cleansing` = Cleansing, 5; `cosmetic_function__exfoliating` = Exfoliating, 5 |
| `skin_care_features` | Skin care features | StoreRouter enrichment | 13% | 8 | `skin_care_features__soothing` = Soothing, 7; `skin_care_features__uva/uvb_protection` = Uva/Uvb Protection, 7; `skin_care_features__easy_to_apply` = Easy to Apply, 6; `skin_care_features__non_greasy` = Non Greasy, 4; `skin_care_features__moisturizing` = Moisturizing, 2 |
| `skin_care_mask_type` | Skin care mask type | StoreRouter enrichment | 13% | 3 | `skin_care_mask_type__sheet` = Sheet, 13; `skin_care_mask_type__sleeping` = Sleeping, 3; `skin_care_mask_type__peel_off` = Peel Off, 2 |
| `category_path.depth_4` | Category at depth 4 | StoreRouter enrichment | 12% | 2 | `toners` = Toners, 16; `combs & brushes` = Combs & Brushes, 1 |
| `active_ingredient` | Active ingredient | StoreRouter enrichment | 10% | 7 | `active_ingredient__hyaluronic_acid` = Hyaluronic Acid, 9; `active_ingredient__ceramides` = Ceramides, 7; `active_ingredient__peptides` = Peptides, 3; `active_ingredient__green_tea_extract` = Green Tea Extract, 2; `active_ingredient__niacinamide` = Niacinamide, 2 |
| `dispenser_type` | Dispenser type | StoreRouter enrichment | 7% | 5 | `dispenser_type__tube` = Tube, 5; `dispenser_type__pump_bottle` = Pump Bottle, 3; `dispenser_type__stick` = Stick, 3; `dispenser_type__jar` = Jar, 2; `dispenser_type__box` = Box, 1 |
| `suitable_for_hair_type` | Suitable for hair type | StoreRouter enrichment | 6% | 4 | `suitable_for_hair_type__damaged` = Damaged, 8; `suitable_for_hair_type__frizzy` = Frizzy, 6; `suitable_for_hair_type__dull` = Dull, 4; `suitable_for_hair_type__all_hair_types` = All Hair Types, 1 |
| `application_area` | Application area | StoreRouter enrichment | 5% | 2 | `application_area__face` = Face, 7; `application_area__full_body` = Full Body, 1 |
| `anti_aging_skin_care_type` | Anti-aging Skin Care Type | StoreRouter enrichment | 3% | 3 | `anti_aging_skin_care_type__eye_treatment` = Eye Treatment, 3; `anti_aging_skin_care_type__mask` = Mask, 1; `anti_aging_skin_care_type__toner` = Toner, 1 |
| `hair_care_items_included` | Hair care items included | StoreRouter enrichment | 2% | 5 | `hair_care_items_included__hair_serum` = Hair Serum, 3; `hair_care_items_included__shampoo` = Shampoo, 3; `hair_care_items_included__conditioner` = Conditioner, 1; `hair_care_items_included__hair_oil` = Hair Oil, 1; `hair_care_items_included__straightening_treatment` = Straightening Treatment, 1 |
| `moisturizer_type` | Moisturizer type | StoreRouter enrichment | 2% | 1 | `moisturizer_type__all_day` = All Day, 3 |
| `treatment_type` | Treatment type | StoreRouter enrichment | 2% | 1 | `treatment_type__topical` = Topical, 3 |
| `sustainability_features` | Sustainability Features | StoreRouter enrichment | 1% | 2 | `sustainability_features__eco_friendly` = Eco-Friendly, 1; `sustainability_features__vegan` = Vegan, 1 |
| `category_path.depth_5` | Category at depth 5 | StoreRouter enrichment | <1% | 1 | `paddle hairbrushes` = Paddle Hairbrushes, 1 |
| `cosmetic_finish` | Cosmetic finish | StoreRouter enrichment | <1% | 2 | `cosmetic_finish__glossy` = Glossy, 1; `cosmetic_finish__sheer` = Sheer, 1 |
| `lip_gloss_effect` | Lip gloss effect | StoreRouter enrichment | <1% | 3 | `lip_gloss_effect__glowing` = Glowing, 1; `lip_gloss_effect__plumping` = Plumping, 1; `lip_gloss_effect__volumizing` = Volumizing, 1 |
| `makeup_features` | Makeup features | StoreRouter enrichment | <1% | 1 | `makeup_features__contains_vitamins` = Contains Vitamins, 1 |
| `material` | Material | StoreRouter enrichment | <1% | 1 | `material__wood` = Wood, 1 |
| `pattern` | Pattern | StoreRouter enrichment | <1% | 1 | `pattern__solid` = Solid, 1 |
| `scent` | Scent | StoreRouter enrichment | <1% | 4 | `scent__cherry` = Cherry, 1; `scent__cinnamon` = Cinnamon, 1; `scent__fruity` = Fruity, 1; `scent__strawberry` = Strawberry, 1 |
| `shampoo_conditioner_effect` | Shampoo/Conditioner effect | StoreRouter enrichment | <1% | 5 | `shampoo_conditioner_effect__anti_frizz` = Anti-Frizz, 1; `shampoo_conditioner_effect__repair` = Repair, 1; `shampoo_conditioner_effect__shine` = Shine, 1; `shampoo_conditioner_effect__smoothing` = Smoothing, 1; `shampoo_conditioner_effect__strengthening` = Strengthening, 1 |
| `brand_name` | Canonical brand name | Brand | 100% | 1 | `COSRX` = COSRX, 144 |