zumiez.com APIzumiez.com ↗
Search Zumiez products by keyword, browse by category, and fetch detailed product data including pricing, stock status, images, and attributes.
curl -X GET 'https://api.parse.bot/scraper/3f2ae8fa-e680-48de-aaed-05f305a59cdd/search_products?page=1&limit=5&query=hoodie' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for products by keyword on Zumiez. Returns paginated results with product summaries including pricing, brand, and image URLs.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination. |
| limit | integer | Number of products per page. |
| queryrequired | string | Search keyword (e.g. 'hoodie', 'shoes', 'skateboard'). |
{
"type": "object",
"fields": {
"page": "integer current page number",
"limit": "integer number of products per page",
"total": "integer total number of matching products",
"products": "array of product summary objects with id, sku, product_group, brand, name, price, final_price, msrp, image_url, product_url",
"total_pages": "integer total number of pages"
},
"sample": {
"data": {
"page": 1,
"limit": 5,
"total": 14299,
"products": [
{
"id": 949940373,
"sku": "40537106670002",
"msrp": null,
"name": "Cookies Paradise Scatter Stone Black Zip Hoodie",
"brand": "Cookies Clothing",
"price": "119.95",
"image_url": "//scene7.zumiez.com/is/image/zumiez/405371-US",
"final_price": "119.95",
"product_url": "https://www.zumiez.com/cookies-paradise-scatter-stone-black-zip-hoodie.html",
"product_group": "405371"
}
],
"total_pages": 2860
},
"status": "success"
}
}About the zumiez.com API
The Zumiez API exposes 3 endpoints that cover product search, category browsing, and detailed product lookups across Zumiez.com. The search_products endpoint returns paginated results with up to 10 fields per product including brand, price, final price, and image URLs. The get_product_details endpoint adds full attribute arrays (color, size, features), stock status, and multiple product images identified by a product group ID from search or category results.
Endpoints Overview
The API provides three endpoints: search_products, list_products_by_category, and get_product_details. Search and category endpoints share the same paginated product summary shape, returning fields including id, sku, product_group, brand, name, price, final_price, msrp, image_url, and product_url. Both accept page and limit parameters for pagination, and each response includes total and total_pages so you can walk full result sets.
Search and Category Browsing
search_products accepts a required query string (e.g. 'hoodie', 'skateboard') and returns matching products ranked by relevance. list_products_by_category takes a category_path string such as '/shoes.html' or '/mens/hoodies.html' — the path must end in .html. Both endpoints return the same summary object shape, so the product_group value from either can be passed directly to get_product_details.
Product Detail Data
get_product_details takes a single product_group ID and returns the full product record: name, brand, sku, price, final_price, stock_status (e.g. 'IN_STOCK'), a description string, and an images array of URLs. The attributes array contains objects with attribute_code, attribute_label, attribute_value, and attribute_options, covering dimensions like color, size, and product features. This is the field to use when building size selectors or filtering by color.
Pagination and ID Chaining
Search and category endpoints default to page 1. Use the total_pages field in each response to determine how many requests are needed to walk a full result set. The product_group field in summary results is the required input for the detail endpoint — it is not the same as id or sku, so store it explicitly if you plan to chain calls.
- Sync Zumiez product catalog (name, brand, price, image) to a comparison shopping tool
- Monitor price and final_price fields across skateboard or streetwear categories for deal alerts
- Build a size and color availability checker using the attributes array from get_product_details
- Track stock_status changes on specific product groups to notify customers when items are back in stock
- Aggregate msrp vs final_price data across search results to identify sale depth by category
- Fetch product images and descriptions for affiliate marketing content using product_url and images fields
- Paginate through a full category path to build a local searchable index of Zumiez inventory
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.