Catalog coverage · katespade
Catalog coverage · katespade.com
Search products from katespade.com and retrieve product details as JSON through StoreRouter’s API. Access prices, images, descriptions, and available variant data, plus enriched attributes for filtering.
Snapshot from . Counts are approximate and refresh about daily.
Developer quickstart
export OCTOGEN_PLATFORM_API_KEY="your-api-key". Requests use Authorization: Bearer; the SDKs read this variable automatically. Keep the key on your server.curl -sS https://api.storerouter.ai/v1/products/search \ -H "Authorization: Bearer $OCTOGEN_PLATFORM_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "catalogs": ["katespade"], "q": "earrings", "limit": 5 }'# Requires Python 3.11+ and uv; install from the public SDK repository:
# git clone https://github.com/octogen-ai/octogen-dev.git
# cd octogen-dev
# uv sync --project sdks/python
# Save this sample as search.py here, then run:
# uv run --project sdks/python python search.py
import asyncio
from octogen_ai_sdk import OctogenClient
async def main() -> None:
async with OctogenClient(base_url="https://api.storerouter.ai/v1") as client:
page = await client.search_products(
catalogs=["katespade"],
q="earrings",
limit=5,
)
for product in page.items:
print(product.title, product.current_price, product.product_url)
asyncio.run(main())// Node.js 20+; install: npm install @octogen-ai/sdk
// Save this sample as search.mjs, then run: node search.mjs
import { OctogenClient } from "@octogen-ai/sdk";
const client = new OctogenClient({ baseUrl: "https://api.storerouter.ai/v1" });
const page = await client.searchProducts({
catalogs: ["katespade"],
q: "earrings",
limit: 5,
});
for (const product of page.items) {
console.log(product.title, product.currentPrice, product.productUrl);
}Indexed snapshot from this search, verified by URL lookup. Selected fields only; prices and availability may have changed since retrieval.
Kate Spade
Kate Spade
Kate Spade
Search finds indexed products by query and filters within this retailer’s catalog.Product URL lookup retrieves one product: index_only uses the index and returns 404 on a miss; auto checks the index before resolving a miss on demand. For a fresh page read where supported, use resolutionMode: "on_demand_only" with onDemandCachePolicy: "refresh". On-demand results may be partial and do not guarantee live price or availability.
Example product response
Inspect a product from the search example above, then retrieve its details through the API.
Indexed response retrieved . Price and availability reflect this response and may change.
Kate Spade
$38.00Out of stock
each piece in our that sparkle collection stays true to its name. we decked these round earrings out with bold faceted crystals that come in so many gorgeous shades. but here's our favorite part. the back posts are tiny spades. sweep your hair up to show them off.
Source product pageProduct content returned by the lookup API, ready for a product page.
JSON response excerpt
{
"source": "indexed",
"catalogKey": "katespade",
"product": {
"title": "That Sparkle Round Earrings",
"brand": {
"name": "Kate Spade"
},
"productUrl": "https://www.katespade.com/products/that-sparkle-round-earrings/WBRUH691.html",
"currentPrice": 38,
"currency": "USD",
"inStock": false,
"description": "each piece in our that sparkle collection stays true to its name. we decked these round earrings out with bold faceted crystals that come in so many gorgeous shades. but here's our favorite part. the back posts are tiny spades. sweep your hair up to show them off.",
"primaryImage": {
"url": "https://katespade.scene7.com/is/image/KateSpade/WBRUH691_337?wid=3000",
"cdnUrl": "https://cdn.octogen.ai/ccd28897099e2e29c56f5003df98fc3f/9fbfab7e6c31d495e58390ed91664bb2.webp?request_id=2f630bca-e91f-4c89-b1f1-9521981563f4",
"width": 3000,
"height": 2666,
"sizeBytes": 119042,
"mimeType": "image/webp"
},
"details": {
"materials": [],
"fit": [],
"dimensions": null,
"patterns": []
}
}
}StoreRouter classification and attributes. Use attribute_handles as search facet values.
JSON response excerpt
{
"source": "indexed",
"catalogKey": "katespade",
"product": {
"enrichment": {
"type": "earrings",
"category_path": [
"Apparel & Accessories",
"Jewelry",
"Earrings"
],
"styles": [
"glamorous",
"elegant"
],
"attributes": {
"Pattern": [
"Geometric",
"Solid"
],
"Jewelry type": [
"Costume"
],
"Earring design": [
"Stud"
],
"Jewelry material": [
"Crystal"
]
},
"attribute_handles": {
"pattern": [
"pattern__geometric",
"pattern__solid"
],
"jewelry_type": [
"jewelry_type__costume"
],
"earring_design": [
"earring_design__stud"
],
"jewelry_material": [
"jewelry_material__crystal"
]
}
}
}
}curl -sS https://api.storerouter.ai/v1/products/lookup \
-H "Authorization: Bearer $OCTOGEN_PLATFORM_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"url": "https://www.katespade.com/products/that-sparkle-round-earrings/WBRUH691.html",
"resolutionMode": "index_only"
}'Selected response fields are shown. API documentation
Catalog
Attributes
Each attribute below is a search facet: the bar shows the share of Kate Spade products that have it, and each value shows the share tagged with that value. A product can have several values, so these can add up to more than 100%.
Product color
color
Color family
color_family
Gender
gender
Pattern
pattern
Jewelry material
jewelry_material
Jewelry type
jewelry_type
Earring design
earring_design
Carry options
carry_options
| Field | Facet name | Source | Coverage | Values |
|---|---|---|---|---|
| Activewear | is_activewear | Merchant data | 100% | 2 |
| Product color | color | Merchant data | 99% | 58 |
| Color family | color_family | Merchant data | 99% | 12 |
| Category at depth 0 | category_path.depth_0 | StoreRouter enrichment | 100% | 3 |
| Category at depth 1 | category_path.depth_1 | StoreRouter enrichment | 100% | 7 |
| Category at depth 2 | category_path.depth_2 | StoreRouter enrichment | 100% | 41 |
| Age Group | age_groups | StoreRouter enrichment | 98% | 1 |
| Gender | gender | StoreRouter enrichment | 98% | 3 |
| Pattern | pattern | StoreRouter enrichment | 91% | 38 |
| Jewelry material | jewelry_material | StoreRouter enrichment | 41% | 25 |
| Category at depth 3 | category_path.depth_3 | StoreRouter enrichment | 36% | 48 |
| Jewelry type | jewelry_type | StoreRouter enrichment | 26% | 3 |
| Earring design | earring_design | StoreRouter enrichment | 19% | 8 |
| Carry options | carry_options | StoreRouter enrichment | 16% | 7 |
| Bag closure type | bag_closure_type | StoreRouter enrichment | 15% | 8 |
| Bag/Case material | bag_case_material | StoreRouter enrichment | 15% | 16 |
| Bag Shape | bag_shape | StoreRouter enrichment | 14% | 9 |
| Necklace design | necklace_design | StoreRouter enrichment | 13% | 9 |
| Hardware finish | hardware_finish | StoreRouter enrichment | 12% | 3 |
| Graphic Type | graphic_type | StoreRouter enrichment | 11% | 8 |
| Bag Size | bag_size | StoreRouter enrichment | 10% | 4 |
| Material | material | StoreRouter enrichment | 10% | 14 |
| Bracelet design | bracelet_design | StoreRouter enrichment | 8% | 9 |
| Toe Shape | toe_style | StoreRouter enrichment | 8% | 4 |
| Closure type | shoe_closure_type | StoreRouter enrichment | 7% | 8 |
| Footwear material | footwear_material | StoreRouter enrichment | 7% | 12 |
| Fabric | fabric | StoreRouter enrichment | 7% | 23 |
| Sleeve length type | sleeve_length_type | StoreRouter enrichment | 7% | 3 |
| Shoulder Bag Style Type | shoulder_bag_style_type | StoreRouter enrichment | 7% | 6 |
| Surface Finish | surface_finish | StoreRouter enrichment | 6% | 3 |
| Season | season | StoreRouter enrichment | 6% | 4 |
| Wallet features | wallet_features | StoreRouter enrichment | 6% | 2 |
| Occasion style | occasion_style_shoes | StoreRouter enrichment | 6% | 2 |
| Category at depth 4 | category_path.depth_4 | StoreRouter enrichment | 6% | 20 |
| Neckline | neckline | StoreRouter enrichment | 5% | 14 |
| Heel height | shoe_heel_height | StoreRouter enrichment | 5% | 4 |
| Bag strap details | bag_strap_details | StoreRouter enrichment | 5% | 3 |
| Sandal style | sandal_style | StoreRouter enrichment | 4% | 8 |
| Ring design | ring_design | StoreRouter enrichment | 4% | 10 |
| Embellishments | embellishments | StoreRouter enrichment | 3% | 9 |
| Front Closure | front_closure_type | StoreRouter enrichment | 3% | 6 |
| Eyewear frame color | eyewear_frame_color | StoreRouter enrichment | 3% | 14 |
| Eyewear frame design | eyewear_frame_design | StoreRouter enrichment | 3% | 7 |
| Skirt/Dress length type | skirt_dress_length_type | StoreRouter enrichment | 3% | 4 |
| Bag/Case features | bag_case_features | StoreRouter enrichment | 3% | 2 |
| Bag/Case storage features | bag_case_storage_features | StoreRouter enrichment | 3% | 5 |
| Eyewear frame pattern | eyewear_frame_pattern | StoreRouter enrichment | 3% | 4 |
| Dress style | dress_style | StoreRouter enrichment | 3% | 14 |
| Lens color | lens_color | StoreRouter enrichment | 3% | 7 |
| Front Closure Length | front_closure_length | StoreRouter enrichment | 3% | 3 |
| Lens pattern | lens_pattern | StoreRouter enrichment | 3% | 2 |
| Sole Type | shoe_sole_type | StoreRouter enrichment | 3% | 6 |
| Collar Style | collar_style | StoreRouter enrichment | 2% | 8 |
| Construction Detail | construction_detail | StoreRouter enrichment | 2% | 6 |
| Tote handle type | tote_handle_type | StoreRouter enrichment | 2% | 3 |
| Temple color | temple_color | StoreRouter enrichment | 2% | 12 |
| Shoe Type (Silhouette / Style) | flat_shoe_style_type | StoreRouter enrichment | 2% | 7 |
| Temple pattern | temple_pattern | StoreRouter enrichment | 2% | 3 |
| Eyewear Frame Material | eyewear_frame_material | StoreRouter enrichment | 2% | 3 |
| Dress occasion | occasion_style_dresses | StoreRouter enrichment | 2% | 4 |
| Shoe Type (Silhouette/Style) | heel_shoe_style_type | StoreRouter enrichment | 2% | 5 |
| Heel Type (Shape / Construction) | shoe_heel_type | StoreRouter enrichment | 2% | 4 |
| Front Opening | placket_type | StoreRouter enrichment | 1% | 3 |
| Scarf/Shawl style | scarf_shawl_style | StoreRouter enrichment | 1% | 2 |
| Sleeve Style | sleeve_style | StoreRouter enrichment | 1% | 6 |
| Top length type | top_length_type | StoreRouter enrichment | 1% | 4 |
| Sustainability Features | sustainability_features | StoreRouter enrichment | 1% | 3 |
| Opacity | opacity_level | StoreRouter enrichment | 1% | 3 |
| Fragrance Family | fragrance_family | StoreRouter enrichment | <1% | 7 |
| Fragrance Notes | fragrance_notes | StoreRouter enrichment | <1% | 21 |
| General Clothing Features | general_clothing_features | StoreRouter enrichment | <1% | 3 |
| Outerwear Length | outerwear_length_type | StoreRouter enrichment | <1% | 4 |
| Product form | product_form | StoreRouter enrichment | <1% | 2 |
| Scent | scent | StoreRouter enrichment | <1% | 8 |
| Clutch Style | clutch_style | StoreRouter enrichment | <1% | 2 |
| Knit Style | knit_style | StoreRouter enrichment | <1% | 4 |
| Closure Type | closure_type_belts | StoreRouter enrichment | <1% | 1 |
| Fabric Weight | fabric_weight | StoreRouter enrichment | <1% | 3 |
| Top Notes | fragrance_top_notes | StoreRouter enrichment | <1% | 15 |
| Openwork Detail | openwork_detail | StoreRouter enrichment | <1% | 3 |
| Shoe features | shoe_features | StoreRouter enrichment | <1% | 3 |
| Shoe Type (Silhouette/Style) | sneaker_shoe_style_type | StoreRouter enrichment | <1% | 1 |
| Sneaker style | sneaker_style | StoreRouter enrichment | <1% | 2 |
| Band color | band_color | StoreRouter enrichment | <1% | 2 |
| Band pattern | band_pattern | StoreRouter enrichment | <1% | 4 |
| Case color | case_color | StoreRouter enrichment | <1% | 2 |
| Dial color | dial_color | StoreRouter enrichment | <1% | 3 |
| Dial pattern | dial_pattern | StoreRouter enrichment | <1% | 2 |
| Outerwear Features | outerwear_unique_features | StoreRouter enrichment | <1% | 4 |
| Watch case shape | watch_case_shape | StoreRouter enrichment | <1% | 1 |
| Watch display | watch_display | StoreRouter enrichment | <1% | 1 |
| Watch material | watch_material | StoreRouter enrichment | <1% | 2 |
| Backpack Style | backpack_style | StoreRouter enrichment | <1% | 3 |
| Base Notes | fragrance_base_notes | StoreRouter enrichment | <1% | 5 |
| Occasion | occasion_general | StoreRouter enrichment | <1% | 2 |
| Band material | band_material | StoreRouter enrichment | <1% | 3 |
| Boot Shaft Height | boot_shaft_height | StoreRouter enrichment | <1% | 2 |
| Boot style | boot_style | StoreRouter enrichment | <1% | 2 |
| Case pattern | case_pattern | StoreRouter enrichment | <1% | 1 |
| Fit (Tops) | fit_top | StoreRouter enrichment | <1% | 3 |
| Insulation Level | insulation_level | StoreRouter enrichment | <1% | 2 |
| Shaft Design | shaft_design | StoreRouter enrichment | <1% | 2 |
| Skirt style | skirt_style | StoreRouter enrichment | <1% | 3 |
| Book cover type | book_cover_type | StoreRouter enrichment | <1% | 1 |
| Chain link type | chain_link_type | StoreRouter enrichment | <1% | 1 |
| Denim Wash | denim_wash | StoreRouter enrichment | <1% | 2 |
| Shoe Type (Silhouette/Style) | dress_shoe_style_type | StoreRouter enrichment | <1% | 1 |
| Heart Notes | fragrance_heart_notes | StoreRouter enrichment | <1% | 6 |
| Genre | genre | StoreRouter enrichment | <1% | 4 |
| Language version | language_version | StoreRouter enrichment | <1% | 1 |
| Swim bottom coverage style | swim_bottom_coverage_style | StoreRouter enrichment | <1% | 1 |
| Swim top coverage style | swim_top_coverage_style | StoreRouter enrichment | <1% | 2 |
| Target audience | target_audience | StoreRouter enrichment | <1% | 1 |
| Denim Finish Effects | denim_wash_effects | StoreRouter enrichment | <1% | 1 |
| Fit | fit_bottoms | StoreRouter enrichment | <1% | 1 |
| Handwear features | handwear_features | StoreRouter enrichment | <1% | 2 |
| Handwear material | handwear_material | StoreRouter enrichment | <1% | 1 |
| Handwear type | handwear_type | StoreRouter enrichment | <1% | 1 |
| Lining Material | lining_material_outerwear | StoreRouter enrichment | <1% | 2 |
| Leg Shape | pants_leg_shape | StoreRouter enrichment | <1% | 1 |
| Ring size | ring_size | StoreRouter enrichment | <1% | 1 |
| Shorts Fit | shorts_fit | StoreRouter enrichment | <1% | 1 |
| Swimwear Features | swimwear_unique_features | StoreRouter enrichment | <1% | 1 |
| Watch accessory style | watch_accessory_style | StoreRouter enrichment | <1% | 1 |
| Canonical brand name | brand_name | Brand | 100% | 1 |
Data
For agents
Every facet name and value on this page, ready for an agent or a script.
Are you an AI agent? Fetch https://storerouter.ai/llms.txt to learn how to get product data from StoreRouter, and how to make a storefront's products readable by agents.
One API key gives your agent search, product lookup, and similar-item results across every store StoreRouter indexes.
Get an API key