# Uniqlo Product Scraper US (`mrdoe/uniqlo-product-scraper-us`) Actor
Extracts fashion product listings from Uniqlo.com (US) - price, ratings, colors, sizes, and photos - for any category page URL, in one fast request.
- **URL**: https://apify.com/mrdoe/uniqlo-product-scraper-us.md
- **Developed by:** [MrDoe](https://apify.com/mrdoe) (community)
- **Categories:**
- **Stats:** 2 total users, 1 monthly users, 0.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet
## Pricing
from $1.50 / 1,000 results
This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.
Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event
## What's an Apify Actor?
Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".
## How to integrate an Actor?
If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.
- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).
For usage examples, see the [API](#api) section below.
For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).
# README
**Turn Uniqlo's product catalog into structured data in minutes** - no coding, no manual copy-pasting. Get product name, price, customer ratings, colors, sizes, and photos for any Uniqlo.com (US) category, in one fast request.
### What does Uniqlo Product Scraper US do?
Uniqlo Product Scraper US collects fashion product listings from [Uniqlo.com](https://www.uniqlo.com) (US). Point it at any category or subcategory page URL and it fetches every product in that category, along with pricing, star ratings, available colors and sizes, and photos.
### Why use Uniqlo Product Scraper US?
- **Price monitoring** - track how Uniqlo prices specific categories or products over time, including promotional pricing.
- **Customer sentiment at a glance** - Uniqlo shows a star rating and review count for most products directly on category pages, included here without needing a separate request per product.
- **Trend and assortment research** - see exactly what's in a category, which colors and sizes are offered, and which items are flagged as best sellers.
- **Data enrichment** - pull structured product data into your own spreadsheet, PIM, or price-comparison tool.
### How to use Uniqlo Product Scraper US
1. Go to the **Input** tab.
2. Set **Category URL** to any Uniqlo.com (US) category page (copy it straight from your browser), e.g. `https://www.uniqlo.com/us/en/women/tops` or a narrower subcategory like `https://www.uniqlo.com/us/en/women/tops/t-shirts`.
3. Set **Max items** to control how much to collect.
4. Click **Start** and wait for the run to finish.
5. Open the **Dataset** tab to preview, filter, and export your results.
### Input
| Field | Type | Description |
| --- | --- | --- |
| `startUrl` | String | A Uniqlo.com (US) category or subcategory page URL. |
| `maxItems` | Integer | Maximum number of products to scrape (default: 100). |
Example input:
```json
{
"startUrl": "https://www.uniqlo.com/us/en/women/tops",
"maxItems": 100
}
```
### Output
Each product is saved as one item in the dataset, for example:
```json
{
"productId": "E424873-000",
"name": "Crew Neck T-Shirt",
"url": "https://www.uniqlo.com/us/en/products/E424873-000/00?colorDisplayCode=00",
"brand": "Uniqlo",
"gender": "WOMEN",
"price": 19.9,
"currency": "USD",
"promoPrice": null,
"isDualPrice": false,
"rating": 4.7,
"ratingCount": 2796,
"isBestSeller": true,
"storeStockOnly": false,
"promotionText": "",
"representativeColor": "WHITE",
"colors": [
{ "name": "WHITE", "image": "https://image.uniqlo.com/UQ/ST3/us/imagesgoods/424873/item/usgoods_10_424873_3x4.jpg" }
],
"sizes": ["XXS", "XS", "S", "M", "L", "XL", "XXL"],
"image": "https://image.uniqlo.com/UQ/ST3/us/imagesgoods/424873/item/usgoods_10_424873_3x4.jpg",
"galleryImages": ["https://image.uniqlo.com/UQ/ST3/us/imagesgoods/424873/sub/usgoods_424873_sub3_3x4.jpg"],
"category": "T-Shirts & Sweats",
"scrapedAt": "2026-08-14T00:00:00.000Z"
}
```
#### Data table
| Field | Description |
| --- | --- |
| `productId` | Uniqlo's internal product code |
| `url` | The product's own page on Uniqlo.com |
| `name`, `brand`, `gender` | Product identification |
| `price`, `currency`, `promoPrice`, `isDualPrice` | Current pricing, and any active promotional price |
| `rating`, `ratingCount` | Average star rating (out of 5) and number of customer reviews, shown directly on the category page |
| `isBestSeller` | Whether Uniqlo flags this item as a best seller |
| `storeStockOnly` | Whether this item is only available in physical stores |
| `promotionText` | Any promotional label shown on the listing |
| `representativeColor`, `colors` | The default color shown, and every color option with its own photo |
| `sizes` | Every size this product is offered in |
| `image`, `galleryImages` | Primary photo and the product's photo gallery |
| `category` | The resolved category or subcategory name |
| `scrapedAt` | ISO timestamp when the item was scraped |
Uniqlo doesn't expose customer *review text* on category listing pages - only the aggregate rating and count. Full review text is on individual product pages, which would require a separate request per product; this Actor is built for fast, whole-category scraping, so it isn't included.
### Pricing / Cost estimation
How much does it cost to scrape Uniqlo products? Uniqlo's product data comes from its own internal JSON API, which is fetched directly with plain HTTP requests (no browser rendering needed), so this Actor is fast and cheap to run - pricing depends mainly on your Apify plan's compute unit rate and how many products you request.
### Tips for better runs
- Copy category or subcategory URLs directly from your browser's address bar for the most reliable results - the Actor resolves the category from the URL's own path segments.
- A category page like `/us/en/women/tops` returns everything in that department; a subcategory page like `/us/en/women/tops/t-shirts` narrows it further.
- Use the Apify **Schedule** feature to re-run this Actor periodically and track price, rating, or assortment changes over time.
### FAQ
**Is this legal?** This Actor only collects publicly visible product data. You are responsible for using the data in accordance with Uniqlo's Terms of Service and any applicable laws in your jurisdiction.
**Why did some fields come back empty?** Not every product has every field (e.g. not every item has an active promotion or a rating yet). The Actor returns `null` for anything that isn't available for a given product.
**What if my category URL doesn't resolve?** Make sure it's a real Uniqlo.com (US) category page copied from the site (e.g. `/us/en/{gender}/{class}` or deeper). If the exact subcategory can't be matched, the Actor falls back to the closest resolvable parent category.
**Found a bug or have a feature request?** Please use the Issues tab on this Actor's page - feedback directly shapes future updates.
# Actor input Schema
## `startUrl` (type: `string`):
A Uniqlo.com (US) category page URL, e.g. https://www.uniqlo.com/us/en/women/tops. Copy any category or subcategory URL from the site's navigation menu.
## `maxItems` (type: `integer`):
Maximum number of products to scrape from the matched category.
## Actor input object example
```json
{
"startUrl": "https://www.uniqlo.com/us/en/women/tops",
"maxItems": 100
}
```
# Actor output Schema
## `listings` (type: `string`):
No description
# API
You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.
## JavaScript example
```javascript
import { ApifyClient } from 'apify-client';
// Initialize the ApifyClient with your Apify API token
// Replace the '' with your token
const client = new ApifyClient({
token: '',
});
// Prepare Actor input
const input = {
"startUrl": "https://www.uniqlo.com/us/en/women/tops"
};
// Run the Actor and wait for it to finish
const run = await client.actor("mrdoe/uniqlo-product-scraper-us").call(input);
// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
console.dir(item);
});
// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs
```
## Python example
```python
from apify_client import ApifyClient
# Initialize the ApifyClient with your Apify API token
# Replace '' with your token.
client = ApifyClient("")
# Prepare the Actor input
run_input = { "startUrl": "https://www.uniqlo.com/us/en/women/tops" }
# Run the Actor and wait for it to finish
run = client.actor("mrdoe/uniqlo-product-scraper-us").call(run_input=run_input)
# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
print(item)
# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start
```
## CLI example
```bash
echo '{
"startUrl": "https://www.uniqlo.com/us/en/women/tops"
}' |
apify call mrdoe/uniqlo-product-scraper-us --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"type": "http",
"url": "https://mcp.apify.com/?tools=fetch-actor-details,mrdoe/uniqlo-product-scraper-us"
}
}
}
```
The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer ` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).
## OpenAPI specification
Download the OpenAPI definition: https://api.apify.com/v2/actors/lS5OyWoxJ66vwaMz9/builds/9JOkSXNwkgSD9OuGF/openapi.json