COS API

Search the COS store and pull products, market prices, stock per size and store availability as clean JSON.

The API.SH COS API turns the public cos.com store into structured JSON in every COS market, from the US and UK to Switzerland, Germany and Austria. Search products or read a whole category with the site's own sort and filters (colour, size, material, fit, product type, gender, price range), then read one product with its price and ISO currency, every size with its stock level, the other colours, materials and certificates, supplier factories and size chart measurements. Stock per size, stock in COS stores, search suggestions, recommendations and the store locator are separate calls.

Get a free API key Try it in the playground

13 endpoints
from $1 / 1,000 calls
1,000 free credits / month
failed calls free

COS product search

GET https://api.api.sh/cos/v1/search

{"query": "cashmere cardigan","market": "us","language": "en","total": 23,"count": 23,"page": 1,"page_size": 24,"offset": 0,"next_page": null,"next_offset": null,"redirect": null,"products": [{"id": 25663,"sku": "1357457002","style_sku": "1357457","uri": "brushed-cashmere-v-neck-cardigan-wine-red-1357457002","name": "BRUSHED PURE CASHMERE V-NECK CARDIGAN","url": "https://www.cos.com/en-us/men/menswear/knitwear/cardigans/product/brushed-cashmere-v-neck-cardigan-wine-red-1357457002","price": {"value": 329,"currency": "USD","label": "$329.00"},"price_before_discount": {"value": 329,"currency": "USD","label": "$329.00"},"lowest_price_30d": {"value": 329,"currency": "USD","label": "$329.00"},"discount_percent": null,"on_sale": false,"is_new": true,"coming_soon": false,"in_stock": true,"color": "WINE RED","color_hex": "#503B40","colors": [{"name": "WINE RED","hex": "#503B40","available": true,"id": 25663,"image": "https://media.cos.com/assets/001/1e/1f/1e1ff1c3e7da418c9355c9c99366242ba76ad266_xxl-1.jpg"},{"name": "MOCHA","hex": "#7B7164","available": true,"id": 25664,"image": "https://media.cos.com/assets/001/5b/cd/5bcd5a721746ca1df77ceb63d0b24c7bff0137cc_xxl-1.jpg"}],"variants_count": 1,"product_type": "Cardigan","gender": "Male","main_category": "men/menswear/knitwear/cardigans","tags": ["cashmere","cardigans","… 7 more"],"launch_date": "2026-10-06T01:53:00.000Z","image": "https://media.cos.com/assets/001/a5/ab/a5ab9cda7d0173954198df436886949833f763f5_xxl-1.jpg","images": ["https://media.cos.com/assets/001/8e/af/8eafd86099efdd9eea17fceba443a545738b2b56_xxl-1.jpg","https://media.cos.com/assets/001/4c/e0/4ce04a5a5e69971880550f6552912b82039544d5_xxl-1.jpg","… 6 more"],"position": 1},{"id": 25664,"sku": "1357457001","style_sku": "1357457","uri": "brushed-cashmere-v-neck-cardigan-mocha-1357457001","name": "BRUSHED PURE CASHMERE V-NECK CARDIGAN","url": "https://www.cos.com/en-us/men/menswear/knitwear/cardigans/product/brushed-cashmere-v-neck-cardigan-mocha-1357457001","price": {"value": 329,"currency": "USD","label": "$329.00"},"price_before_discount": {"value": 329,"currency": "USD","label": "$329.00"},"lowest_price_30d": {"value": 329,"currency": "USD","label": "$329.00"},"discount_percent": null,"on_sale": false,"is_new": false,"coming_soon": false,"in_stock": true,"color": "MOCHA","color_hex": "#7B7164","colors": [{"name": "MOCHA","hex": "#7B7164","available": true,"id": 25664,"image": "https://media.cos.com/assets/001/5b/cd/5bcd5a721746ca1df77ceb63d0b24c7bff0137cc_xxl-1.jpg"},{"name": "WINE RED","hex": "#503B40","available": true,"id": 25663,"image": "https://media.cos.com/assets/001/1e/1f/1e1ff1c3e7da418c9355c9c99366242ba76ad266_xxl-1.jpg"}],"variants_count": 1,"product_type": "Cardigan","gender": "Male","main_category": "men/menswear/knitwear/cardigans","tags": ["cashmere","cardigans","… 9 more"],"launch_date": "2026-09-24T10:39:00.000Z","image": "https://media.cos.com/assets/001/f9/26/f9260fb667f15a0bcc4fb81c714067ca2116c474_xxl-1.jpg","images": ["https://media.cos.com/assets/001/39/71/3971b275b3eac63370f6696386b2e53380d1a21b_xxl-1.jpg","https://media.cos.com/assets/001/d3/91/d39126df92f5d0b6cf36e75501ef127c357226c6_xxl-1.jpg","… 6 more"],"position": 2},"… 21 more"],"facets": [{"param": "product_type","attribute": "product_types","title": "Product Type","type": "set","values": [{"value": "cardigan","label": "Cardigan","count": 21},{"value": "jumper","label": "Jumper","count": 1},"… 1 more"]},{"param": "feature","attribute": "product_features","title": "Product Feature","type": "set","values": [{"value": "high_collar","label": "High Collar","count": 2},{"value": "long_sleeve","label": "Long sleeve","count": 22},"… 6 more"]},"… 6 more"],"cached": false,"credits_used": 1}

