# Persol (persol.com) product data API

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

- Catalog key: `persol` (pass in `"catalogs"` to narrow a search to this store)
- Products: 934
- Snapshot: 2026-10-19T17:26:32Z (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/persol
- Get an API key: https://platform.storerouter.ai/auth/organization

## Questions

### What does Persol sell?

Almost entirely Apparel & Accessories: 100% of its 934 products. Accessories is the largest department with 934 products. The most common Persol category is Eyewear (934).

### How are Persol 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 (587 products). Every level is a search facet.

### What can I filter Persol products by?

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

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

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

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

### Where does the data come from?

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

### PO1005V

Soft rectangular metal shape with acetate temples, flex hinges for added comfort enriched by metal end pieces.

Indexed response retrieved 2026-10-20T01:50:32.105Z. Price and availability may change.
Availability: In stock
Sizes: 56-17, 56-17RX

### Product details

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

```json
{
  "source": "indexed",
  "catalogKey": "persol",
  "product": {
    "title": "PO1005V",
    "brand": {
      "name": "Persol"
    },
    "productUrl": "https://www.persol.com/en-us/products/0po1005v-1152",
    "currentPrice": 163.5,
    "currency": "USD",
    "inStock": true,
    "description": "Soft rectangular metal shape with acetate temples, flex hinges for added comfort enriched by metal end pieces.",
    "primaryImage": {
      "url": "https://cdn.shopify.com/s/files/1/0666/8045/5235/files/0PO1005V__1152__P21__shad__qt_61b87d14865dc89ff29f611a2a9c4e6cf889555f9a9f8954ea983190ee70ab4a.png?v=1788801022",
      "cdnUrl": "https://cdn.octogen.ai/bd8e051068f843761fa261017c30f4d0/3d95934077c05f4130e8526acbea04fa.webp?request_id=4751b670-11f0-48ae-ae0c-1d7ba33633ad",
      "width": 1920,
      "height": 960,
      "sizeBytes": 135332,
      "mimeType": "image/webp"
    },
    "details": {
      "materials": [
        "Steel/Metal"
      ],
      "fit": [
        "Adjustable Nosepads"
      ],
      "dimensions": null,
      "patterns": []
    }
  }
}
```

### Enrichment

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

```json
{
  "source": "indexed",
  "catalogKey": "persol",
  "product": {
    "enrichment": {
      "type": "eyeglasses",
      "category_path": [
        "Apparel & Accessories",
        "Accessories",
        "Eyewear",
        "Glasses"
      ],
      "styles": [
        "modern",
        "professional",
        "minimalist"
      ],
      "attributes": {
        "Pattern": [
          "Solid"
        ],
        "Temple color": [
          "Blue"
        ],
        "Temple pattern": [
          "Solid"
        ],
        "Eyewear frame color": [
          "Blue"
        ],
        "Eyewear frame design": [
          "Rectangle"
        ],
        "Eyewear frame pattern": [
          "Solid"
        ],
        "Eyewear Frame Material": [
          "Acetate",
          "Metal"
        ]
      },
      "attribute_handles": {
        "pattern": [
          "pattern__solid"
        ],
        "temple_color": [
          "temple_color__blue"
        ],
        "temple_pattern": [
          "temple_pattern__solid"
        ],
        "eyewear_frame_color": [
          "eyewear_frame_color__blue"
        ],
        "eyewear_frame_design": [
          "eyewear_frame_design__rectangle"
        ],
        "eyewear_frame_pattern": [
          "eyewear_frame_pattern__solid"
        ],
        "eyewear_frame_material": [
          "eyewear_frame_material__acetate",
          "eyewear_frame_material__metal"
        ]
      }
    }
  }
}
```

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

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

- [PO1005V](https://www.persol.com/en-us/products/0po1005v-1152) — $163.50
- [PO1029V](https://www.persol.com/en-us/products/0po1029v-1078) — $393.00
- [PO1029V](https://www.persol.com/en-us/products/0po1029v-518) — $393.00
- [PO3344V](https://www.persol.com/en-us/products/0po3344v-1205) — $363.00
- [PO1030V](https://www.persol.com/en-us/products/0po1030v-1156) — $778.00

## Prices

Median price $383 across 934 priced products. Current prices, assumed USD.

| Price range | Products |
| --- | --- |
| Under $160 | 4 |
| $160–$640 | 905 |
| $640 and up | 25 |

## Categories

| Category | Products |
| --- | --- |
| Eyewear | 934 |

## 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, 934 |
| `color` | Product color | Merchant data | 99% | 28 | `brown` = Brown, 323; `black` = Black, 250; `gray` = Gray, 85; `gold` = Gold, 52; `sienna` = Sienna, 47 |
| `color_family` | Color family | Merchant data | 99% | 12 | `Brown` = Brown, 423; `Black` = Black, 250; `Gray` = Gray, 154; `Blue` = Blue, 70; `Yellow` = Yellow, 63 |
| `age_groups` | Age Group | StoreRouter enrichment | 100% | 1 | `adult` = Adult, 934 |
| `category_path.depth_0` | Category at depth 0 | StoreRouter enrichment | 100% | 1 | `apparel & accessories` = Apparel & Accessories, 934 |
| `category_path.depth_1` | Category at depth 1 | StoreRouter enrichment | 100% | 1 | `accessories` = Accessories, 934 |
| `category_path.depth_2` | Category at depth 2 | StoreRouter enrichment | 100% | 1 | `eyewear` = Eyewear, 934 |
| `category_path.depth_3` | Category at depth 3 | StoreRouter enrichment | 100% | 2 | `sunglasses` = Sunglasses, 587; `glasses` = Glasses, 347 |
| `eyewear_frame_color` | Eyewear frame color | StoreRouter enrichment | 100% | 16 | `eyewear_frame_color__brown` = Brown, 339; `eyewear_frame_color__tortoiseshell` = Tortoiseshell, 258; `eyewear_frame_color__black` = Black, 247; `eyewear_frame_color__gray` = Gray, 117; `eyewear_frame_color__blue` = Blue, 62 |
| `gender` | Gender | StoreRouter enrichment | 100% | 2 | `unisex` = Unisex, 923; `male` = Male, 11 |
| `eyewear_frame_material` | Eyewear Frame Material | StoreRouter enrichment | 100% | 3 | `eyewear_frame_material__acetate` = Acetate, 889; `eyewear_frame_material__metal` = Metal, 163; `eyewear_frame_material__titanium` = Titanium, 17 |
| `eyewear_frame_design` | Eyewear frame design | StoreRouter enrichment | 100% | 6 | `eyewear_frame_design__rectangle` = Rectangle, 527; `eyewear_frame_design__round` = Round, 155; `eyewear_frame_design__square` = Square, 134; `eyewear_frame_design__oval` = Oval, 92; `eyewear_frame_design__aviator` = Aviator, 29 |
| `pattern` | Pattern | StoreRouter enrichment | 98% | 12 | `pattern__solid` = Solid, 599; `pattern__animal` = Animal, 245; `pattern__striped` = Striped, 98; `pattern__logo` = Logo, 21; `pattern__texture` = Texture, 20 |
| `temple_color` | Temple color | StoreRouter enrichment | 94% | 16 | `temple_color__brown` = Brown, 323; `temple_color__tortoiseshell` = Tortoiseshell, 268; `temple_color__black` = Black, 244; `temple_color__gray` = Gray, 102; `temple_color__blue` = Blue, 64 |
| `lens_color` | Lens color | StoreRouter enrichment | 86% | 8 | `lens_color__clear` = Clear, 286; `lens_color__gray` = Gray, 193; `lens_color__brown` = Brown, 168; `lens_color__black` = Black, 99; `lens_color__green` = Green, 65 |
| `eyewear_frame_pattern` | Eyewear frame pattern | StoreRouter enrichment | 77% | 7 | `eyewear_frame_pattern__solid` = Solid, 581; `eyewear_frame_pattern__striped` = Striped, 97; `eyewear_frame_pattern__logo` = Logo, 14; `eyewear_frame_pattern__texture` = Texture, 13; `eyewear_frame_pattern__gradient` = Gradient, 12 |
| `temple_pattern` | Temple pattern | StoreRouter enrichment | 69% | 7 | `temple_pattern__solid` = Solid, 539; `temple_pattern__striped` = Striped, 75; `temple_pattern__logo` = Logo, 18; `temple_pattern__texture` = Texture, 13; `temple_pattern__gradient` = Gradient, 7 |
| `lens_pattern` | Lens pattern | StoreRouter enrichment | 48% | 3 | `lens_pattern__solid` = Solid, 384; `lens_pattern__gradient` = Gradient, 71; `lens_pattern__striped` = Striped, 1 |
| `lens_polarization` | Lens polarization | StoreRouter enrichment | 3% | 1 | `lens_polarization__polarized` = Polarized, 25 |
| `sustainability_features` | Sustainability Features | StoreRouter enrichment | <1% | 2 | `sustainability_features__eco_friendly` = Eco-Friendly, 6; `sustainability_features__biodegradable` = Biodegradable, 4 |
| `brand_name` | Canonical brand name | Brand | 100% | 1 | `Persol` = Persol, 934 |
