- query
- The product or listing URL you submitted, echoed on every row so a large export stays traceable back to what you asked for.
- sku_code
- The retailer's own item number. On Macy's this is the slot for the Web ID - the reference number printed on tags in store and in the catalogue, which pulls the item straight up in the site's search box.
- product_url
- The canonical link to the product page. The export carries this alongside
url; where our retail exports have returned rows the two have matched, so treat them as one value until you find a page where they do not. - name
- The product title as Macy's writes it, which for apparel usually folds the brand, the style and the variant into one string.
- description
- The product description text. Long, formatted for humans, and frequently the largest column in the file by some distance - size your storage for it before you pull a big catalogue.
- parsed_price
- The price with the display formatting removed - no currency symbol, no thousands separators. This is the column to sort, filter and average on.
- price
- The price exactly as displayed on the page, symbol and separators intact. It is the column that preserves how Macy's presented the figure, which is the part that matters when the number sits next to a Sale, Clearance or Everyday Value label. Keep it.
- currency
- The currency as a three-letter code rather than a symbol.
- availability
- Whether the item is purchasable, using the standard schema.org vocabulary -
InStock and OutOfStock are the values our retail exports have returned. Not every retailer publishes it, in which case the column is empty rather than false. - rating
- The product's star rating, where the page carries one. Many catalogue pages do not.
- reviews
- How many reviews that rating rests on. Read the two together or neither: a rating without a count is not a number you can weight.
- images
- All of the product images, joined into a single string with a semicolon between them. Split on
; to get the list back. - brand
- The brand, where the page names one separately from the title. At a department store this is the column that makes the file useful - it is what lets you group a mixed catalogue by label rather than by parsing names.
- sku
- The manufacturer's own identifier for the item - a style or part number, distinct from the retailer's
sku_code. On some retailers the two are the same number; on others they are completely different, so do not treat them as interchangeable. - url
- The product page link, alongside
product_url. - image
- The primary product image - the first entry in
images. Convenient when you want one thumbnail per row and not a list. - status
- A per-row outcome flag from the export layer, recording whether that particular page was retrieved cleanly. It is not part of Macy's data, and it is where the reason appears when a row comes back empty.