1 credit · $1 per 1,000 calls

What you can build with the COS API

Price and markdown monitoring across markets

Read the same product in several markets to compare the price, the price before discount and the lowest price of the last 30 days, each with its currency code.

/product /category

Restock alerts by size

Poll the light stock call for the sizes you watch and alert when one moves from out of stock to in stock or low on stock.

/stock /availability

Assortment and trend research

Page through a category or a search with filters and sort by newest to track new arrivals, colours, materials and price points over time.

/category /search /suggest

Product feeds for resale and styling apps

Build a feed with names, colour articles, images, sizes, materials, care instructions and related products for each item you list.

/product /recommendations

In-store availability and store data

Find which COS stores in a country carry a size, with addresses, coordinates and opening hours, and list every store by country or city.

/store-availability /stores /store-cities /store-countries

Supply chain and material transparency

Collect the composition, certified materials and supplier factory details COS publishes for each product.

/product

COS data you get

Field names from real responses. Numbers come parsed, URLs absolute, dates in ISO 8601.

COS stock per size (same as stock)/cos/v1/availability

marketchsku1341040003uribrushed-cashmere-crew-neck-cardi…in_stocktrue

sizes[]id · name · sku · stock_quantity · stock_level · stock · in_stock

COS category listing/cos/v1/category

categorywomen/womenswear/knitwearmarketuslanguageentotal250count24page1page_size24offset0next_page2next_offset24

products[]id · sku · style_sku · uri · name · url · price · price_before_discount · lowest_price_30d · discount_percent · on_sale · is_new

facets[]param · attribute · title · type · values

COS product/cos/v1/product

marketchlanguagedeid24982sku1341040003uribrushed-cashmere-crew-neck-cardi…nameSTRICKJACKE AUS REINEM GEBÜRSTET…urlhttps://www.cos.com/de-ch/women/…colorBlaucolor_groupBlaucolor_hex#5B71A4swatch_imagehttps://media.cos.com/assets/001…availabletrueon_salefalseis_newfalsecoming_soonfalselaunch_date2026-08-11T11:07:00.000Zstyle_sku1341040brandCOS

price[]value · currency · label

original_price[]value · currency · label

lowest_price_30d[]value · currency · label

composition[]type · materials

COS API endpoints and prices

Every COS endpoint costs 1 credit per call: credits are $1 per 1,000 on a monthly plan, $2 pay-as-you-go. Pricing

Search and discovery2

COS product search /cos/v1/search params q +16 optionaldocs try	$1 · $2 PAYG 1 credit
COS search suggestions /cos/v1/suggest params q +2 optionaldocs try	$1 · $2 PAYG 1 credit

Comments and reviews1

COS product reviews

/cos/v1/reviews

params none required +7 optionaldocstry

$1 · $2 PAYG

1 credit

Products, listings and places6

COS stock per size (same as stock) /cos/v1/availability params none required +3 optionaldocs try	$1 · $2 PAYG 1 credit
COS category listing /cos/v1/category params category +16 optionaldocs try	$1 · $2 PAYG 1 credit
COS product /cos/v1/product params none required +4 optionaldocs try	$1 · $2 PAYG 1 credit
COS recommendations for a product /cos/v1/recommendations params none required +4 optionaldocs try	$1 · $2 PAYG 1 credit
COS stock per size /cos/v1/stock params none required +3 optionaldocs try	$1 · $2 PAYG 1 credit
COS stock in stores /cos/v1/store-availability params none required +5 optionaldocs try	$1 · $2 PAYG 1 credit

More data4

