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'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace cos-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
from parse_apis.cos_product_search_api import COS, Product
cos = COS()
# Search for products by keyword
for product in cos.products.search(query="wool sweater", page_size=5, limit=5):
print(product.name, product.price, product.is_on_sale, product.gender)
# Get full product details by ID
detail = cos.products.get(id="1327473001")
print(detail.name, detail.price, detail.launch_date)
if detail.sustainability_composition:
for comp in detail.sustainability_composition:
print(comp.type)
for mat in comp.materials:
print(mat.material, mat.percentage)
Full-text search over COS product catalog by keyword. Returns paginated product listings including name, price, images, stock info, and product URL. Pagination is page-based (1-indexed). Each product carries enough metadata to filter client-side by gender, sale status, or newness.
| 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",
"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": "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 | 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 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.