# Materialgood (materialgood.com) product data API

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

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

## Questions

### What does Materialgood sell?

Almost entirely Apparel & Accessories: 100% of its 966 products. Jewelry is the largest department with 964 products, followed by Bags (2). The most common Materialgood categories are Earrings (239), Watches (216) and Rings (211).

### How are Materialgood products categorized?

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

### What can I filter Materialgood products by?

35 searchable fields. Well-covered attributes include jewelry material (77% of products), earring design (24%) and band color (22%). For jewelry material, the most common values are Gold, Diamond and White Gold; for earring design, the most common values are Stud, Drop and Dangle.

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

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

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

### Where does the data come from?

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

### Coral & Pearl Drop Earrings

One-of-a-kind drop earrings showcasing biwa keshi pearls suspended below pavé diamond circles, green tourmaline, and reddish orange coral pieces. The dramatic length of these one-of-a-kind earrings is punctuated by eye-catching organic shapes, coming together to form the ideal summer drop. This unique design is a celebration of summer motifs and stunning craftsmanship.

Indexed response retrieved 2026-10-15T13:17:44.392Z. 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": "materialgood",
  "product": {
    "title": "Coral & Pearl Drop Earrings",
    "brand": {
      "name": "Material Good"
    },
    "productUrl": "https://materialgood.com/products/coral-pearl-drop-earrings",
    "currentPrice": 12650,
    "currency": "USD",
    "inStock": true,
    "description": "One-of-a-kind drop earrings showcasing biwa keshi pearls suspended below pavé diamond circles, green tourmaline, and reddish orange coral pieces. The dramatic length of these one-of-a-kind earrings is punctuated by eye-catching organic shapes, coming together to form the ideal summer drop. This unique design is a celebration of summer motifs and stunning craftsmanship.",
    "primaryImage": {
      "url": "https://cdn.shopify.com/s/files/1/0561/5190/0369/products/MGEarring12-00051a1.jpg?v=1669416826",
      "cdnUrl": "https://cdn.octogen.ai/c4c95a9914e3ad55149dc197b9d869cc/5da061afa17c90640745cdffcbac7854.webp?request_id=553fd800-d097-4f8a-b97b-30497eacb3aa",
      "width": 2048,
      "height": 2048,
      "sizeBytes": 78896,
      "mimeType": "image/webp"
    },
    "details": {
      "materials": [
        "18K yellow gold"
      ],
      "fit": [],
      "dimensions": null,
      "patterns": []
    }
  }
}
```

### Enrichment

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

```json
{
  "source": "indexed",
  "catalogKey": "materialgood",
  "product": {
    "enrichment": {
      "type": "drop earrings",
      "category_path": [
        "Apparel & Accessories",
        "Jewelry",
        "Earrings"
      ],
      "styles": [
        "eclectic",
        "luxurious",
        "bohemian"
      ],
      "attributes": {
        "Pattern": [
          "Organic"
        ],
        "Jewelry type": [
          "Fine Jewelry"
        ],
        "Earring design": [
          "Dangle",
          "Drop"
        ],
        "Jewelry material": [
          "Diamond",
          "Gold",
          "Pearl",
          "Stone"
        ]
      },
      "attribute_handles": {
        "pattern": [
          "pattern__organic"
        ],
        "jewelry_type": [
          "jewelry_type__fine_jewelry"
        ],
        "earring_design": [
          "earring_design__dangle",
          "earring_design__drop"
        ],
        "jewelry_material": [
          "jewelry_material__diamond",
          "jewelry_material__gold",
          "jewelry_material__pearl",
          "jewelry_material__stone"
        ]
      }
    }
  }
}
```

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

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

- [Coral & Pearl Drop Earrings](https://materialgood.com/products/coral-pearl-drop-earrings) — $12,650.00
- [Two-Tone Pear Drop Earrings](https://materialgood.com/products/two-tone-pear-drop-earrings) — $8,100.00
- [Large Teardrop Fireworks Earrings](https://materialgood.com/products/open-pear-earrings) — $26,400.00
- [Two-Tone Pear Shape Yellow & White Diamond Earrings](https://materialgood.com/products/two-tone-pear-shape-yellow-white-diamond-earrings) — $26,450.00
- [Multi-Gem Cabochon Earrings](https://materialgood.com/products/vintage-multi-gem-cabochon-earrings) — $9,100.00

## Categories

| Category | Products |
| --- | --- |
| Earrings | 239 |
| Watches | 216 |
| Rings | 211 |
| Necklaces | 196 |
| Bracelets | 85 |
| Other | 17 |
| Luggage, Travel & Utility | 2 |

## 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, 966 |
| `color` | Product color | Merchant data | 60% | 40 | `gold` = Gold, 349; `white` = White, 135; `silver` = Silver, 81; `yellow` = Yellow, 30; `bronze` = Bronze, 24 |
| `color_family` | Color family | Merchant data | 60% | 12 | `Yellow` = Yellow, 359; `White` = White, 136; `Gray` = Gray, 88; `Blue` = Blue, 56; `Brown` = Brown, 32 |
| `category_path.depth_0` | Category at depth 0 | StoreRouter enrichment | 100% | 1 | `apparel & accessories` = Apparel & Accessories, 966 |
| `category_path.depth_1` | Category at depth 1 | StoreRouter enrichment | 100% | 2 | `jewelry` = Jewelry, 964; `bags` = Bags, 2 |
| `category_path.depth_2` | Category at depth 2 | StoreRouter enrichment | 100% | 7 | `earrings` = Earrings, 239; `watches` = Watches, 216; `rings` = Rings, 211; `necklaces` = Necklaces, 196; `bracelets` = Bracelets, 85 |
| `age_groups` | Age Group | StoreRouter enrichment | 99% | 1 | `adult` = Adult, 959 |
| `gender` | Gender | StoreRouter enrichment | 99% | 3 | `unisex` = Unisex, 554; `female` = Female, 399; `male` = Male, 6 |
| `jewelry_material` | Jewelry material | StoreRouter enrichment | 77% | 15 | `jewelry_material__gold` = Gold, 571; `jewelry_material__diamond` = Diamond, 570; `jewelry_material__white_gold` = White Gold, 268; `jewelry_material__stone` = Stone, 266; `jewelry_material__rose_gold` = Rose Gold, 227 |
| `jewelry_type` | Jewelry type | StoreRouter enrichment | 77% | 1 | `jewelry_type__fine_jewelry` = Fine Jewelry, 740 |
| `pattern` | Pattern | StoreRouter enrichment | 40% | 27 | `pattern__geometric` = Geometric, 149; `pattern__solid` = Solid, 89; `pattern__diamond` = Diamond, 46; `pattern__texture` = Texture, 36; `pattern__hearts` = Hearts, 35 |
| `earring_design` | Earring design | StoreRouter enrichment | 25% | 11 | `earring_design__stud` = Stud, 103; `earring_design__drop` = Drop, 85; `earring_design__dangle` = Dangle, 48; `earring_design__hoop` = Hoop, 38; `earring_design__huggie` = Huggie, 16 |
| `category_path.depth_3` | Category at depth 3 | StoreRouter enrichment | 24% | 4 | `fine watches` = Fine Watches, 216; `charms & pendants` = Charms & Pendants, 15; `anklets` = Anklets, 2; `luggage accessories` = Luggage Accessories, 2 |
| `band_color` | Band color | StoreRouter enrichment | 22% | 14 | `band_color__gold` = Gold, 67; `band_color__silver` = Silver, 59; `band_color__black` = Black, 51; `band_color__rose_gold` = Rose Gold, 17; `band_color__blue` = Blue, 16 |
| `case_color` | Case color | StoreRouter enrichment | 22% | 9 | `case_color__silver` = Silver, 98; `case_color__gold` = Gold, 66; `case_color__rose_gold` = Rose Gold, 36; `case_color__gray` = Gray, 13; `case_color__yellow` = Yellow, 12 |
| `dial_color` | Dial color | StoreRouter enrichment | 22% | 17 | `dial_color__blue` = Blue, 58; `dial_color__black` = Black, 51; `dial_color__gold` = Gold, 24; `dial_color__white` = White, 21; `dial_color__clear` = Clear, 16 |
| `watch_display` | Watch display | StoreRouter enrichment | 22% | 1 | `watch_display__analog` = Analog, 216 |
| `band_pattern` | Band pattern | StoreRouter enrichment | 22% | 6 | `band_pattern__solid` = Solid, 175; `band_pattern__animal` = Animal, 20; `band_pattern__geometric` = Geometric, 13; `band_pattern__texture` = Texture, 6; `band_pattern__diamond` = Diamond, 3 |
| `watch_material` | Watch material | StoreRouter enrichment | 22% | 8 | `watch_material__metal` = Metal, 145; `watch_material__stainless_steel` = Stainless Steel, 56; `watch_material__leather` = Leather, 30; `watch_material__rubber` = Rubber, 30; `watch_material__titanium` = Titanium, 12 |
| `dial_pattern` | Dial pattern | StoreRouter enrichment | 21% | 17 | `dial_pattern__geometric` = Geometric, 92; `dial_pattern__solid` = Solid, 70; `dial_pattern__texture` = Texture, 32; `dial_pattern__logo` = Logo, 13; `dial_pattern__illusion` = Illusion, 11 |
| `watch_case_shape` | Watch case shape | StoreRouter enrichment | 21% | 6 | `watch_case_shape__round` = Round, 95; `watch_case_shape__hexagonal` = Hexagonal, 51; `watch_case_shape__asymmetric` = Asymmetric, 30; `watch_case_shape__tonneau` = Tonneau, 24; `watch_case_shape__oval` = Oval, 4 |
| `watch_movement_type` | Watch movement type | StoreRouter enrichment | 21% | 3 | `watch_movement_type__automatic` = Automatic, 134; `watch_movement_type__quartz` = Quartz, 42; `watch_movement_type__mechanical` = Mechanical (Hand-Wound), 25 |
| `case_pattern` | Case pattern | StoreRouter enrichment | 21% | 6 | `case_pattern__solid` = Solid, 185; `case_pattern__texture` = Texture, 7; `case_pattern__diamond` = Diamond, 4; `case_pattern__geometric` = Geometric, 2; `case_pattern__organic` = Organic, 1 |
| `ring_design` | Ring design | StoreRouter enrichment | 21% | 11 | `ring_design__band` = Band, 65; `ring_design__solitaire` = Solitaire, 59; `ring_design__cocktail` = Cocktail, 47; `ring_design__row` = Row, 33; `ring_design__three_stone` = Three Stone, 31 |
| `necklace_design` | Necklace design | StoreRouter enrichment | 20% | 11 | `necklace_design__chain` = Chain, 113; `necklace_design__pendant` = Pendant, 81; `necklace_design__statement` = Statement, 37; `necklace_design__riviera` = Riviera, 36; `necklace_design__choker` = Choker, 12 |
| `watch_features` | Watch features | StoreRouter enrichment | 19% | 19 | `watch_features__date_display` = Date Display, 128; `watch_features__chronograph` = Chronograph, 51; `watch_features__skeleton_dial` = Skeleton Dial, 29; `watch_features__manual_winding` = Manual Winding, 25; `watch_features__moon_phase_display` = Moon Phase Display, 25 |
| `bracelet_design` | Bracelet design | StoreRouter enrichment | 9% | 7 | `bracelet_design__tennis` = Tennis, 47; `bracelet_design__link` = Link, 20; `bracelet_design__cuff` = Cuff, 11; `bracelet_design__chain` = Chain, 6; `bracelet_design__bangle` = Bangle, 5 |
| `sustainability_features` | Sustainability Features | StoreRouter enrichment | <1% | 3 | `sustainability_features__organic_materials` = Organic Materials, 1; `sustainability_features__recycled_materials` = Recycled Materials, 1; `sustainability_features__sustainable_sourcing` = Sustainable Sourcing, 1 |
| `bag_closure_type` | Bag closure type | StoreRouter enrichment | <1% | 1 | `bag_closure_type__zipper` = Zipper, 2 |
| `category_path.depth_4` | Category at depth 4 | StoreRouter enrichment | <1% | 2 | `packing organizers` = Packing Organizers, 1; `travel pouches` = Travel Pouches, 1 |
| `chain_link_type` | Chain link type | StoreRouter enrichment | <1% | 1 | `chain_link_type__heart` = Heart, 2 |
| `graphic_type` | Graphic Type | StoreRouter enrichment | <1% | 1 | `graphic_type__solid_no_print` = Solid / No Print, 2 |
| `hardware_finish` | Hardware finish | StoreRouter enrichment | <1% | 1 | `hardware_finish__gold` = Gold, 2 |
| `bag_case_storage_features` | Bag/Case storage features | StoreRouter enrichment | <1% | 1 | `bag_case_storage_features__built-in_compartments` = Built-in Compartments, 1 |
| `brand_name` | Canonical brand name | Brand | 96% | 28 | `Material Good` = Material Good, 502; `Audemars Piguet` = Audemars Piguet, 96; `Azlee` = Azlee, 54; `Patek Philippe` = Patek Philippe, 54; `Bulgari` = Bulgari, 38 |