COS product
GET https://api.api.sh/cos/v1/product
One COS product in one market: name (and its English name), colour article and colour, price, original price and lowest 30-day price with the ISO currency (CHF, EUR, GBP, USD, ...), every size with its SKU and stock (in_stock, low_on_stock, out_of_stock), the other colours, description, fit, length, sleeve and neckline, composition and certified materials, supplier factories, size chart measurements, care instructions, categories, related products, images and the markets that sell it.
Every response includes credits_used: the credits this call cost.
Part of the COS API: 13 endpoints with prices, use cases and example responses.
Parameters
| name | type | description |
|---|---|---|
url | string | A cos.com product link (its locale sets the market and language), the product's uri (name-colour-<10-digit article>), or a 10-digit article number. Example: https://www.cos.com/de-ch/women/womenswear/knitwear/cardigans/cashmere/product/brushed-cashmere-crew-neck-cardigan-blue-1341040003 |
sku | string | 10-digit article number (one colour of a product), instead of url, e.g. 1341040003. |
market | string | Market: us (default), ca, gb, ie, de, at, ch, fr, es, it, nl, dk, no, se, pl, eu, eue, au, ww, or a site locale such as de-ch. Prices, currency and stock follow the market. country is accepted as the same thing. |
language | string | Language of names and texts, one the market offers (ch: de, en, fr; de: de, en; ca: en, fr; others their own). Default: the market's first language, or the link's. |
Every endpoint also takes fresh, raw, fields (see lean responses and caching).
Example
curl "https://api.api.sh/cos/v1/product?url=https%3A%2F%2Fwww.cos.com%2Fde-ch%2Fwomen%2Fwomenswear%2Fknitwear%2Fcardigans%2Fcashmere%2Fproduct%2Fbrushed-cashmere-crew-neck-cardigan-blue-1341040003" \
-H "x-api-key: $APISH_KEY" import os, requests
res = requests.get(
"https://api.api.sh/cos/v1/product",
params={"url": "https://www.cos.com/de-ch/women/womenswear/knitwear/cardigans/cashmere/product/brushed-cashmere-crew-neck-cardigan-blue-1341040003"},
headers={"x-api-key": os.environ["APISH_KEY"]},
timeout=120,
)
res.raise_for_status()
data = res.json() const url = new URL("https://api.api.sh/cos/v1/product");
url.searchParams.set("url", "https://www.cos.com/de-ch/women/womenswear/knitwear/cardigans/cashmere/product/brushed-cashmere-crew-neck-cardigan-blue-1341040003");
const res = await fetch(url, { headers: { "x-api-key": process.env.APISH_KEY } });
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
const data = await res.json(); Response
A JSON object with the fields described above, plus raw (the source's own data), cached, fetched_at and credits_used. Errors return {"success": false, "error": "…"} with the HTTP status (see errors). A lookup that ran but found nothing (404) costs the price above; refused calls and errors on our side are free (what's charged).
Example response (real call, trimmed: lists cut to 2 items, long text shortened, raw left out)
{"market": "ch","language": "de","id": 24982,"sku": "1341040003","uri": "brushed-cashmere-crew-neck-cardigan-blue-1341040003","name": "STRICKJACKE AUS REINEM GEBÜRSTETEM KASCHMIR","url": "https://www.cos.com/de-ch/women/womenswear/knitwear/cardigans/cashmere/product/brushed-cashmere-crew-neck-cardigan-blue-1341040003","color": "Blau","color_group": "Blau","color_hex": "#5B71A4","swatch_image": "https://media.cos.com/assets/001/14/76/1476c21aca9bb6cb2f478710af8306cfd698b3bd_xxl-1.jpg","price": {"value": 290,"currency": "CHF","label": "290.00 CHF"},"original_price": {"value": 290,"currency": "CHF","label": "290.00 CHF"},"discount_percent": null,"available": true,"on_sale": false,"is_new": false,"coming_soon": false,"launch_date": "2026-08-11T11:07:00.000Z","images": ["https://media.cos.com/assets/001/ed/3c/ed3c2ddb5d21089108e3003fc41542037c6d9cf3_xxl-1.jpg","https://media.cos.com/assets/001/b2/17/b21797f8ec7f21c3cabbad2e47ea4330b9ae9d72_xxl-1.jpg","… 7 more"],"style_sku": "1341040","brand": "COS","original_name": "BRUSHED PURE CASHMERE CREW-NECK CARDIGAN","lowest_price_30d": {"value": 290,"currency": "CHF","label": "290.00 CHF"},"comparative_price": null,"description": "Der klassische Cardigan mit Rundhalsausschnitt erhält für die kommende Saison eine strukturierte Note. Dieses Modell besteht aus hochwertige…","description_html": "<p><p>Der klassische Cardigan mit Rundhalsausschnitt erhält für die kommende Saison eine strukturierte Note. Dieses Modell besteht aus hochw…","product_type": "Cardigan","gender": "Weiblich","fit": "Regular Fit","length": "Normale Länge","sleeve_length": "Langarm","neckline": ["Rundausschnitt"],"collar": null,"style": null,"feature": null,"markers": [],"care_instructions": ["Nur chemische Reinigung","Bei Bedarf chlorfrei bleichen","… 3 more"],"warning": null,"composition": [{"type": "Äussere Schicht","materials": [{"material": "Kaschmir","percentage": 100,"description": "Kaschmir ist eine weiche Naturfaser, die von bestimmten Ziegenrassen gewonnen wird."}]}],"…": "14 more fields","cached": false,"credits_used": 1}The fastest way to see the full response is the playground: it runs this endpoint with your account and shows the exact JSON.