COS APIcos.com ↗
Access COS fashion product data via 2 endpoints. Search by keyword, retrieve prices, images, stock info, material composition, and direct product URLs.
What is the COS 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.
curl -X GET 'https://api.parse.bot/scraper/f6e2cf57-99cc-49ae-bfa3-7e7913a9fedb/search_products?page=1&query=jacket&page_size=10' \ -H 'X-API-Key: $PARSE_API_KEY'
Full-text search over the COS US product catalog by keyword. Returns one page of product listings (name, price, sale/new flags, gender, images, stock, product URL) plus total_items and total_pages for the keyword. Pagination is page-based (1-indexed) and page_size (default 40, capped at 40) is a true offset window over the result stream; the site serves results in fixed blocks of 40, so a window that straddles two blocks costs two page loads, otherwise one. A keyword with no matches returns total_items 0 and an empty products array as a success. Each product carries enough metadata to filter client-side by gender, sale status, or newness; its id is the input to get_product_details.
| 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; larger values are clamped to 40) |
{
"type": "object",
"fields": {
"page": "integer - current page number",
"query": "string - the search keyword used",
"products": "array of Product objects (id, sku, name, price, price_amount, price_before_discount, lowest_price, is_on_sale, is_new, gender, variant_name, color_hex, product_type, primary_image, images, product_url, uri, category_uri, total_stock, variants_count)",
"page_size": "integer - results per page",
"total_items": "integer - total number of matching products",
"total_pages": "integer - total number of pages at the requested page_size"
},
"sample": {
"data": {
"page": 1,
"query": "jacket",
"products": [
{
"id": "1317969002",
"sku": "1317969",
"uri": "cotton-jersey-bomber-jacket-navy-1317969002",
"name": "COTTON-JERSEY BOMBER JACKET",
"price": "$111.20",
"gender": "Male",
"images": [
"https://media.cos.com/assets/001/40/7d/407db00cf21fbff0ff39f6eb91c5837d07c6b785_xxl-1.jpg"
],
"is_new": false,
"color_hex": "#2B2C32",
"is_on_sale": true,
"product_url": "https://www.cos.com/en-us/men/menswear/coatsjackets/jackets/product/cotton-jersey-bomber-jacket-navy-1317969002",
"total_stock": 9,
"category_uri": "men/menswear/coatsjackets/jackets",
"lowest_price": "$97.30",
"price_amount": 111.2,
"product_type": "Jacket",
"variant_name": "NAVY",
"primary_image": "https://media.cos.com/assets/001/00/ec/00ec538ef63eae510179435fe780c271380610f8_xxl-1.jpg",
"variants_count": 1,
"price_before_discount": "$139.00",
"price_before_discount_amount": 139
}
],
"page_size": 10,
"total_items": 112,
"total_pages": 12
},
"status": "success"
}
}About the COS API
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.
The COS API is a managed, monitored endpoint for cos.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when cos.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 cos.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 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 | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. 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.