# Carreraworld (carreraworld.com) product data API

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

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

## Questions

### What does Carreraworld sell?

Almost entirely Apparel & Accessories: 100% of its 305 products. Accessories is the largest department with 304 products, followed by Jewelry (1). The most common Carreraworld categories are Eyewear (303), Hats & Headwear (1) and Watches (1).

### How are Carreraworld products categorized?

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

### What can I filter Carreraworld products by?

28 searchable fields. Well-covered attributes include eyewear frame color (99% of products), eyewear frame design (99%) and eyewear frame pattern (97%). For eyewear frame color, the most common values are Black, Gold and Tortoiseshell; for eyewear frame design, the most common values are Rectangle, Square and Aviator.

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

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

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

### Where does the data come from?

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

### CARDUC 058

These Carrera | Ducati eyeglasses blend instantly recognizable design with effortless everyday wear. The sculpted temples pay tribute to Ducati's aesthetic with metal inserts and visible logos that get noticed. Plastic front for lightweight comfort and flex hinges for durability. The neutral palette features sporty pops of colour which highlight the character of this collab. A style boost that brings the racing spirit to your everyday looks.

Indexed response retrieved 2026-10-15T15:27:22.668Z. Price and availability may change.
Availability: In stock
Sizes: 57-16-140

### Product details

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

```json
{
  "source": "indexed",
  "catalogKey": "carreraworld",
  "product": {
    "title": "CARDUC 058",
    "brand": {
      "name": "Carrera"
    },
    "productUrl": "https://www.carreraworld.com/products/110120",
    "currentPrice": 149,
    "currency": null,
    "inStock": true,
    "description": "These Carrera | Ducati eyeglasses blend instantly recognizable design with effortless everyday wear. The sculpted temples pay tribute to Ducati's aesthetic with metal inserts and visible logos that get noticed. Plastic front for lightweight comfort and flex hinges for durability. The neutral palette features sporty pops of colour which highlight the character of this collab. A style boost that brings the racing spirit to your everyday looks.",
    "primaryImage": {
      "url": "https://cdn.shopify.com/s/files/1/0602/0156/6447/files/ecomm_2b5ad312-cf92-4cb0-840d-44de0262f2cb.jpg?v=1776070680",
      "cdnUrl": "https://cdn.octogen.ai/571590ff8051836f1b3b416990790cf5/c5b3a20d85f0d2ef1a3693e0bdd98048.webp?request_id=e031e784-d30e-4455-a3ec-0d8a6af3e49a",
      "width": 1800,
      "height": 1800,
      "sizeBytes": 45244,
      "mimeType": "image/webp"
    },
    "details": {
      "materials": [],
      "fit": [],
      "dimensions": null,
      "patterns": []
    }
  }
}
```

### Enrichment

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

```json
{
  "source": "indexed",
  "catalogKey": "carreraworld",
  "product": {
    "enrichment": {
      "type": "eyeglasses",
      "category_path": [
        "Apparel & Accessories",
        "Accessories",
        "Eyewear",
        "Glasses"
      ],
      "styles": [
        "sporty",
        "modern"
      ],
      "attributes": {
        "Pattern": [
          "Logo",
          "Solid"
        ],
        "Lens color": [
          "Clear"
        ],
        "Eyewear frame color": [
          "Black"
        ],
        "Eyewear frame design": [
          "Square"
        ],
        "Eyewear frame pattern": [
          "Logo",
          "Solid"
        ],
        "Eyewear Frame Material": [
          "Plastic"
        ]
      },
      "attribute_handles": {
        "pattern": [
          "pattern__logo",
          "pattern__solid"
        ],
        "lens_color": [
          "lens_color__clear"
        ],
        "eyewear_frame_color": [
          "eyewear_frame_color__black"
        ],
        "eyewear_frame_design": [
          "eyewear_frame_design__square"
        ],
        "eyewear_frame_pattern": [
          "eyewear_frame_pattern__logo",
          "eyewear_frame_pattern__solid"
        ],
        "eyewear_frame_material": [
          "eyewear_frame_material__plastic"
        ]
      }
    }
  }
}
```

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

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

