# Blissdiamond (blissdiamond.com) product data API

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

- Catalog key: `blissdiamond` (pass in `"catalogs"` to narrow a search to this store)
- Products: 5,125
- Snapshot: 2026-10-19T16:52:41Z (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/blissdiamond
- Get an API key: https://platform.storerouter.ai/auth/organization

## Questions

### What does Blissdiamond sell?

Almost entirely Apparel & Accessories: 100% of its 5,125 products. Jewelry is the largest department with 5,124 products, followed by Bags (1). The most common Blissdiamond categories are Rings (2,505), Necklaces (906) and Bracelets (894).

### How are Blissdiamond products categorized?

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

### What can I filter Blissdiamond products by?

23 searchable fields. Well-covered attributes include jewelry material (100% of products), ring design (46%) and necklace design (17%). For jewelry material, the most common values are White Gold, Diamond and Gold; for ring design, the most common values are Band, Row and Solitaire.

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

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

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

### Where does the data come from?

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

### 3 Ct Diamond Engagement Wedding Ring Set 14k White Gold

Classic women's engagement ring features a 1 1/3ct round brilliant cut genuine enhanced diamond and round cut accent diamonds.  All diamonds are prong set in solid 14k white gold delicate mounting.  Matching wedding ring is included.  The diamonds on the band are touch bigger to give the ring a unique but matching contrast look.  Item #: ENGS6213  Width: 2 mm  Weight: 5 g  Metal: 14k White Gold  Diamond Color: G/H  Diamond Clarity: SI1-SI2  Diamond Quantity: 30  Diamond Setting: Prong

Indexed response retrieved 2026-10-20T05:53:53.532Z. Price and availability may change.
Availability: In stock
Sizes: 4, 4.5, 5, 5.5, 6, 6.5, 7, 7.5, 8, 8.5, 9

### Product details

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

```json
{
  "source": "indexed",
  "catalogKey": "blissdiamond",
  "product": {
    "title": "3 Ct Diamond Engagement Wedding Ring Set 14k White Gold",
    "brand": {
      "name": "bliss diamond"
    },
    "productUrl": "https://www.blissdiamond.com/products/3-ct-round-cut-diamond-engagement-wedding-ring-set-g-si-14k-white-gold-enhanced",
    "currentPrice": 3354.11,
    "currency": "USD",
    "inStock": true,
    "description": "Classic women's engagement ring features a 1 1/3ct round brilliant cut genuine enhanced diamond and round cut accent diamonds.  All diamonds are prong set in solid 14k white gold delicate mounting.  Matching wedding ring is included.  The diamonds on the band are touch bigger to give the ring a unique but matching contrast look.  Item #: ENGS6213  Width: 2 mm  Weight: 5 g  Metal: 14k White Gold  Diamond Color: G/H  Diamond Clarity: SI1-SI2  Diamond Quantity: 30  Diamond Setting: Prong ",
    "primaryImage": {
      "url": "https://cdn.shopify.com/s/files/1/1555/1807/files/engs6213...11.jpg?v=1791905227",
      "cdnUrl": "https://cdn.octogen.ai/5cf40bb3437f57daf92e33d4795e0cc5/14be33d2cb18f876d03ec03e1ffebc5f.webp?request_id=9ffc645a-5ad8-4c4a-91d3-7968ca1939fd",
      "width": 1254,
      "height": 1254,
      "sizeBytes": 191690,
      "mimeType": "image/webp"
    },
    "details": {
      "materials": [
        "14k White Gold"
      ],
      "fit": [],
      "dimensions": null,
      "patterns": []
    }
  }
}
```

### Enrichment

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

```json
{
  "source": "indexed",
  "catalogKey": "blissdiamond",
  "product": {
    "enrichment": {
      "type": "engagement ring set",
      "category_path": [
        "Apparel & Accessories",
        "Jewelry",
        "Rings"
      ],
      "styles": [
        "classic",
        "elegant",
        "formal"
      ],
      "attributes": {
        "Ring design": [
          "Band",
          "Eternity",
          "Solitaire"
        ],
        "Jewelry type": [
          "Fine Jewelry"
        ],
        "Jewelry material": [
          "Diamond",
          "White Gold"
        ]
      },
      "attribute_handles": {
        "ring_design": [
          "ring_design__band",
          "ring_design__eternity",
          "ring_design__solitaire"
        ],
        "jewelry_type": [
          "jewelry_type__fine_jewelry"
        ],
        "jewelry_material": [
          "jewelry_material__diamond",
          "jewelry_material__white_gold"
        ]
      }
    }
  }
}
```

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

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

- [3 Ct Diamond Engagement Wedding Ring Set 14k White Gold](https://www.blissdiamond.com/products/3-ct-round-cut-diamond-engagement-wedding-ring-set-g-si-14k-white-gold-enhanced) — $3,354.11
- [5 1/2Ct Oval Diamond Engagement Eternity Wedding Ring Set White Gold Lab Grown](https://www.blissdiamond.com/products/5-1-2ct-oval-diamond-engagement-eternity-wedding-ring-set-white-gold-lab-grown) — $3,387.99
- [1 1/2ct Black Diamond Eternity Ring 14k Yellow Gold Womens Stackable Band](https://www.blissdiamond.com/products/1-1-2ct-black-diamond-eternity-ring-14k-yellow-gold-womens-stackable-band-heated) — $605.00
- [Mens Black Diamond White Gold Ring Brushed Wedding Band](https://www.blissdiamond.com/products/mens-black-diamond-wedding-anniversary-brushed-ring-14k-white-gold) — $629.19
- [6 1/5 Ct Huge Diamond Oval Blue Sapphire Diamond Double Halo Ring Yellow Gold](https://www.blissdiamond.com/products/6-1-5-ct-huge-diamond-oval-blue-sapphire-diamond-double-halo-ring-yellow-gold) — $1,270.49

## Prices

Median price $1,016 across 5,125 priced products. Current prices, assumed USD.

| Price range | Products |
| --- | --- |
| $0–$1,250 | 2,982 |
| $1,250–$2,500 | 1,039 |
| $2,500–$3,750 | 283 |
| $3,750–$5,000 | 238 |
| $5,000–$6,250 | 152 |
| $6,250–$7,500 | 128 |
| $7,500 and up | 303 |

## Categories

| Category | Products |
| --- | --- |
| Rings | 2,505 |
| Necklaces | 906 |
| Bracelets | 894 |
| Earrings | 691 |
| Other | 110 |
| Cufflinks & Button Studs | 18 |
| Specialty Bags | 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, 5,125 |
| `color` | Product color | Merchant data | 93% | 17 | `white` = White, 3,585; `gold` = Gold, 2,289; `silver` = Silver, 995; `yellow` = Yellow, 636; `salmon` = Salmon, 606 |
| `color_family` | Color family | Merchant data | 93% | 9 | `White` = White, 3,585; `Yellow` = Yellow, 2,923; `Pink` = Pink, 1,115; `Gray` = Gray, 995; `Orange` = Orange, 394 |
| `category_path.depth_0` | Category at depth 0 | StoreRouter enrichment | 100% | 1 | `apparel & accessories` = Apparel & Accessories, 5,125 |
| `category_path.depth_1` | Category at depth 1 | StoreRouter enrichment | 100% | 2 | `jewelry` = Jewelry, 5,124; `bags` = Bags, 1 |
| `category_path.depth_2` | Category at depth 2 | StoreRouter enrichment | 100% | 7 | `rings` = Rings, 2,505; `necklaces` = Necklaces, 906; `bracelets` = Bracelets, 894; `earrings` = Earrings, 691; `other` = Other, 110 |
| `jewelry_material` | Jewelry material | StoreRouter enrichment | 100% | 24 | `jewelry_material__white_gold` = White Gold, 3,922; `jewelry_material__diamond` = Diamond, 3,693; `jewelry_material__gold` = Gold, 3,335; `jewelry_material__rose_gold` = Rose Gold, 1,857; `jewelry_material__platinum` = Platinum, 1,171 |
| `jewelry_type` | Jewelry type | StoreRouter enrichment | 93% | 2 | `jewelry_type__fine_jewelry` = Fine Jewelry, 4,752; `jewelry_type__costume` = Costume, 11 |
| `age_groups` | Age Group | StoreRouter enrichment | 84% | 1 | `adult` = Adult, 4,297 |
| `gender` | Gender | StoreRouter enrichment | 84% | 3 | `female` = Female, 2,047; `male` = Male, 1,253; `unisex` = Unisex, 997 |
| `pattern` | Pattern | StoreRouter enrichment | 48% | 35 | `pattern__solid` = Solid, 1,576; `pattern__geometric` = Geometric, 310; `pattern__hearts` = Hearts, 151; `pattern__text` = Text, 116; `pattern__texture` = Texture, 99 |
| `ring_design` | Ring design | StoreRouter enrichment | 47% | 13 | `ring_design__band` = Band, 1,344; `ring_design__row` = Row, 594; `ring_design__solitaire` = Solitaire, 573; `ring_design__eternity` = Eternity, 427; `ring_design__stackable` = Stackable, 335 |
| `necklace_design` | Necklace design | StoreRouter enrichment | 18% | 8 | `necklace_design__chain` = Chain, 709; `necklace_design__pendant` = Pendant, 675; `necklace_design__riviera` = Riviera, 53; `necklace_design__beaded` = Beaded, 9; `necklace_design__strand` = Strand, 7 |
| `bracelet_design` | Bracelet design | StoreRouter enrichment | 17% | 5 | `bracelet_design__link` = Link, 728; `bracelet_design__chain` = Chain, 365; `bracelet_design__tennis` = Tennis, 146; `bracelet_design__bangle` = Bangle, 19; `bracelet_design__cuff` = Cuff, 8 |
| `earring_design` | Earring design | StoreRouter enrichment | 13% | 9 | `earring_design__stud` = Stud, 534; `earring_design__hoop` = Hoop, 114; `earring_design__dangle` = Dangle, 27; `earring_design__jacket` = Jacket, 19; `earring_design__drop` = Drop, 11 |
| `category_path.depth_3` | Category at depth 3 | StoreRouter enrichment | 3% | 5 | `charms & pendants` = Charms & Pendants, 77; `cufflinks` = Cufflinks, 18; `anklets` = Anklets, 16; `jewelry sets` = Jewelry Sets, 16; `body jewelry` = Body Jewelry, 1 |
| `ring_size` | Ring size | StoreRouter enrichment | 2% | 15 | `ring_size__7` = 7, 30; `ring_size__6_5` = 6.5, 26; `ring_size__8_5` = 8.5, 11; `ring_size__6` = 6, 6; `ring_size__7_5` = 7.5, 5 |
| `sustainability_features` | Sustainability Features | StoreRouter enrichment | <1% | 2 | `sustainability_features__eco_friendly` = Eco-Friendly, 32; `sustainability_features__sustainable_sourcing` = Sustainable Sourcing, 4 |
| `chain_link_type` | Chain link type | StoreRouter enrichment | <1% | 7 | `chain_link_type__gourmette/curb` = Gourmette/Curb, 5; `chain_link_type__herringbone` = Herringbone, 4; `chain_link_type__cable` = Cable, 3; `chain_link_type__flat` = Flat, 3; `chain_link_type__rolo/belcher` = Rolo/Belcher, 2 |
| `bag_closure_type` | Bag closure type | StoreRouter enrichment | 0% | 1 | `bag_closure_type__drawstring` = Drawstring, 1 |
| `bag_shape` | Bag Shape | StoreRouter enrichment | 0% | 1 | `bag_shape__bucket` = Bucket, 1 |
| `body_jewelry_type` | Body jewelry type | StoreRouter enrichment | 0% | 1 | `body_jewelry_type__body_chain` = Body Chain, 1 |
| `brand_name` | Canonical brand name | Brand | 100% | 1 | `bliss diamond` = bliss diamond, 5,100 |
