~/ecommerce/macys-scraper

Macy's Scraper — Produk, Harga, SKU & Berita

Ekstrak data produk Macy's — harga, varian, barcode SKU/UPC, gambar, rating & ulasan — plus berita Macy's Inc., dari URL search, kategori, trending, dan produk. Tanpa browser, tahan Akamai.

department store TypeScriptCrawleeCheerio Amerika Serikat

run di Apify

proooxy/macys-scraper — spec

kategoriecommerce / department store

bahasaTypeScript

stackTypeScript, Crawlee, Cheerio

pasarAmerika Serikat

outputJSON bersih, siap-RAG

fitur utama

Empat surface dalam satu actor — product search, category, trending, dan berita Macy's Inc.

Mengalahkan Akamai Bot Manager tanpa browser dengan memakai JSON API mobile & website milik Macy's sendiri

Barcode UPC per-SKU lengkap dengan warna, ukuran, ketersediaan, dan harga untuk setiap varian yang bisa dibeli

Harga sebagai integer cents plus string berformat lokal — tanpa pembulatan floating-point

Review intelligence lengkap — histogram bintang, recommend count, dan rating fit/size sekunder

Semua shade dan ukuran dikelompokkan di bawah satu product record, bukan satu baris per varian

Hanya canonical URL yang bersih — endpoint API internal dan client key tidak pernah bocor ke output

Satu skema yang dinormalisasi untuk hasil search, category, trending, dan product-detail

use case

Monitoring harga dan promosi department store di level SKU
Analisis kompetitif — harga Macy's vs Nordstrom, Ulta, atau brand DTC
Pencocokan katalog lintas peritel via barcode UPC per-varian
Review dan rating intelligence untuk brand yang dijual di Macy's
Monitoring berita retail — press release dan pengumuman earnings Macy's Inc.

parameter input

Parameter	Tipe	Wajib	Deskripsi
`scrapeType`	string	wajib	Surface yang mau di-scrape: search, category, trending, news, atau all (default: search).
`query`	string	opsional	Keyword untuk product search, contoh: women shoes.
`startUrls`	array	opsional	URL produk/kategori Macy's atau URL berita Macy's Inc.
`categoryIds`	array	opsional	Category ID Macy's (contoh: 5449). URL kategori lebih disarankan jika sudah diketahui.
`trendingUrls`	array	opsional	URL listing trending, bestseller, atau curated.
`newsUrls`	array	opsional	URL listing berita atau artikel Macy's Inc.
`includeProductDetails`	boolean	opsional	Perkaya item listing dengan detail produk lengkap — varian, SKU, galeri (default: true).
`maxPages`	number	opsional	Kedalaman paginasi maksimum per sumber listing/news.
`maxResults`	number	opsional	Batas jumlah record output. 0 = tanpa batas.
`proxy`	object	wajib	Apify Proxy atau URL proxy custom. Residential, country US disarankan.

Contoh Output

 1{
 2  "type": "product",
 3  "source": {
 4    "id": "12345678",
 5    "canonicalUrl": "https://www.macys.com/shop/product/calvin-klein-womens-sheath-dress?ID=12345678",
 6    "retailer": "macys",
 7    "currency": "USD"
 8  },
 9  "title": "Women's Sleeveless Sheath Dress",
10  "brand": "Calvin Klein",
11  "categories": ["Women", "Dresses", "Work Dresses"],
12  "price": {
13    "sale": 5999,
14    "list": 9800,
15    "currentFormatted": "$59.99",
16    "stockStatus": "InStock"
17  },
18  "stats": { "rating": 4.6, "reviewCount": 9, "ratingPercentage": 92 },
19  "options": [
20    { "type": "Color", "values": [{ "id": "1", "name": "Black" }] },
21    { "type": "Size", "values": [{ "id": "10", "name": "M" }, { "id": "12", "name": "L" }] }
22  ],
23  "variants": [
24    {
25      "id": "987654",
26      "sku": "192837465012",
27      "options": ["Black", "M"],
28      "price": { "stockStatus": "InStock" },
29      "extraInfo": { "upc": "192837465012" }
30    }
31  ],
32  "medias": [{ "type": "Image", "url": "https://slimages.macysassets.com/is/image/MCY/products/.../main.jpg" }]
33}

Harga

Pay-per-event — Anda hanya dikenakan biaya untuk item yang benar-benar tersimpan:

Event	Harga	Yang dicakup
Produk di-scrape	$0.006	Satu produk dengan detail lengkap — varian, SKU/UPC, harga, gambar, rating
Artikel di-scrape	$0.002	Satu artikel berita Macy’s Inc. — judul, penulis, tanggal, isi, gambar

Diskon volume berlaku otomatis di plan Apify yang lebih tinggi (turun hingga $0.0045 per produk). Crawl 1,000-produk berharga ~$6.00 pada harga normal.

Tips

Gunakan residential proxy US. Endpoint product-detail sesekali kena rate limit; rotasi sesi residential berhasil melewatinya dengan lancar, sementara IP datacenter lebih sering kena 403.
Jaga concurrency tetap moderat. maxConcurrency di angka 2–3 adalah titik optimalnya — nilai lebih tinggi justru menaikkan rate-limit hit tanpa meningkatkan throughput.
Utamakan URL kategori dibanding ID polos. URL membawa category path yang diharapkan API; ID polos bisa saja ter-resolve ke hasil yang lebih luas atau malah kosong.
Matikan includeProductDetails untuk sweep cepat di level listing (nama, brand, harga listing, gambar, rating) saat Anda tidak butuh varian atau deskripsi.

faq

Bagaimana cara melewati Akamai tanpa browser?

Actor ini sama sekali tidak melawan JS challenge-nya. Listing berasal dari API aplikasi mobile Macy's, dan detail produk dari JSON API website — keduanya berjalan di infrastruktur terpisah yang menjawab read request anonim. Tanpa login, tanpa cookie, tanpa API key.

Apakah harganya dalam dolar atau sen?

Integer cents (5999 = $59.99) untuk menghindari pembulatan floating-point, berdampingan dengan string berformat lokal ($59.99).

Bagaimana varian dan UPC ditangani?

Semua warna dan ukuran dikelompokkan di bawah satu product record dengan array variants[]. Setiap varian membawa barcode UPC, warna, ukuran, ketersediaan, dan harganya masing-masing — diperoleh dari data relasi SKU milik Macy's, bukan di-scrape dari swatch widget.

Bisakah saya men-scrape produk dan berita dalam satu run?

Bisa. Set scrapeType ke all dan berikan kombinasi apa pun dari query, startUrls, categoryIds, trendingUrls, dan newsUrls.