# Jimmyfairly (jimmyfairly.com) product data API

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

- Catalog key: `jimmyfairly` (pass in `"catalogs"` to narrow a search to this store)
- Products: 1,804
- Snapshot: 2026-10-15T11:38:30Z (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/jimmyfairly
- Get an API key: https://platform.storerouter.ai/auth/organization

## Questions

### What does Jimmyfairly sell?

Almost entirely Apparel & Accessories: 100% of its 1,804 products. Accessories is the largest department with 1,800 products, followed by Bags (4). The most common Jimmyfairly categories are Eyewear (1,800) and Totes & Shoppers (4).

### How are Jimmyfairly 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 (1,110 products). Every level is a search facet.

### What can I filter Jimmyfairly products by?

27 searchable fields. Well-covered attributes include eyewear frame color (99% of products), eyewear frame material (99%) and eyewear frame design (97%). For eyewear frame color, the most common values are Tortoiseshell, Black and Brown; for eyewear frame material, the most common values are Acetate, Stainless Steel and Titanium.

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

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

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

### Where does the data come from?

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

### The Gadjo

Key features:   Frame made of cellulose acetate.   Round frame.   Transparent herringbone reinforcement on the temple.   5-point metal hinge. Offers great resistance to handling.   Lenses Include:   Lenses certified ISO, IAF, and KAB MC 04.   Lenses prepared, cut, and hand-checked in our workshop.   Customizable prescription lenses: online and in-store for single vision corrections, in-store for our progressive lenses. Free blue light filter option.

Indexed response retrieved 2026-10-15T11:38:37.448Z. Price and availability may change.
Availability: In stock
Sizes: Medium, M

### Product details

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

```json
{
  "source": "indexed",
  "catalogKey": "jimmyfairly",
  "product": {
    "title": "The Gadjo",
    "brand": {
      "name": "Jimmy Fairly"
    },
    "productUrl": "https://www.jimmyfairly.com/en-us/products/p515-cr130-gadjo",
    "currentPrice": 148,
    "currency": "USD",
    "inStock": true,
    "description": "Key features:   Frame made of cellulose acetate.   Round frame.   Transparent herringbone reinforcement on the temple.   5-point metal hinge. Offers great resistance to handling.   Lenses Include:   Lenses certified ISO, IAF, and KAB MC 04.   Lenses prepared, cut, and hand-checked in our workshop.   Customizable prescription lenses: online and in-store for single vision corrections, in-store for our progressive lenses. Free blue light filter option.   ",
    "primaryImage": {
      "url": "https://cdn.shopify.com/s/files/1/0099/7241/6563/files/P515-CR130_1.jpg?v=1725957933",
      "cdnUrl": "https://cdn.octogen.ai/c64af71ddb06bee07d4558374ed8d5cd/cde83e402dcdacd36711e9c15a2ca9ef.webp?request_id=3a3462fa-1154-46e6-b648-c3f30999d3e4",
      "width": 3578,
      "height": 4473,
      "sizeBytes": 90808,
      "mimeType": "image/webp"
    },
    "details": {
      "materials": [
        "cellulose acetate"
      ],
      "fit": [],
      "dimensions": null,
      "patterns": []
    }
  }
}
```

### Enrichment

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

```json
{
  "source": "indexed",
  "catalogKey": "jimmyfairly",
  "product": {
    "enrichment": {
      "type": "eyeglasses",
      "category_path": [
        "Apparel & Accessories",
        "Accessories",
        "Eyewear",
        "Glasses"
      ],
      "styles": [
        "retro",
        "classic",
        "minimalist"
      ],
      "attributes": {
        "Pattern": [
          "Herringbone"
        ],
        "Temple color": [
          "Yellow"
        ],
        "Eyewear frame color": [
          "Yellow"
        ],
        "Eyewear frame design": [
          "Round"
        ],
        "Eyewear Frame Material": [
          "Acetate"
        ]
      },
      "attribute_handles": {
        "pattern": [
          "pattern__herringbone"
        ],
        "temple_color": [
          "temple_color__yellow"
        ],
        "eyewear_frame_color": [
          "eyewear_frame_color__yellow"
        ],
        "eyewear_frame_design": [
          "eyewear_frame_design__round"
        ],
        "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": ["jimmyfairly"],
    "q": "eyewear",
    "limit": 5
  }'
```

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

- [The Gadjo](https://www.jimmyfairly.com/en-us/products/p515-cr130-gadjo) — $148.00
- [The Bahia](https://www.jimmyfairly.com/en-us/products/p0999-u651-m-bahia) — $148.00
- [The Misty](https://www.jimmyfairly.com/en-us/products/p0708-h651e-m-misty-m) — $148.00
- [The Santa](https://www.jimmyfairly.com/en-us/products/p1150-c302-m-santa) — $148.00
- [The Misty](https://www.jimmyfairly.com/en-us/products/p0708-u303-m-misty-m) — $148.00

## Categories

| Category | Products |
| --- | --- |
| Eyewear | 1,800 |
| Totes & Shoppers | 4 |

## 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,798; `true` = True, 6 |
| `color` | Product color | Merchant data | 99% | 26 | `brown` = Brown, 620; `black` = Black, 246; `green` = Green, 140; `yellow` = Yellow, 119; `gold` = Gold, 86 |
| `color_family` | Color family | Merchant data | 99% | 12 | `Brown` = Brown, 698; `Black` = Black, 246; `Yellow` = Yellow, 205; `Green` = Green, 184; `White` = White, 128 |
| `age_groups` | Age Group | StoreRouter enrichment | 100% | 1 | `adult` = Adult, 1,804 |
| `category_path.depth_0` | Category at depth 0 | StoreRouter enrichment | 100% | 1 | `apparel & accessories` = Apparel & Accessories, 1,804 |
| `category_path.depth_1` | Category at depth 1 | StoreRouter enrichment | 100% | 2 | `accessories` = Accessories, 1,800; `bags` = Bags, 4 |
| `category_path.depth_2` | Category at depth 2 | StoreRouter enrichment | 100% | 2 | `eyewear` = Eyewear, 1,800; `totes & shoppers` = Totes & Shoppers, 4 |
| `category_path.depth_3` | Category at depth 3 | StoreRouter enrichment | 100% | 3 | `sunglasses` = Sunglasses, 1,110; `glasses` = Glasses, 690; `tote bags` = Tote Bags, 4 |
| `gender` | Gender | StoreRouter enrichment | 100% | 3 | `female` = Female, 1,034; `male` = Male, 693; `unisex` = Unisex, 77 |
| `eyewear_frame_color` | Eyewear frame color | StoreRouter enrichment | 100% | 19 | `eyewear_frame_color__tortoiseshell` = Tortoiseshell, 613; `eyewear_frame_color__black` = Black, 246; `eyewear_frame_color__brown` = Brown, 182; `eyewear_frame_color__green` = Green, 175; `eyewear_frame_color__yellow` = Yellow, 112 |
| `eyewear_frame_material` | Eyewear Frame Material | StoreRouter enrichment | 100% | 4 | `eyewear_frame_material__acetate` = Acetate, 1,675; `eyewear_frame_material__stainless_steel` = Stainless Steel, 364; `eyewear_frame_material__titanium` = Titanium, 99; `eyewear_frame_material__metal` = Metal, 15 |
| `pattern` | Pattern | StoreRouter enrichment | 99% | 17 | `pattern__solid` = Solid, 1,077; `pattern__animal` = Animal, 545; `pattern__herringbone` = Herringbone, 156; `pattern__striped` = Striped, 39; `pattern__texture` = Texture, 18 |
| `eyewear_frame_design` | Eyewear frame design | StoreRouter enrichment | 97% | 7 | `eyewear_frame_design__square` = Square, 405; `eyewear_frame_design__round` = Round, 375; `eyewear_frame_design__rectangle` = Rectangle, 372; `eyewear_frame_design__butterfly` = Butterfly, 251; `eyewear_frame_design__oval` = Oval, 200 |
| `eyewear_frame_pattern` | Eyewear frame pattern | StoreRouter enrichment | 63% | 7 | `eyewear_frame_pattern__solid` = Solid, 1,071; `eyewear_frame_pattern__texture` = Texture, 27; `eyewear_frame_pattern__striped` = Striped, 26; `eyewear_frame_pattern__gradient` = Gradient, 13; `eyewear_frame_pattern__geometric` = Geometric, 4 |
| `temple_color` | Temple color | StoreRouter enrichment | 63% | 19 | `temple_color__tortoiseshell` = Tortoiseshell, 325; `temple_color__black` = Black, 219; `temple_color__brown` = Brown, 137; `temple_color__gold` = Gold, 99; `temple_color__green` = Green, 84 |
| `temple_pattern` | Temple pattern | StoreRouter enrichment | 43% | 4 | `temple_pattern__solid` = Solid, 716; `temple_pattern__striped` = Striped, 36; `temple_pattern__texture` = Texture, 21; `temple_pattern__geometric` = Geometric, 3 |
| `lens_color` | Lens color | StoreRouter enrichment | 40% | 11 | `lens_color__brown` = Brown, 150; `lens_color__clear` = Clear, 150; `lens_color__gray` = Gray, 115; `lens_color__yellow` = Yellow, 78; `lens_color__blue` = Blue, 62 |
| `lens_pattern` | Lens pattern | StoreRouter enrichment | 34% | 2 | `lens_pattern__solid` = Solid, 448; `lens_pattern__gradient` = Gradient, 167 |
| `sustainability_features` | Sustainability Features | StoreRouter enrichment | <1% | 3 | `sustainability_features__eco_friendly` = Eco-Friendly, 11; `sustainability_features__biodegradable` = Biodegradable, 1; `sustainability_features__recycled_materials` = Recycled Materials, 1 |
| `lens_polarization` | Lens polarization | StoreRouter enrichment | <1% | 1 | `lens_polarization__polarized` = Polarized, 9 |
| `bag_case_material` | Bag/Case material | StoreRouter enrichment | <1% | 2 | `bag_case_material__cotton` = Cotton, 4; `bag_case_material__polyester` = Polyester, 4 |
| `bag_closure_type` | Bag closure type | StoreRouter enrichment | <1% | 1 | `bag_closure_type__open_top` = Open Top, 3 |
| `bag_shape` | Bag Shape | StoreRouter enrichment | <1% | 1 | `bag_shape__rectangle` = Rectangle, 3 |
| `carry_options` | Carry options | StoreRouter enrichment | <1% | 2 | `carry_options__handle` = Handle, 3; `carry_options__shoulder_strap` = Shoulder Strap, 2 |
| `graphic_type` | Graphic Type | StoreRouter enrichment | <1% | 3 | `graphic_type__slogan_text` = Text / Slogan Print, 3; `graphic_type__logo_branded` = Logo Print, 1; `graphic_type__solid_no_print` = Solid / No Print, 1 |
| `tote_handle_type` | Tote handle type | StoreRouter enrichment | <1% | 1 | `tote_handle_type__dual` = Dual, 1 |
| `brand_name` | Canonical brand name | Brand | 100% | 1 | `Jimmy Fairly` = Jimmy Fairly, 1,804 |
