# Thehatgirls (thehatgirls.com) product data API

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

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

## Questions

### What does Thehatgirls sell?

Almost entirely Apparel & Accessories: 100% of its 2,370 products. Accessories is the largest department with 2,370 products. The most common Thehatgirls category is Hats & Headwear (2,370).

### How are Thehatgirls products categorized?

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

### What can I filter Thehatgirls products by?

16 searchable fields. Well-covered attributes include pattern (99% of products), product color (55%) and color family (55%). For pattern, the most common values are Solid, Floral and Texture; for product color, the most common values are Pink, Ivory and Black.

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

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

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

### Where does the data come from?

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

### Chrissy - Custom Hat Collection

This product is designed &amp; created by The Hat Girls

Indexed response retrieved 2026-10-20T06:58:23.923Z. 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": "thehatgirls",
  "product": {
    "title": "Chrissy - Custom Hat Collection",
    "brand": {
      "name": "The Hat Girls"
    },
    "productUrl": "https://thehatgirls.com/products/chrissy-custom-hat-collection",
    "currentPrice": 770,
    "currency": "USD",
    "inStock": true,
    "description": "This product is designed &amp; created by The Hat Girls",
    "primaryImage": {
      "url": "https://cdn.shopify.com/s/files/1/0176/1266/9028/files/IMG_0415_29db550d-f749-4be2-8cd5-c2bf6b3a9c64.jpg?v=1740712957",
      "cdnUrl": "https://cdn.octogen.ai/603aed6acd59c8ba7dfb6a71225a13be/357e53be1cd14b5c5a9526914c5320b5.webp?request_id=734e2013-cdcf-4602-91aa-7798f337a060",
      "width": 3372,
      "height": 4215,
      "sizeBytes": 1078730,
      "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": "thehatgirls",
  "product": {
    "enrichment": {
      "type": "fascinator",
      "category_path": [
        "Apparel & Accessories",
        "Accessories",
        "Hats & Headwear",
        "Statement & Occasion",
        "Fascinators"
      ],
      "styles": [
        "elegant",
        "formal",
        "avant-garde"
      ],
      "attributes": {
        "Pattern": [
          "Solid"
        ],
        "Occasion": [
          "Casual",
          "Formal"
        ]
      },
      "attribute_handles": {
        "pattern": [
          "pattern__solid"
        ],
        "occasion_general": [
          "occasion_general__casual",
          "occasion_general__formal"
        ]
      }
    }
  }
}
```

## 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": ["thehatgirls"],
    "q": "hats & headwear",
    "limit": 5
  }'
```

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

- [Chrissy - Custom Hat Collection](https://thehatgirls.com/products/chrissy-custom-hat-collection) — $770.00
- [THG9441](https://thehatgirls.com/products/kentucky-derby-hat-thg9441) — $1,800.00
- [THG9515](https://thehatgirls.com/products/kentucky-derby-hat-thg9515) — $2,800.00
- [HANNAH](https://thehatgirls.com/products/thg4038) — $350.00
- [V-THG1232](https://thehatgirls.com/products/resko-nude-rust-animal-print-uxxl16-with-marron-straight-cut-mount-and-2-sprays-autumn) — $1,000.00

## Prices

Median price $533 across 2,370 priced products. Current prices, assumed USD.

| Price range | Products |
| --- | --- |
| Under $225 | 2 |
| $225–$1,100 | 2,249 |
| $1,100 and up | 119 |

## Categories

| Category | Products |
| --- | --- |
| Hats & Headwear | 2,370 |

## 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, 2,369 |
| `color` | Product color | Merchant data | 55% | 67 | `pink` = Pink, 256; `ivory` = Ivory, 173; `black` = Black, 146; `white` = White, 120; `beige` = Beige, 116 |
| `color_family` | Color family | Merchant data | 55% | 12 | `Pink` = Pink, 391; `White` = White, 302; `Blue` = Blue, 274; `Black` = Black, 146; `Red` = Red, 144 |
| `age_groups` | Age Group | StoreRouter enrichment | 100% | 1 | `adult` = Adult, 2,369 |
| `category_path.depth_0` | Category at depth 0 | StoreRouter enrichment | 100% | 1 | `apparel & accessories` = Apparel & Accessories, 2,370 |
| `category_path.depth_1` | Category at depth 1 | StoreRouter enrichment | 100% | 1 | `accessories` = Accessories, 2,370 |
| `category_path.depth_2` | Category at depth 2 | StoreRouter enrichment | 100% | 1 | `hats & headwear` = Hats & Headwear, 2,370 |
| `category_path.depth_3` | Category at depth 3 | StoreRouter enrichment | 100% | 2 | `statement & occasion` = Statement & Occasion, 2,300; `classic` = Classic, 70 |
| `category_path.depth_4` | Category at depth 4 | StoreRouter enrichment | 100% | 2 | `fascinators` = Fascinators, 2,300; `sun hats` = Sun Hats, 70 |
| `gender` | Gender | StoreRouter enrichment | 100% | 1 | `female` = Female, 2,369 |
| `pattern` | Pattern | StoreRouter enrichment | 99% | 26 | `pattern__solid` = Solid, 2,092; `pattern__floral` = Floral, 299; `pattern__texture` = Texture, 152; `pattern__abstract` = Abstract, 81; `pattern__art` = Art, 62 |
| `occasion_general` | Occasion | StoreRouter enrichment | 91% | 2 | `occasion_general__formal` = Formal, 2,060; `occasion_general__casual` = Casual, 428 |
| `fabric` | Fabric | StoreRouter enrichment | 11% | 10 | `fabric__tulle` = Tulle, 116; `fabric__organza` = Organza, 48; `fabric__mesh` = Mesh, 41; `fabric__other` = Other, 41; `fabric__rattan` = Rattan, 17 |
| `season` | Season | StoreRouter enrichment | 8% | 2 | `season__warm_weather` = Warm Weather, 180; `season__all_season` = All-Season, 1 |
| `material` | Material | StoreRouter enrichment | 2% | 7 | `material__straw` = Straw, 39; `material__raffia` = Raffia, 13; `material__fur` = Fur, 2; `material__felt` = Felt, 1; `material__mesh` = Mesh, 1 |
| `brand_name` | Canonical brand name | Brand | 100% | 1 | `The Hat Girls` = The Hat Girls, 2,370 |
