# Gentle Monster (gentlemonster.com) product data API

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

- Catalog key: `gentlemonster` (pass in `"catalogs"` to narrow a search to this store)
- Products: 1,312
- Snapshot: 2026-10-14T17:09:47Z (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/gentlemonster
- Get an API key: https://platform.storerouter.ai/auth/organization

## Questions

### What does Gentle Monster sell?

Almost entirely Apparel & Accessories: 100% of its 1,312 products. Accessories is the largest department with 1,309 products, followed by Jewelry (3). The most common Gentle Monster categories are Eyewear (1,306), Bag Accessories (3) and Earrings (2).

### How are Gentle Monster products categorized?

Into a shared taxonomy 4 levels deep. The first level separates Apparel & Accessories; the second separates departments such as Accessories; 4 levels down, categories are as specific as Sunglasses (982 products). Every level is a search facet.

### What can I filter Gentle Monster products by?

25 searchable fields. Well-covered attributes include eyewear frame color (99% of products), eyewear frame design (99%) and lens color (97%). For eyewear frame color, the most common values are Black, Clear and Silver; for eyewear frame design, the most common values are Square, Oval and Wrap.

### Is this API provided by Gentle Monster or StoreRouter?

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

### Can I get Gentle Monster 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 Gentle Monster 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 1,312 Gentle Monster products, with coverage counts refreshed about daily.

### Where does the data come from?

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

### Numer 01

Modern Square Sunglasses in Black Acetate

Indexed response retrieved 2026-10-15T08:01:01.892Z. 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": "gentlemonster",
  "product": {
    "title": "Numer 01",
    "brand": {
      "name": "Gentle Monster"
    },
    "productUrl": "https://www.gentlemonster.com/us/en/item/1325XXX46TUNU/numer01",
    "currentPrice": 255,
    "currency": "USD",
    "inStock": true,
    "description": "Modern Square Sunglasses in Black Acetate",
    "primaryImage": {
      "url": "https://gm-prd-resource.gentlemonster.com/catalog/product/1325XXX46TUNU/b8a9e584-3620-4885-b18c-fed935bf3a77/11004379_FRONT.jpg",
      "cdnUrl": "https://cdn.octogen.ai/2e7393a434a56d9d84b5bf5141d00ee5/10cdda01636b7019580178d44c8e437b.webp?request_id=b19a6453-f034-4901-ba74-81ad0b302573",
      "width": 3600,
      "height": 3600,
      "sizeBytes": 41346,
      "mimeType": "image/webp"
    },
    "details": {
      "materials": [
        "Black Acetate"
      ],
      "fit": [
        "NARROWWIDELOWHIGH"
      ],
      "dimensions": null,
      "patterns": []
    }
  }
}
```

### Enrichment

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

```json
{
  "source": "indexed",
  "catalogKey": "gentlemonster",
  "product": {
    "enrichment": {
      "type": "sunglasses",
      "category_path": [
        "Apparel & Accessories",
        "Accessories",
        "Eyewear",
        "Sunglasses"
      ],
      "styles": [
        "modern",
        "minimalist",
        "bold"
      ],
      "attributes": {
        "Pattern": [
          "Solid"
        ],
        "Lens color": [
          "Black"
        ],
        "Lens pattern": [
          "Solid"
        ],
        "Temple color": [
          "Black"
        ],
        "Temple pattern": [
          "Solid"
        ],
        "Eyewear frame color": [
          "Black"
        ],
        "Eyewear frame design": [
          "Square"
        ],
        "Eyewear frame pattern": [
          "Solid"
        ],
        "Eyewear Frame Material": [
          "Acetate"
        ]
      },
      "attribute_handles": {
        "pattern": [
          "pattern__solid"
        ],
        "lens_color": [
          "lens_color__black"
        ],
        "lens_pattern": [
          "lens_pattern__solid"
        ],
        "temple_color": [
          "temple_color__black"
        ],
        "temple_pattern": [
          "temple_pattern__solid"
        ],
        "eyewear_frame_color": [
          "eyewear_frame_color__black"
        ],
        "eyewear_frame_design": [
          "eyewear_frame_design__square"
        ],
        "eyewear_frame_pattern": [
          "eyewear_frame_pattern__solid"
        ],
        "eyewear_frame_material": [
          "eyewear_frame_material__acetate"
        ]
      }
    }
  }
}
```

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

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

- [Numer 01](https://www.gentlemonster.com/us/en/item/1325XXX46TUNU/numer01) — $255.00
- [Ade T1](https://www.gentlemonster.com/us/en/item/S11005277/adet1) — $295.00
- [Sosomo GRC5](https://www.gentlemonster.com/us/en/item/1299UWWYA66F9/sosomogrc5) — $320.00
- [Jade 01(B)](https://www.gentlemonster.com/us/en/item/OHASDDUYUOX6/jade01-b) — $255.00
- [Ninishe RC6](https://www.gentlemonster.com/us/en/item/1AM4WDCR01JP7/ninisherc6) — $305.00

## Categories

| Category | Products |
| --- | --- |
| Eyewear | 1,306 |
| Bag Accessories | 3 |
| Earrings | 2 |
| Other | 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% | 2 | `false` = False, 1,301; `true` = True, 11 |
| `color` | Product color | Merchant data | 100% | 18 | `black` = Black, 567; `white` = White, 319; `brown` = Brown, 275; `gray` = Gray, 273; `silver` = Silver, 172 |
| `color_family` | Color family | Merchant data | 100% | 12 | `Black` = Black, 567; `Gray` = Gray, 425; `White` = White, 338; `Brown` = Brown, 277; `Green` = Green, 160 |
| `age_groups` | Age Group | StoreRouter enrichment | 100% | 1 | `adult` = Adult, 1,312 |
| `category_path.depth_0` | Category at depth 0 | StoreRouter enrichment | 100% | 1 | `apparel & accessories` = Apparel & Accessories, 1,312 |
| `category_path.depth_1` | Category at depth 1 | StoreRouter enrichment | 100% | 2 | `accessories` = Accessories, 1,309; `jewelry` = Jewelry, 3 |
| `category_path.depth_2` | Category at depth 2 | StoreRouter enrichment | 100% | 4 | `eyewear` = Eyewear, 1,306; `bag accessories` = Bag Accessories, 3; `earrings` = Earrings, 2; `other` = Other, 1 |
| `gender` | Gender | StoreRouter enrichment | 100% | 2 | `unisex` = Unisex, 1,304; `female` = Female, 8 |
| `category_path.depth_3` | Category at depth 3 | StoreRouter enrichment | 100% | 4 | `sunglasses` = Sunglasses, 982; `glasses` = Glasses, 324; `bag charms` = Bag Charms, 3; `charms & pendants` = Charms & Pendants, 1 |
| `eyewear_frame_color` | Eyewear frame color | StoreRouter enrichment | 99% | 18 | `eyewear_frame_color__black` = Black, 486; `eyewear_frame_color__clear` = Clear, 221; `eyewear_frame_color__silver` = Silver, 165; `eyewear_frame_color__brown` = Brown, 137; `eyewear_frame_color__gray` = Gray, 131 |
| `eyewear_frame_design` | Eyewear frame design | StoreRouter enrichment | 99% | 7 | `eyewear_frame_design__square` = Square, 517; `eyewear_frame_design__oval` = Oval, 232; `eyewear_frame_design__wrap` = Wrap, 225; `eyewear_frame_design__cat_eye` = Cat Eye, 192; `eyewear_frame_design__round` = Round, 101 |
| `pattern` | Pattern | StoreRouter enrichment | 99% | 12 | `pattern__solid` = Solid, 1,223; `pattern__animal` = Animal, 66; `pattern__ombre` = Ombré, 6; `pattern__texture` = Texture, 5; `pattern__logo` = Logo, 3 |
| `lens_color` | Lens color | StoreRouter enrichment | 97% | 14 | `lens_color__black` = Black, 388; `lens_color__clear` = Clear, 265; `lens_color__gray` = Gray, 235; `lens_color__brown` = Brown, 158; `lens_color__blue` = Blue, 86 |
| `eyewear_frame_pattern` | Eyewear frame pattern | StoreRouter enrichment | 94% | 5 | `eyewear_frame_pattern__solid` = Solid, 1,217; `eyewear_frame_pattern__gradient` = Gradient, 6; `eyewear_frame_pattern__texture` = Texture, 4; `eyewear_frame_pattern__geometric` = Geometric, 1; `eyewear_frame_pattern__logo` = Logo, 1 |
| `temple_color` | Temple color | StoreRouter enrichment | 89% | 18 | `temple_color__black` = Black, 506; `temple_color__clear` = Clear, 178; `temple_color__silver` = Silver, 163; `temple_color__gray` = Gray, 116; `temple_color__brown` = Brown, 115 |
| `eyewear_frame_material` | Eyewear Frame Material | StoreRouter enrichment | 85% | 4 | `eyewear_frame_material__acetate` = Acetate, 873; `eyewear_frame_material__metal` = Metal, 190; `eyewear_frame_material__nylon` = Nylon, 55; `eyewear_frame_material__plastic` = Plastic, 2 |
| `temple_pattern` | Temple pattern | StoreRouter enrichment | 83% | 4 | `temple_pattern__solid` = Solid, 1,088; `temple_pattern__texture` = Texture, 4; `temple_pattern__gradient` = Gradient, 1; `temple_pattern__logo` = Logo, 1 |
| `lens_pattern` | Lens pattern | StoreRouter enrichment | 74% | 2 | `lens_pattern__solid` = Solid, 926; `lens_pattern__gradient` = Gradient, 46 |
| `sustainability_features` | Sustainability Features | StoreRouter enrichment | <1% | 1 | `sustainability_features__recycled_materials` = Recycled Materials, 11 |
| `earring_design` | Earring design | StoreRouter enrichment | <1% | 3 | `earring_design__dangle` = Dangle, 1; `earring_design__drop` = Drop, 1; `earring_design__stud` = Stud, 1 |
| `hardware_finish` | Hardware finish | StoreRouter enrichment | <1% | 1 | `hardware_finish__silver` = Silver, 2 |
| `lens_polarization` | Lens polarization | StoreRouter enrichment | <1% | 1 | `lens_polarization__polarized` = Polarized, 2 |
| `jewelry_material` | Jewelry material | StoreRouter enrichment | <1% | 1 | `jewelry_material__pearl` = Pearl, 1 |
| `material` | Material | StoreRouter enrichment | <1% | 1 | `material__metal` = Metal, 1 |
| `brand_name` | Canonical brand name | Brand | 97% | 8 | `Gentle Monster` = Gentle Monster, 1,061; `Maison Margiela` = Maison Margiela, 122; `Jentle Salon` = Jentle Salon, 53; `KUN` = KUN, 11; `Ambush` = Ambush, 9 |