COS category menu /cos/v1/categories params none required +2 optionaldocs try	$1 · $2 PAYG 1 credit
COS store cities /cos/v1/store-cities params country +1 optionaldocs try	$1 · $2 PAYG 1 credit
COS store countries /cos/v1/store-countries params none required +1 optionaldocs try	$1 · $2 PAYG 1 credit
COS stores /cos/v1/stores params none required +5 optionaldocs try	$1 · $2 PAYG 1 credit

Call the COS API

COS product search: GET https://api.api.sh/cos/v1/search

curl "https://api.api.sh/cos/v1/search?q=cashmere+cardigan" \
  -H "x-api-key: $APISH_KEY"

import os, requests

res = requests.get(
    "https://api.api.sh/cos/v1/search",
    params={"q": "cashmere cardigan"},
    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/search");
url.searchParams.set("q", "cashmere cardigan");

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();

# Google Sheets (API.SH add-on)
=APISH("/cos/v1/search", "q", "cashmere cardigan")

# Zapier, Make, n8n (verified node): pick the API.SH app,
# choose "COS" and "COS product search".

# AI agents (Claude, ChatGPT, Cursor): add the
# API.SH MCP server https://api.sh/mcp

Create a free accountConfirm your email and get 1,000 free credits every month. No card needed.
Create an API keyOne key works for all 902 platforms.
Send the requestJSON back in one call. Add output=csv or output=ndjson for files.

Why API.SH for COS data

Public data only: no COS login, cookies or account needed
One key and one response shape for COS and 901 other platforms
Built and maintained by API.SH, not third-party publishers
Pay per call; errors on our side cost nothing
No rate limits: run as many calls in parallel as you need
Live status for every endpoint

API.SH vs the official COS API

COS, part of the H&M Group, does not offer a public API for its store; searches for a COS API mostly show unrelated products that share the name. API.SH reads the public cos.com store and returns it as JSON with one key.

Skip building and maintaining your own COS scraper or buying static datasets: API.SH returns live data per call with one key, in the same JSON shape as the other fashion stores it covers.

COS API questions

What COS data can I get?+

Product search (/cos/v1/search) and category listings (/cos/v1/category) with filters and facets, one product with sizes, stock, colours, materials, suppliers and size chart (/cos/v1/product), stock per size (/cos/v1/stock, also /cos/v1/availability), stock in stores (/cos/v1/store-availability), search suggestions (/cos/v1/suggest), recommendations (/cos/v1/recommendations) and the store locator (/cos/v1/stores, /cos/v1/store-cities, /cos/v1/store-countries).

How much does the COS API cost?+

Every COS endpoint costs 1 credit per call. On a monthly plan 1,000 credits cost $1 (Starter is $50/month for 50,000 credits). Pay-as-you-go is $2 per 1,000 credits, with top-ups from $15 that never expire.

Is there a free trial?+

Yes. Every account gets 1,000 free credits every month. That is 1,000 calls to /cos/v1/availability at 1 credit each.

Is there an official COS API?+

No public one. COS does not publish an API for product or stock data. API.SH reads the public store pages' data and returns it as JSON.

Do I need a COS account or login?+

No. API.SH reads public cos.com data only. No endpoint uses a login, cookies or anyone's account.

Which COS markets and currencies are supported?+

Every COS online market: the US, Canada, the UK, Ireland, Germany, Austria, Switzerland, France, Spain, Italy, the Netherlands, Denmark, Norway, Sweden, Poland, Australia, the EU and worldwide sites. Pass market (or a cos.com link, whose locale sets it) and prices come back in that market's currency with its ISO code, in the market's language or another it offers.

How often does COS restock, and can I track it?+

COS does not publish a restock schedule. Call /cos/v1/stock for the products you watch: it returns every size's stock level (in stock, low on stock, out of stock), so you can see when a size comes back.

Can I look up a product by its COS product number?+

Yes. Pass the 10-digit article number as sku (or a cos.com product link, or the product's uri) to /cos/v1/product, /cos/v1/stock, /cos/v1/store-availability or /cos/v1/recommendations.

How do I get started?+

1. Sign up at api.sh. 2. Copy your API key. 3. Call /cos/v1/product with the url of a COS product page. Request examples and every parameter are in the docs at https://api.sh/docs. You can also use the JS or Python SDK, Google Sheets, Zapier, Make, n8n or the MCP server at https://api.sh/mcp.

Does the COS API have a rate limit?+

No. API.SH puts no rate limit on your key: send as many COS calls in parallel as you need and pay only for the calls that run. If COS itself slows down, the call returns 503 with a retry-after header and is not charged.