# Cottoncitizen (cottoncitizen.com) product data API > Search Cottoncitizen products with StoreRouter’s API. Get prices, images, and details as JSON. See coverage and curl, Python, and TypeScript examples. - Catalog key: `cottoncitizen` (pass in `"catalogs"` to narrow a search to this store) - Products: 430 - Snapshot: 2026-10-16T17:45:39Z (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/cottoncitizen - Get an API key: https://platform.storerouter.ai/auth/organization ## Questions ### What does Cottoncitizen sell? Almost entirely Apparel & Accessories: 100% of its 430 products. Clothing is the largest department with 430 products. The most common Cottoncitizen categories are Tops (244), Pants (119) and Shorts (22). ### How are Cottoncitizen products categorized? Into a shared taxonomy 6 levels deep. The first level separates Apparel & Accessories; the second separates departments such as Clothing; 5 levels down, categories are as specific as Tank & Cami Tops (41 products). Every level is a search facet. ### What can I filter Cottoncitizen products by? 54 searchable fields. Well-covered attributes include fabric (90% of products), sleeve length type (62%) and neckline (60%). For fabric, the most common values are Cotton, Modal and Denim; for sleeve length type, the most common values are Short, Long and Sleeveless. ### Is this API provided by Cottoncitizen or StoreRouter? StoreRouter. One API key gives your app or agent access to Cottoncitizen product data and thousands more stores. ### Can I get Cottoncitizen 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 Cottoncitizen 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 430 Cottoncitizen products, with coverage counts refreshed about daily. ### Where does the data come from? Straight from cottoncitizen.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 ### Marbella Cap Sleeve Tee From our soft and breathable vintage cotton collection, the Marbella Cap Sleeve Tee is an exciting new addition to this customer-favorite range of shirts and dresses. Cut as an effortless, slim-fitting silhouette, this tee features cap-inspired raw sleeves, a raw full length hem and the Marbella collection’s signature back seam detail. With a gently worn-in and loved feel, this 100% cotton staple will complement your foundational wardrobe rotation perfectly, designed to be an essential layering item in every closet.  Details Form fitting Exaggerated length Raw hems Center back seam detail Crew neckline 100% COTTON Size & Fit Model is 5'9.5" and wearing a size S. Fabric + Care 100-cotton,machine-wash-cold,tumble-dry-low,do-not-bleach Indexed response retrieved 2026-10-16T17:45:43.747Z. Price and availability may change. Availability: In stock Sizes: XS, S, M, L ### Product details Product content returned by the lookup API, ready for a product page. ```json { "source": "indexed", "catalogKey": "cottoncitizen", "product": { "title": "Marbella Cap Sleeve Tee", "brand": null, "productUrl": "https://cottoncitizen.com/products/marbella-cap-sleeve-tee-vintage-navy", "currentPrice": 135, "currency": null, "inStock": true, "description": "From our soft and breathable vintage cotton collection, the Marbella Cap Sleeve Tee is an exciting new addition to this customer-favorite range of shirts and dresses. Cut as an effortless, slim-fitting silhouette, this tee features cap-inspired raw sleeves, a raw full length hem and the Marbella collection’s signature back seam detail. With a gently worn-in and loved feel, this 100% cotton staple will complement your foundational wardrobe rotation perfectly, designed to be an essential layering item in every closet.  Details Form fitting Exaggerated length Raw hems Center back seam detail Crew neckline 100% COTTON Size & Fit Model is 5'9.5\" and wearing a size S. Fabric + Care 100-cotton,machine-wash-cold,tumble-dry-low,do-not-bleach", "primaryImage": { "url": "https://cdn.shopify.com/s/files/1/0698/9615/files/W137615SS25MARBELLACAPSLEEVETEEVINTAGENAVY24.jpg?v=1745605621", "cdnUrl": "https://cdn.octogen.ai/bccd5dc6c26879d564e63c4738c021e6/5c809d64f6c77a15ed15f363ca72b28c.jpeg?request_id=7ae861bb-bc48-40c5-81b7-762747bdcfb3", "width": 2133, "height": 3200, "sizeBytes": 842420, "mimeType": "image/jpeg" }, "details": { "materials": [], "fit": [], "dimensions": null, "patterns": [] } } } ``` ### Enrichment StoreRouter classification and attributes. Use attribute_handles as search facet values. ```json { "source": "indexed", "catalogKey": "cottoncitizen", "product": { "enrichment": { "type": "t-shirt", "category_path": [ "Apparel & Accessories", "Clothing", "Tops", "T-Shirts" ], "styles": [ "casual", "minimalist" ], "attributes": { "Fabric": [ "Cotton" ], "Pattern": [ "Solid" ], "Neckline": [ "Crew", "Round" ], "Fit (Tops)": [ "Fitted" ], "Graphic Type": [ "Solid / No Print" ], "Sleeve Style": [ "Cap" ], "Front Closure": [ "None" ], "Sleeve length type": [ "Short" ], "Front Closure Length": [ "None" ] }, "attribute_handles": { "fabric": [ "fabric__cotton" ], "fit_top": [ "fit_top__fitted" ], "pattern": [ "pattern__solid" ], "neckline": [ "neckline__crew", "neckline__round" ], "graphic_type": [ "graphic_type__solid_no_print" ], "sleeve_style": [ "sleeve_style__cap" ], "front_closure_type": [ "front_closure_type__none" ], "sleeve_length_type": [ "sleeve_length_type__short" ], "front_closure_length": [ "front_closure_length__none" ] } } } } ``` ## 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": ["cottoncitizen"], "q": "tops", "limit": 5 }' ``` Selected matching products on October 16, 2026 (not the complete search response): - [Marbella Cap Sleeve Tee](https://cottoncitizen.com/products/marbella-cap-sleeve-tee-vintage-navy) - [Marbella Cap Sleeve Tee](https://cottoncitizen.com/products/marbella-cap-sleeve-tee-vintage-black) - [Monaco Polo Tee](https://cottoncitizen.com/products/monaco-polo-tee-bone) - [Verona Racerback Tank](https://cottoncitizen.com/products/verona-racerback-tank-vintage-apple) - [Verona Scoop Tank](https://cottoncitizen.com/products/verona-scoop-tank-jet-black) ## Prices Median price $175 across 430 priced products. Current prices, assumed USD. | Price range | Products | | --- | --- | | $70–$120 | 122 | | $120–$170 | 82 | | $170–$220 | 65 | | $220–$270 | 74 | | $270–$320 | 43 | | $320 and up | 44 | ## Categories | Category | Products | | --- | --- | | Tops | 244 | | Pants | 119 | | Shorts | 22 | | Dresses | 20 | | Underwear & Sleepwear | 20 | | Jackets & Coats | 5 | ## Searchable fields Use `name` and a `value` as a facet: `{"name": "", "values": [""]}`. | name | Field | Source | Coverage | Distinct values | Top values (`value` = label, products) | | --- | --- | --- | --- | --- | --- | | `color` | Product color | Merchant data | 100% | 28 | `black` = Black, 151; `navy` = Navy, 69; `white` = White, 51; `ivory` = Ivory, 29; `blue` = Blue, 24 | | `color_family` | Color family | Merchant data | 100% | 12 | `Black` = Black, 151; `Blue` = Blue, 106; `White` = White, 81; `Brown` = Brown, 46; `Gray` = Gray, 24 | | `is_activewear` | Activewear | Merchant data | 100% | 2 | `false` = False, 388; `true` = True, 42 | | `age_groups` | Age Group | StoreRouter enrichment | 100% | 1 | `adult` = Adult, 430 | | `category_path.depth_0` | Category at depth 0 | StoreRouter enrichment | 100% | 1 | `apparel & accessories` = Apparel & Accessories, 430 | | `category_path.depth_1` | Category at depth 1 | StoreRouter enrichment | 100% | 1 | `clothing` = Clothing, 430 | | `category_path.depth_2` | Category at depth 2 | StoreRouter enrichment | 100% | 6 | `tops` = Tops, 244; `pants` = Pants, 119; `shorts` = Shorts, 22; `dresses` = Dresses, 20; `underwear & sleepwear` = Underwear & Sleepwear, 20 | | `gender` | Gender | StoreRouter enrichment | 100% | 3 | `female` = Female, 240; `male` = Male, 177; `unisex` = Unisex, 13 | | `pattern` | Pattern | StoreRouter enrichment | 100% | 3 | `pattern__solid` = Solid, 429; `pattern__texture` = Texture, 43; `pattern__tie_dye` = Tie Dye, 1 | | `category_path.depth_3` | Category at depth 3 | StoreRouter enrichment | 95% | 14 | `t-shirts` = T-Shirts, 149; `jeans` = Jeans, 56; `tank tops & sleeveless` = Tank Tops & Sleeveless, 41; `trousers` = Trousers, 33; `shirts & blouses` = Shirts & Blouses, 26 | | `fabric` | Fabric | StoreRouter enrichment | 91% | 9 | `fabric__cotton` = Cotton, 311; `fabric__modal` = Modal, 78; `fabric__denim` = Denim, 61; `fabric__poplin` = Poplin, 27; `fabric__elastane` = Elastane (Spandex / Lycra), 26 | | `sleeve_length_type` | Sleeve length type | StoreRouter enrichment | 63% | 4 | `sleeve_length_type__short` = Short, 107; `sleeve_length_type__long` = Long, 106; `sleeve_length_type__sleeveless` = Sleeveless, 51; `sleeve_length_type__3/4` = 3/4, 5 | | `graphic_type` | Graphic Type | StoreRouter enrichment | 62% | 1 | `graphic_type__solid_no_print` = Solid / No Print, 266 | | `neckline` | Neckline | StoreRouter enrichment | 61% | 10 | `neckline__crew` = Crew, 156; `neckline__round` = Round, 65; `neckline__collared` = Collared, 32; `neckline__scoop` = Scoop, 31; `neckline__v_neck` = V Neck, 19 | | `front_closure_type` | Front Closure | StoreRouter enrichment | 57% | 3 | `front_closure_type__none` = None, 211; `front_closure_type__buttons` = Buttons, 32; `front_closure_type__zipper` = Zipper, 1 | | `front_closure_length` | Front Closure Length | StoreRouter enrichment | 52% | 5 | `front_closure_length__none` = None, 190; `front_closure_length__full` = Full, 20; `front_closure_length__short_placket` = Short Placket, 10; `front_closure_length__quarter` = Quarter, 2; `front_closure_length__half` = Half, 1 | | `fit_top` | Fit (Tops) | StoreRouter enrichment | 42% | 7 | `fit_top__fitted` = Fitted, 69; `fit_top__relaxed` = Relaxed, 68; `fit_top__oversized` = Oversized, 24; `fit_top__regular` = Regular, 16; `fit_top__boxy` = Boxy, 12 | | `collar_style` | Collar Style | StoreRouter enrichment | 40% | 4 | `collar_style__crew` = Crew, 129; `collar_style__collarless` = Collarless, 33; `collar_style__polo` = Polo, 16; `collar_style__point` = Point, 4 | | `knit_style` | Knit Style | StoreRouter enrichment | 32% | 5 | `knit_style__jersey` = Jersey, 72; `knit_style__rib_knit` = Rib Knit, 46; `knit_style__waffle` = Waffle, 16; `knit_style__french_terry` = French Terry, 11; `knit_style__pique` = Piqué, 8 | | `fit_bottoms` | Fit | StoreRouter enrichment | 31% | 8 | `fit_bottoms__relaxed_boyfriend_fit` = Relaxed / Boyfriend Fit, 74; `fit_bottoms__straight_through_fit` = Straight-Through Fit, 24; `fit_bottoms__loose_slouchy_fit` = Loose / Slouchy Fit, 22; `fit_bottoms__wide_leg_volume_fit` = Wide-Leg Volume Fit, 22; `fit_bottoms__tailored_slim_fit` = Tailored Slim Fit, 16 | | `pants_leg_shape` | Leg Shape | StoreRouter enrichment | 26% | 7 | `pants_leg_shape__wide_leg` = Wide Leg, 38; `pants_leg_shape__straight` = Straight, 35; `pants_leg_shape__slim` = Slim, 21; `pants_leg_shape__bootcut` = Bootcut, 12; `pants_leg_shape__barrel_balloon` = Barrel / Balloon, 7 | | `fabric_weight` | Fabric Weight | StoreRouter enrichment | 18% | 3 | `fabric_weight__lightweight` = Lightweight, 55; `fabric_weight__midweight` = Midweight, 21; `fabric_weight__heavyweight` = Heavyweight, 3 | | `bottoms_closure` | Bottoms Closure | StoreRouter enrichment | 18% | 4 | `bottoms_closure__pull_on` = Pull-On, 38; `bottoms_closure__drawstring` = Drawstring, 35; `bottoms_closure__zip` = Zip Fly, 11; `bottoms_closure__buttons` = Button Fly, 4 | | `category_path.depth_4` | Category at depth 4 | StoreRouter enrichment | 18% | 6 | `tank & cami tops` = Tank & Cami Tops, 41; `thermals & base layers` = Thermals & Base Layers, 12; `sweatshirts` = Sweatshirts, 11; `loungewear` = Loungewear, 8; `trucker jackets` = Trucker Jackets, 5 | | `general_clothing_features` | General Clothing Features | StoreRouter enrichment | 16% | 1 | `general_clothing_features__stretchable` = Stretchable, 67 | | `opacity_level` | Opacity | StoreRouter enrichment | 12% | 1 | `opacity_level__opaque` = Opaque, 53 | | `top_length_type` | Top length type | StoreRouter enrichment | 12% | 3 | `top_length_type__cropped` = Cropped, 35; `top_length_type__waist_length` = Waist Length, 10; `top_length_type__hip_length` = Hip Length, 6 | | `denim_fabric` | Denim Fabric | StoreRouter enrichment | 11% | 3 | `denim_fabric__stretch` = Stretch, 31; `denim_fabric__rigid` = Rigid, 16; `denim_fabric__colored` = Colored, 2 | | `sleeve_style` | Sleeve Style | StoreRouter enrichment | 10% | 4 | `sleeve_style__drop_shoulder` = Drop Shoulder, 32; `sleeve_style__set_in` = Set-In, 6; `sleeve_style__cap` = Cap, 3; `sleeve_style__raglan` = Raglan, 2 | | `denim_wash` | Denim Wash | StoreRouter enrichment | 8% | 4 | `denim_wash__black` = Black, 18; `denim_wash__dark` = Dark, 8; `denim_wash__medium` = Medium, 4; `denim_wash__colored` = Colored, 3 | | `placket_type` | Front Opening | StoreRouter enrichment | 7% | 1 | `placket_type__exposed` = Visible Buttons, 32 | | `denim_wash_effects` | Denim Finish Effects | StoreRouter enrichment | 6% | 4 | `denim_wash_effects__clean_none` = Clean / None, 10; `denim_wash_effects__faded_stonewash` = Faded / Stonewash, 9; `denim_wash_effects__distressed` = Distressed, 4; `denim_wash_effects__raw` = Raw, 4 | | `waist_rise` | Waist rise | StoreRouter enrichment | 6% | 3 | `waist_rise__mid` = Mid, 14; `waist_rise__low` = Low, 11; `waist_rise__high` = High, 2 | | `sustainability_features` | Sustainability Features | StoreRouter enrichment | 6% | 1 | `sustainability_features__recycled_materials` = Recycled Materials, 24 | | `shorts_fit` | Shorts Fit | StoreRouter enrichment | 5% | 2 | `shorts_fit__relaxed` = Relaxed, 18; `shorts_fit__athletic` = Athletic, 4 | | `performance_features` | Performance Features | StoreRouter enrichment | 5% | 1 | `performance_features__breathable_design` = Breathable Design, 21 | | `dress_style` | Dress style | StoreRouter enrichment | 5% | 4 | `dress_style__bodycon` = Bodycon, 16; `dress_style__tank` = Tank, 8; `dress_style__sweatshirt` = Sweatshirt, 2; `dress_style__t_shirt` = T-Shirt, 1 | | `skirt_dress_length_type` | Skirt/Dress length type | StoreRouter enrichment | 5% | 3 | `skirt_dress_length_type__maxi` = Maxi, 12; `skirt_dress_length_type__mini` = Mini, 7; `skirt_dress_length_type__midi` = Midi, 1 | | `occasion_general` | Occasion | StoreRouter enrichment | 4% | 1 | `occasion_general__casual` = Casual, 19 | | `occasion_style_dresses` | Dress occasion | StoreRouter enrichment | 4% | 1 | `occasion_style_dresses__casual` = Casual, 17 | | `insulation_level` | Insulation Level | StoreRouter enrichment | 3% | 3 | `insulation_level__thermal` = Thermal, 12; `insulation_level__lightweight` = Lightweight, 9; `insulation_level__midweight` = Midweight, 2 | | `denim_hem_style` | Denim Hem Style | StoreRouter enrichment | 3% | 1 | `denim_hem_style__regular` = Regular, 11 | | `pants_length_type` | Pants length type | StoreRouter enrichment | 2% | 3 | `pants_length_type__ankle` = Ankle Length, 5; `pants_length_type__capri` = Capri, 4; `pants_length_type__cropped` = Cropped, 3 | | `stretch_level` | Stretch Level | StoreRouter enrichment | 2% | 2 | `stretch_level__none` = None, 7; `stretch_level__high` = High, 2 | | `category_path.depth_5` | Category at depth 5 | StoreRouter enrichment | 2% | 1 | `lounge bottoms` = Lounge Bottoms, 8 | | `construction_detail` | Construction Detail | StoreRouter enrichment | 2% | 1 | `construction_detail__draped` = Draped, 7 | | `outerwear_length_type` | Outerwear Length | StoreRouter enrichment | 1% | 2 | `outerwear_length_type__hip` = Hip Length, 3; `outerwear_length_type__cropped` = Cropped, 2 | | `pants_leg_length` | Pants Leg Length | StoreRouter enrichment | 1% | 2 | `pants_leg_length__cropped` = Cropped, 5; `pants_leg_length__ankle` = Ankle, 2 | | `embellishments` | Embellishments | StoreRouter enrichment | <1% | 1 | `embellishments__contrast_piping` = Contrast Trim / Piping, 4 | | `season` | Season | StoreRouter enrichment | <1% | 1 | `season__all_season` = All-Season, 4 | | `surface_finish` | Surface Finish | StoreRouter enrichment | <1% | 1 | `surface_finish__matte` = Matte, 3 | | `outerwear_unique_features` | Outerwear Features | StoreRouter enrichment | <1% | 1 | `outerwear_unique_features__hooded` = Hooded, 1 | | `size_group` | Size Type | StoreRouter enrichment | <1% | 1 | `size_group__regular` = Regular, 1 | | `brand_name` | Canonical brand name | Brand | 81% | 3 | `Cotton Citizen` = Cotton Citizen, 281; `dropped perm` = dropped perm, 37; `Denim Permanent` = Denim Permanent, 30 |