- [CARDUC 058](https://www.carreraworld.com/products/110120)
- [CARRERA 8923](https://www.carreraworld.com/products/110265)
- [CARRERA 3038](https://www.carreraworld.com/products/108361)
- [CARRERA 3025](https://www.carreraworld.com/products/107585)
- [CARRERA 325](https://www.carreraworld.com/products/108073)

## Categories

| Category | Products |
| --- | --- |
| Eyewear | 303 |
| Hats & Headwear | 1 |
| Watches | 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) |
| --- | --- | --- | --- | --- | --- |
| `color` | Product color | Merchant data | 100% | 32 | `black` = Black, 243; `brown` = Brown, 103; `gold` = Gold, 101; `red` = Red, 54; `blue` = Blue, 47 |
| `color_family` | Color family | Merchant data | 100% | 12 | `Black` = Black, 243; `Brown` = Brown, 124; `Yellow` = Yellow, 119; `Gray` = Gray, 95; `Red` = Red, 62 |
| `is_activewear` | Activewear | Merchant data | 100% | 2 | `false` = False, 263; `true` = True, 42 |
| `category_path.depth_0` | Category at depth 0 | StoreRouter enrichment | 100% | 1 | `apparel & accessories` = Apparel & Accessories, 305 |
| `category_path.depth_1` | Category at depth 1 | StoreRouter enrichment | 100% | 2 | `accessories` = Accessories, 304; `jewelry` = Jewelry, 1 |
| `category_path.depth_2` | Category at depth 2 | StoreRouter enrichment | 100% | 3 | `eyewear` = Eyewear, 303; `hats & headwear` = Hats & Headwear, 1; `watches` = Watches, 1 |
| `category_path.depth_3` | Category at depth 3 | StoreRouter enrichment | 100% | 4 | `sunglasses` = Sunglasses, 171; `glasses` = Glasses, 132; `caps` = Caps, 1; `watch accessories` = Watch Accessories, 1 |
| `age_groups` | Age Group | StoreRouter enrichment | 100% | 1 | `adult` = Adult, 304 |
| `gender` | Gender | StoreRouter enrichment | 100% | 3 | `unisex` = Unisex, 226; `female` = Female, 74; `male` = Male, 4 |
| `pattern` | Pattern | StoreRouter enrichment | 100% | 10 | `pattern__solid` = Solid, 277; `pattern__logo` = Logo, 111; `pattern__animal` = Animal, 62; `pattern__geometric` = Geometric, 17; `pattern__texture` = Texture, 8 |
| `eyewear_frame_color` | Eyewear frame color | StoreRouter enrichment | 99% | 18 | `eyewear_frame_color__black` = Black, 217; `eyewear_frame_color__gold` = Gold, 104; `eyewear_frame_color__tortoiseshell` = Tortoiseshell, 73; `eyewear_frame_color__brown` = Brown, 59; `eyewear_frame_color__gray` = Gray, 39 |
| `eyewear_frame_design` | Eyewear frame design | StoreRouter enrichment | 99% | 8 | `eyewear_frame_design__rectangle` = Rectangle, 112; `eyewear_frame_design__square` = Square, 80; `eyewear_frame_design__aviator` = Aviator, 50; `eyewear_frame_design__wrap` = Wrap, 23; `eyewear_frame_design__cat_eye` = Cat Eye, 14 |
| `eyewear_frame_pattern` | Eyewear frame pattern | StoreRouter enrichment | 98% | 7 | `eyewear_frame_pattern__solid` = Solid, 272; `eyewear_frame_pattern__logo` = Logo, 91; `eyewear_frame_pattern__geometric` = Geometric, 13; `eyewear_frame_pattern__gradient` = Gradient, 7; `eyewear_frame_pattern__texture` = Texture, 6 |
| `lens_color` | Lens color | StoreRouter enrichment | 91% | 11 | `lens_color__clear` = Clear, 110; `lens_color__black` = Black, 68; `lens_color__brown` = Brown, 48; `lens_color__gray` = Gray, 44; `lens_color__blue` = Blue, 14 |
| `eyewear_frame_material` | Eyewear Frame Material | StoreRouter enrichment | 80% | 6 | `eyewear_frame_material__acetate` = Acetate, 117; `eyewear_frame_material__metal` = Metal, 97; `eyewear_frame_material__plastic` = Plastic, 44; `eyewear_frame_material__stainless_steel` = Stainless Steel, 36; `eyewear_frame_material__carbon_fiber` = Carbon Fiber, 6 |
| `temple_color` | Temple color | StoreRouter enrichment | 79% | 18 | `temple_color__black` = Black, 189; `temple_color__gold` = Gold, 83; `temple_color__tortoiseshell` = Tortoiseshell, 43; `temple_color__brown` = Brown, 40; `temple_color__red` = Red, 33 |
| `temple_pattern` | Temple pattern | StoreRouter enrichment | 75% | 5 | `temple_pattern__solid` = Solid, 214; `temple_pattern__logo` = Logo, 74; `temple_pattern__geometric` = Geometric, 4; `temple_pattern__texture` = Texture, 4; `temple_pattern__striped` = Striped, 1 |
| `lens_pattern` | Lens pattern | StoreRouter enrichment | 57% | 3 | `lens_pattern__solid` = Solid, 110; `lens_pattern__gradient` = Gradient, 75; `lens_pattern__logo` = Logo, 4 |
| `lens_polarization` | Lens polarization | StoreRouter enrichment | 12% | 2 | `lens_polarization__polarized` = Polarized, 37; `lens_polarization__photo_polarized` = Photo Polarized, 1 |
| `category_path.depth_4` | Category at depth 4 | StoreRouter enrichment | <1% | 2 | `visors` = Visors, 1; `watch bands` = Watch Bands, 1 |
| `fabric` | Fabric | StoreRouter enrichment | <1% | 1 | `fabric__elastane` = Elastane (Spandex / Lycra), 1 |
| `graphic_type` | Graphic Type | StoreRouter enrichment | <1% | 1 | `graphic_type__logo_branded` = Logo Print, 1 |
| `headwear_features` | Headwear features | StoreRouter enrichment | <1% | 1 | `headwear_features__adjustable_fit` = Adjustable Fit, 1 |
| `material` | Material | StoreRouter enrichment | <1% | 2 | `material__elastane` = Elastane (Spandex / Lycra), 1; `material__other` = Other, 1 |
| `occasion_general` | Occasion | StoreRouter enrichment | <1% | 2 | `occasion_general__active` = Active, 1; `occasion_general__casual` = Casual, 1 |
| `season` | Season | StoreRouter enrichment | <1% | 1 | `season__warm_weather` = Warm Weather, 1 |
| `watch_accessory_style` | Watch accessory style | StoreRouter enrichment | <1% | 1 | `watch_accessory_style__sport` = Sport, 1 |
| `brand_name` | Canonical brand name | Brand | 100% | 1 | `Carrera` = Carrera, 305 |
