~/ecommerce/macys-scraper

Macy's Scraper — Produits, prix, SKUs et actualités

Extrayez les données produits Macy's — prix, variantes, SKU/UPC, images, notes et avis — plus les actualités Macy's Inc., via URLs de recherche, catégorie, tendances ou produit. Sans navigateur, résistant à Akamai.

grands magasins TypeScriptCrawleeCheerio États-Unis

exécuter sur Apify

proooxy/macys-scraper — specs

catégorieecommerce / grands magasins

langageTypeScript

stackTypeScript, Crawlee, Cheerio

marchésÉtats-Unis

sortieJSON propre, prêt pour le RAG

fonctionnalités clés

Quatre surfaces dans un seul acteur — recherche produit, catégorie, tendances, et actualités Macy's Inc.

Déjoue Akamai Bot Manager sans navigateur, en utilisant les API JSON mobiles et web propres à Macy's

Codes-barres UPC par SKU, avec couleur, taille, disponibilité et prix pour chaque variante achetable

Prix en cents sous forme d’entiers, plus des chaînes formatées localisées — aucun arrondi en virgule flottante

Intelligence complète sur les avis — histogramme d’étoiles, nombre de recommandations, et notes secondaires de coupe/taille

Toutes les teintes et tailles regroupées sous une seule fiche produit, pas une ligne par variante

Uniquement des URLs canoniques propres — les endpoints d’API internes et les clés client ne fuitent jamais dans la sortie

Un schéma normalisé unique pour les résultats de recherche, catégorie, tendances et détail produit

cas d’usage

Suivi des prix et promotions en grand magasin au niveau SKU
Analyse concurrentielle — Macy's face à Nordstrom, Ulta, ou la tarification DTC des marques
Rapprochement de catalogues entre enseignes via les codes-barres UPC par variante
Intelligence sur les avis et notes pour les marques vendues chez Macy's
Veille actualités retail — communiqués de presse et annonces de résultats de Macy's Inc.

paramètres d’entrée

Paramètre	Type	Requis	Description
`scrapeType`	string	requis	Surface à scraper : search, category, trending, news, ou all (par défaut : search).
`query`	string	optionnel	Mot-clé pour la recherche produit, ex. women shoes.
`startUrls`	array	optionnel	URLs de produits/catégories Macy's ou d’actualités Macy's Inc.
`categoryIds`	array	optionnel	ID de catégorie Macy's (ex. 5449). Les URLs de catégorie sont préférables lorsqu’elles sont connues.
`trendingUrls`	array	optionnel	URLs de listings tendances, meilleures ventes, ou sélections.
`newsUrls`	array	optionnel	URLs de listing d’actualités ou d’articles Macy's Inc.
`includeProductDetails`	boolean	optionnel	Enrichit les éléments de listing avec le détail produit complet — variantes, SKUs, galeries (par défaut : true).
`maxPages`	number	optionnel	Profondeur de pagination maximale par source de listing/actualités.
`maxResults`	number	optionnel	Plafond d’enregistrements en sortie. 0 = aucun plafond.
`proxy`	object	requis	Apify Proxy ou URLs de proxy personnalisées. Résidentiel, pays US recommandé.

Exemple de sortie

 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}

Tarification

Facturation à l’événement — vous n’êtes facturé que pour les éléments réellement sauvegardés :

Événement	Prix	Ce qui est couvert
Produit scrapé	$0.006	Un produit avec détail complet — variantes, SKUs/UPC, prix, images, notes
Article scrapé	$0.002	Un article d’actualité Macy’s Inc. — titre, auteur, date, corps, images

Des remises de volume s’appliquent automatiquement sur les plans Apify supérieurs (jusqu’à $0.0045 par produit). Un crawl de 1 000 produits coûte environ $6.00 au tarif catalogue.

Astuces

Utilisez des proxies résidentiels US. L’endpoint de détail produit est sujet à une limitation de débit intermittente ; la rotation de sessions résidentielles passe sans problème, alors que les IP datacenter voient davantage de 403.
Gardez une concurrence modeste. maxConcurrency à 2–3 est le point d’équilibre — des valeurs plus élevées augmentent les blocages liés au débit sans améliorer le débit réel.
Préférez les URLs de catégorie aux ID bruts. L’URL porte le chemin de catégorie attendu par l’API ; un ID brut peut résoudre vers un jeu de résultats plus large, voire vide.
Désactivez includeProductDetails pour un balayage rapide au niveau listing (nom, marque, prix affiché, image, note) lorsque vous n’avez pas besoin des variantes ou des descriptions.

faq

Comment contourne-t-il Akamai sans navigateur ?

Il n’affronte pas du tout le défi JS. Les listings proviennent de l’API de l’application mobile Macy's, et les détails produits de l’API JSON du site web — les deux tournent sur une infrastructure séparée qui répond aux requêtes de lecture anonymes. Aucune connexion, aucun cookie, aucune clé API.

Les prix sont-ils en dollars ou en cents ?

En cents sous forme d’entiers (5999 = $59.99) pour éviter l’arrondi en virgule flottante, accompagnés de chaînes formatées localisées ($59.99).

Comment les variantes et les UPC sont-ils gérés ?

Toutes les couleurs et tailles sont regroupées sous une seule fiche produit, avec un tableau variants[]. Chaque variante porte son propre code-barres UPC, sa couleur, sa taille, sa disponibilité et son prix — récupérés depuis les données de relation SKU de Macy's, et non extraits d’un widget de nuancier.

Puis-je scraper produits et actualités en un seul run ?

Oui. Définissez scrapeType sur all et fournissez n’importe quelle combinaison de query, startUrls, categoryIds, trendingUrls et newsUrls.