Uniqlo API · Endpoint

Uniqlo Category Products API

Q: What do I send?

Send path. The input fields below list every option with its type and limits.

Q: Can my AI agent call it?

Yes, over MCP: the agent finds uniqlo.category.products.list, checks its price and runs it with the same credits as the REST API.

List a Uniqlo France category, such as women's tops, page by page: each product's name, price, markdown price, rating, stock, colours and sizes.

1 credit per call
Failed calls are free
Updated 18 Oct 2026
uniqlo.category.products.list

Start free, 100 credits API reference

Response completed

{  "pagination": {    "limit": 36,    "offset": 0,    "total": 188  },  "items": [    {      "name": "Pull en laine mérinos mélangé (Col tunisien)",      "currency": "EUR",      "in_stock": true,      "model_id": "488210",      "price_base": 39.9,      "price_promo": null,      "product_id": "E488210-000",      "rating_average": 4.6,      "rating_count": 18,      "url": "https://www.uniqlo.com/fr/fr/products/E488210-000/00",      "colors": [        {          "name": "NUDE",          "available": true,          "code": "COL30",          "display_code": "30"        },        {          "name": "ROUGE",          "available": true,          "code": "COL16",          "display_code": "16"        }      ],      "sizes": [        {          "name": "XXS",          "available": true,          "code": "SMA001",          "display_code": "001"        },        {          "name": "XS",          "available": true,          "code": "SMA002",          "display_code": "002"        }      ]    },    {      "name": "Pull en laine mérinos mélangé (Col tunisien)",      "currency": "EUR",      "in_stock": true,      "model_id": "491086",      "price_base": 39.9,      "price_promo": null,      "product_id": "E491086-000",      "rating_average": 5,      "rating_count": 5,      "url": "https://www.uniqlo.com/fr/fr/products/E491086-000/00",      "colors": [        {          "name": "BLEU MARINE",          "available": true,          "code": "COL69",          "display_code": "69"        },        {          "name": "GRIS FONCÉ",          "available": true,          "code": "COL08",          "display_code": "08"        }      ],      "sizes": [        {          "name": "XXS",          "available": true,          "code": "SMA001",          "display_code": "001"        },        {          "name": "XS",          "available": true,          "code": "SMA002",          "display_code": "002"        }      ]    }  ]}

36 rows

#	Name	Price	Currency	In stock	Rating	Ratings	Product ID	Model id	Url
1	Pull en laine mérinos mélangé (Col tunisien)	39.9	EUR	true	4.6	18	E488210-000	488210	https://www.uniqlo.com/fr/fr/products/E488210-000/00
2	Pull en laine mérinos mélangé (Col tunisien)	39.9	EUR	true	5	5	E491086-000	491086	https://www.uniqlo.com/fr/fr/products/E491086-000/00
3	Mini T-shirt (Manches longues)	19.9	EUR	true	4.8	88	E487579-000	487579	https://www.uniqlo.com/fr/fr/products/E487579-000/00
4	T-shirt 100% coton SUPIMA® (Manches longues)	19.9	EUR	true	4.7	84	E488230-000	488230	https://www.uniqlo.com/fr/fr/products/E488230-000/00
5	Mini T-shirt (Manches longues raglan)	19.9	EUR	true	4.7	45	E489372-000	489372	https://www.uniqlo.com/fr/fr/products/E489372-000/00
6	T-shirt à col tunisien (Manches longues)	19.9	EUR	true	4.7	272	E487908-000	487908	https://www.uniqlo.com/fr/fr/products/E487908-000/00
7	T-shirt à capuche (Manches longues)	19.9	EUR	true	4.9	106	E488298-000	488298	https://www.uniqlo.com/fr/fr/products/E488298-000/00
8	T-shirt à col roulé (Manches longues)	29.9	EUR	true	5	5	E488228-000	488228	https://www.uniqlo.com/fr/fr/products/E488228-000/00
9	T-shirt en polaire douce (Manches longues)	19.9	EUR	true	4.8	1068	E470143-000	470143	https://www.uniqlo.com/fr/fr/products/E470143-000/00
10	T-shirt côtelé en polaire (Col V)	19.9	EUR	true	4.7	35	E487595-000	487595	https://www.uniqlo.com/fr/fr/products/E487595-000/00

