Scuffers APIscuffers.com ↗
Access Scuffers fashion catalog via API: search products, browse 239+ collections, get full product details, new arrivals, and sale items with discount data.
What is the Scuffers API?
The Scuffers API exposes 6 endpoints covering the full Scuffers fashion catalog, from keyword search to detailed product records. The get_product endpoint returns complete variant data including sizes, colors, all image URLs, and tags, while get_sale_items includes a computed discount_percent field. You can browse over 239 collections enumerated by get_categories and paginate through their contents using get_category_products.
curl -X GET 'https://api.parse.bot/scraper/5ec1a691-e1c4-4185-ab4a-b536b857a326/search_products?page=1&query=shirt' \ -H 'X-API-Key: $PARSE_API_KEY'
Search products by keyword with optional category filter. Returns up to 10 matching products per query. Results come from the site's search suggest engine and are ranked by relevance.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination (currently limited to 10 results per query by the upstream search suggest API). |
| queryrequired | string | Search query text (e.g. 'shirt', 'hoodie', 'sneakers'). |
| category | string | Optional product type filter to narrow results (e.g. 'Man Shirt Longsleeved'). Matches the product_type field. |
{
"type": "object",
"fields": {
"count": "Number of products returned",
"query": "The search query that was executed",
"products": "Array of matching products with id, name, handle, price, compare_at_price, image, url, sku, product_type, vendor, available"
},
"sample": {
"data": {
"count": 10,
"query": "shirt",
"products": [
{
"id": 10047251382600,
"sku": null,
"url": "https://scuffers.com/products/japan-shirt",
"name": "Japan Shirt",
"image": "https://cdn.shopify.com/s/files/1/0035/9828/6912/files/DROP9ECOM0358.jpg?v=1778487974",
"price": "109.00",
"handle": "japan-shirt",
"vendor": "Scuffers",
"available": true,
"product_type": "Man Shirt Longsleeved",
"compare_at_price": "109.00"
}
]
},
"status": "success"
}
}About the Scuffers API
Product Search and Browsing
The search_products endpoint accepts a required query string (e.g. 'hoodie', 'sneakers') and an optional category filter that matches against the product_type field. Results return up to 10 products per query and include id, name, handle, price, compare_at_price, image, url, sku, product_type, vendor, and available status. The get_categories endpoint retrieves the full list of collections — typically around 239 — each with a handle, title, url, and published_at timestamp. Collection handles returned here feed directly into get_category_products as the category_id parameter.
Category and Collection Products
get_category_products accepts a category_id (the collection handle, e.g. 'footwear' or 'accessories') and an optional page integer for pagination. Each page returns up to 30 products with id, name, handle, price, compare_at_price, sku, image, url, product_type, and vendor. Passing an unrecognized handle returns an empty products array rather than an error. The same pagination model applies to get_new_arrivals and get_sale_items, both returning up to 30 products per page.
Product Details and Sale Data
get_product accepts either a product handle (e.g. 'japan-shirt') or a full product URL. The response includes the full description, all images as an array of full-resolution URLs, sizes and colors arrays reflecting available variants, tags, and per-variant sku data. The get_sale_items endpoint surfaces a discount_percent field computed from the difference between compare_at_price and the current price, making it straightforward to sort or filter by markdown depth without additional calculation.
The Scuffers API is a managed, monitored endpoint for scuffers.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when scuffers.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official scuffers.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Build a price-drop alert tool using
get_sale_itemsand thediscount_percentfield to track markdowns over time. - Aggregate new arrivals feeds by polling
get_new_arrivalsand detecting newly addedhandlevalues. - Populate a fashion search interface using
search_productswith optionalcategoryfiltering byproduct_type. - Enumerate the full product catalog by iterating all 239+ collection handles from
get_categoriesthroughget_category_products. - Display complete product pages with size selectors and image galleries using
get_productvariant andimagesdata. - Compare
pricevscompare_at_priceacross collections to identify partially discounted products outside the main sale collection. - Filter vendor-specific inventory by checking the
vendorfield returned across category and search endpoints.
| 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 | 100 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.
Does Scuffers have an official developer API?+
What does `get_product` return that the listing endpoints don't?+
get_product returns the full product description, a tags array, a complete images array with all product photo URLs, and separate sizes and colors arrays derived from variant options. Listing endpoints like get_category_products and search_products return only a single representative image URL and no variant breakdown.How many results does `search_products` return, and can I page through more?+
page parameter, but the underlying search suggest behavior limits results to 10 per request regardless of page. If you need broader coverage of a product type, use get_category_products with an appropriate collection handle from get_categories instead.Does the API expose customer reviews or ratings for products?+
Is stock or inventory quantity data available per variant?+
search_products endpoint returns an available boolean per product, but individual variant inventory quantities are not included in any endpoint's response. The get_product endpoint returns variant options (sizes, colors, SKUs) without per-variant stock counts. You can fork this API on Parse and revise it to surface per-variant availability if that data is present on product pages.