quince.com APIwww.quince.com ↗
Search Quince's catalog, fetch product details (prices, colors, sizes, materials), and browse categories across women's, men's, and home with 3 endpoints.
curl -X GET 'https://api.parse.bot/scraper/4a6489f8-f5db-4a6f-bb84-bb3916ce2887/search_products?limit=3&query=dress&category=women%3Edresses' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for products by keyword with optional category and gender filters. Returns product listings with basic info, prices, and available filter options from Constructor.io search.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination |
| limit | integer | Number of results per page (max 100) |
| query | string | Search keyword |
| gender | string | Gender filter: 'Female', 'Male', or 'Unisex' |
| category | string | Category group_id to filter by (e.g., 'women>dresses', 'women>cashmere'). Use get_categories to discover available group IDs. |
{
"type": "object",
"fields": {
"page": "integer - current page number",
"limit": "integer - results per page",
"query": "string - the search keyword used",
"products": "array of product objects with id, name, url, slug, price, image_url, description, group_ids",
"total_results": "integer - total number of matching products",
"available_filters": "object mapping filter names to arrays of available values"
},
"sample": {
"data": {
"page": 1,
"limit": 3,
"query": "dress",
"products": [
{
"id": "cotton-poplin-tiered-maxi-dress_black",
"url": "https://quince.com/women/cotton-poplin-tiered-maxi-dress?color=black",
"name": "100% Organic Cotton Tiered Maxi Dress",
"slug": "women/cotton-poplin-tiered-maxi-dress",
"price": 69.9,
"group_ids": [
"women>dresses>maxi-dresses",
"women>best-sellers"
],
"image_url": "https://cdn.shopify.com/s/files/1/0056/4432/0879/products/W-DRS-19-BLK_2709_1080x1080_pad_ffffff.jpg.jpg?v=1655130059",
"description": "Maxi length and maximal function..."
}
],
"total_results": 242,
"available_filters": {
"color": [
"Black",
"Navy",
"Red"
],
"gender": [
"Female",
"Male"
]
}
},
"status": "success"
}
}About the quince.com API
The Quince API provides 3 endpoints to search, browse, and retrieve detailed product data from quince.com. Use search_products to query the catalog by keyword, category, or gender filter. Use get_product_details to pull per-product fields including price, available sizes, hex-coded color variants, material details, and images. Use get_categories to navigate the full hierarchical category tree.
What the API Covers
The Quince API gives programmatic access to the quince.com product catalog across women's, men's, and home categories. The three endpoints cover catalog search, individual product lookup, and category tree navigation. All endpoints return structured JSON with no authentication required on your end beyond your Parse key.
Search and Filtering
search_products accepts a query string plus optional gender ('Female', 'Male', or 'Unisex') and category filters. The category param takes a group_id string in the form women>dresses or women>cashmere — use get_categories first to enumerate valid values. Results include an available_filters object that maps filter names to their possible values for the current result set, making it straightforward to build faceted search interfaces. Pagination is controlled by page and limit (up to 100 per page), and total_results tells you how many records match.
Product Detail Fields
get_product_details accepts a product_id, slug, or full url — at least one is required. The response includes title, price, sizes (array of size strings), colors (array of objects with name and hex_code), details (materials and fabric description), and an images object that groups photos by color variant. The gender field on the product response reflects the target demographic as stored in the catalog.
Category Tree Navigation
get_categories takes an optional group_id parameter. Pass 'all' for top-level nodes, 'women' or 'm' for gender-specific subcategory trees. Each category object in the response includes group_id, name, product_count, and a children array for nested subcategories. This hierarchy is what you'd pass back into search_products as the category filter.
- Build a price-tracking tool that monitors Quince product prices by product_id over time.
- Generate a size and color availability matrix for a specific product using the sizes and colors fields from get_product_details.
- Construct a faceted search UI using the available_filters object returned by search_products.
- Enumerate the full Quince category hierarchy with get_categories to map product taxonomy for a comparison shopping tool.
- Filter men's or women's products by category and keyword to populate a curated gift guide.
- Extract material and fabric details from the details field to tag and classify products by composition (e.g., cashmere, linen, cotton).
- Aggregate product counts per category using get_categories product_count fields to analyze catalog depth.
| 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.