Try it live, free

Input

What you send

The input object of the request, with every field the endpoint accepts.

Field	Type	Required	What it does	Example
path	string	yes	A category path from the categories endpoint, such as 37608,84986 for women's tops.	37608,84986
include_unavailable	boolean	no	Keep products that are out of stock.
limit	integer	no	How many products per page, up to 96.
offset	integer	no	How many products to skip, to get the next page.
sort	integer	no	Uniqlo's sort order, from 0 (its default ranking) to 6.

Response

Fields it returns

What each record in the response holds, with the values from the sample above.

Field	Type	What it is	Example
items[].name	string	The name as Uniqlo shows it.	Pull en laine mérinos mélangé (Col tunisien)
items[].price_base	number	The regular price, in the currency given.	39.9
items[].price_promo	null	The offer price, when there is one.	null
items[].currency	string	The currency code of the prices.	EUR
items[].in_stock	boolean	Whether the product can be bought now.	true
items[].rating_average	number	The average star rating.	4.6
items[].rating_count	integer	How many ratings the product has.	18
items[].product_id	string	Uniqlo's ID for the product; the product endpoint takes it.	E488210-000
items[].colors[].name	string	The colour's name.	NUDE
items[].sizes[].name	string	The size, such as XS.	XXS
items[].colors	array	The colours the product comes in.	3 records
items[].colors[].available	boolean	Stock for this colour; empty here, the product endpoint has it.	true
items[].colors[].code	string	Uniqlo's code for the colour.	COL30
items[].colors[].display_code	string	The colour number as Uniqlo shows it.	30
items[].model_id	string	Uniqlo's ID for the product model.	488210
items[].sizes	array	The sizes the product comes in.	7 records
items[].sizes[].available	boolean	Stock for this size; empty here, the product endpoint has it.	true
items[].sizes[].code	string	Uniqlo's code for the size.	SMA001
items[].sizes[].display_code	string	The size number as Uniqlo shows it.	001
items[].url	string	The product's page on Uniqlo.	https://www.uniqlo.com/fr/fr/products/E488210-000/00
items	array	The products.	36 records
pagination	object	Paging for this response.	3 fields
pagination.limit	integer	How many products one page holds.	36
pagination.offset	integer	Where this page starts; add the limit to get the next page.	0
pagination.total	integer	How many products match.	188

REST API · MCP server

Call it from your code, or ask your agent

Set UPSCRAPE_API_KEY to your key and copy a working request.

curl --request POST \  --url https://data.upscrape.com/execute \  --header "Authorization: Bearer $UPSCRAPE_API_KEY" \  --header "Content-Type: application/json" \  --header "Prefer: wait=30" \  --data '{  "capability": "uniqlo.category.products.list",  "input": {    "path": "37608,84986"  }}'

import jsonimport osimport requestspayload = json.loads(r'''{  "capability": "uniqlo.category.products.list",  "input": {    "path": "37608,84986"  }}''')response = requests.post(    "https://data.upscrape.com/execute",    headers={        "Authorization": f"Bearer {os.environ['UPSCRAPE_API_KEY']}",        "Content-Type": "application/json",        "Prefer": "wait=30",    },    json=payload,)response.raise_for_status()print(json.dumps(response.json(), indent=2))

const response = await fetch("https://data.upscrape.com/execute", {  method: "POST",  headers: {    "Authorization": `Bearer ${process.env.UPSCRAPE_API_KEY}`,    "Content-Type": "application/json",    "Prefer": "wait=30",  },  body: JSON.stringify({  "capability": "uniqlo.category.products.list",  "input": {    "path": "37608,84986"  }}),});if (!response.ok) {  throw new Error(`Upscrape request failed: ${response.status}`);}console.log(JSON.stringify(await response.json(), null, 2));

In your AI agent Claude · Cursor · any MCP client

1Add the Upscrape MCP server

https://data.upscrape.com/mcp

2Ask for the data in plain words

Using Upscrape, list Uniqlo France's women's tops (category path 37608,84986) and make a table of name, price, markdown price and rating. Which ones are marked down?

The agent finds the endpoint, shows you the price, and runs it with your credits.

Uniqlo