cos.com APIwww.cos.com ↗
Access COS fashion product data via 2 endpoints. Search by keyword, retrieve prices, images, stock info, material composition, and direct product URLs.
curl -X GET 'https://api.parse.bot/scraper/f6e2cf57-99cc-49ae-bfa3-7e7913a9fedb/search_products?page=1&query=jacket&page_size=5' \ -H 'X-API-Key: $PARSE_API_KEY'
Search COS products by keyword with pagination. Returns product listings with name, price, images, stock info, and product URL.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number (1-based) |
| queryrequired | string | Search keyword (e.g., 'jacket', 'dress', 'wool sweater') |
| page_size | integer | Number of results per page (max 40) |
{
"type": "object",
"fields": {
"page": "integer — current page number",
"query": "string — the search keyword used",
"products": "array of product objects with id, name, price, images, product_url, gender, and stock info",
"page_size": "integer — results per page",
"total_items": "integer — total number of matching products",
"total_pages": "integer — total number of pages"
},
"sample": {
"data": {
"page": 1,
"query": "jacket",
"products": [
{
"id": "1327473001",
"sku": "1327473",
"uri": "denim-shirt-jacket-indigo-1327473001",
"name": "DENIM SHIRT JACKET",
"price": "$199.00",
"gender": "Male",
"images": [
"https://media.cos.com/assets/001/4c/64/4c64c520e05d31f623d4b3db5af2c900fdc9e62c_xxl-1.jpg"
],
"is_new": false,
"color_hex": "#505661",
"is_on_sale": false,
"product_url": "https://www.cos.com/en-us/men/menswear/coatsjackets/denim/product/denim-shirt-jacket-indigo-1327473001",
"total_stock": 100,
"category_uri": "men/menswear/coatsjackets/denim",
"lowest_price": "$199.00",
"price_amount": 199,
"product_type": "Jacket",
"variant_name": "INDIGO",
"primary_image": "https://media.cos.com/assets/001/3b/12/3b12c0ef97b487fac8f1f9b26f0f8d2906246396_xxl-1.jpg",
"variants_count": 0,
"price_before_discount": "$199.00",
"price_before_discount_amount": 199
}
],
"page_size": 5,
"total_items": 64,
"total_pages": 13
},
"status": "success"
}
}About the cos.com API
The COS API provides 2 endpoints to search and retrieve product data from cos.com. Use search_products to query by keyword and get paginated listings with names, prices, images, gender targeting, and stock status, or call get_product_details with a product ID to pull full product records including material composition, launch date, and category tags.
Search and Browse Products
The search_products endpoint accepts a required query string (e.g., 'wool coat', 'linen trousers') and returns paginated results. Each page contains up to 40 product objects, configurable via the page_size parameter. Response fields per product include id, name, price, images (array of image URLs), product_url, gender, and stock availability. The total_items and total_pages fields let you walk full result sets across multiple pages using the page parameter.
Product Detail Lookup
The get_product_details endpoint takes a product_id string — obtainable directly from search_products results via results[*].id — and returns the complete product record. Additional fields beyond the search listing include categories (array of category identifier strings), launch_date, price_amount (numeric price value alongside the formatted price string), and sustainability_composition (an array of material composition objects, each with type and materials fields describing fabric breakdown).
Data Coverage
All fields reflect current product data from cos.com. Prices are returned both as a formatted string (price) and a raw numeric value (price_amount), which simplifies sorting or currency conversion in downstream code. The sustainability_composition field exposes material details useful for filtering by fabric type or building sustainability-focused product comparisons.
- Build a price tracker for COS products using
price_amountfrom repeatedget_product_detailscalls - Aggregate product images and URLs for a fashion lookbook or editorial tool using
search_products - Filter COS catalog by gender using the
genderfield returned in search results - Surface material composition data from
sustainability_compositionto help shoppers filter by fabric or sustainability criteria - Sync COS product listings into a comparison shopping app using
name,price, andproduct_url - Monitor new arrivals by tracking
launch_datefromget_product_detailsresponses - Categorize COS inventory by parsing the
categoriesarray from product detail records
| 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.
Does COS have an official public developer API?+
What stock information does `search_products` return?+
search_products response includes stock info alongside the product listing. It does not break down stock by size or color variant at the search level. Full variant-level availability is not currently exposed. You can fork the API on Parse and revise it to add a size/variant stock endpoint if that granularity is needed.Does the API return customer reviews or ratings for COS products?+
How do I paginate through all results for a search query?+
search_products response includes total_pages and total_items alongside the current page number. Increment the page parameter (1-based) on successive requests and set page_size up to 40 to walk through the full result set for any given query.What does the `sustainability_composition` field contain in product details?+
type field (describing the component or layer of the garment) and a materials field listing the fabric breakdown. This reflects the material composition data shown on COS product pages and can be used to filter products by fiber type or surface sustainability information to end users.