Macy's

Macy's Reviews API

Customer reviews for one macys.com (US) product, Macy's own: newest, highest or lowest rated first or with photos first, up to 100 per page, optionally only one star rating or only reviews mentioning a word. Each review has rating, title, text, date, reviewer nickname, location as given, recommended flag, helpful yes and no votes, incentivized and syndicated flags, badges, fit and other slider ratings, photo URLs and the brand's response. total counts written reviews only. Costs 1 credit per request.

POST/api/v1/macys/reviews

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>, where <token> is your Scavio API key (e.g. Bearer sk_live_your_key).

Body

application/json

product_idinteger

Macy's product id (a search result's id). Pass product_id or url.

Example: 25822310

urlstring

A macys.com product URL (its ID= is used).

sortstring

newest (default), highest_rated, lowest_rated or with_photos.

pageinteger

Page, 1-based, up to 500. Defaults to 1.

Example: 1

limitinteger

Reviews per page, 1-100. Defaults to 20.

Example: 10

ratinginteger

Only reviews with this star rating, 1-5.

Example: 1

querystring

Only reviews mentioning this text, 1-100 characters.

Example: soft

Request

from scavio import ScavioClient

client = ScavioClient(api_key="sk_live_your_key")

res = client.macys.reviews(product_id=25822310, sort="lowest_rated", limit=100)["data"]

print(res["product_title"], res["total"], "written reviews")
for r in res["reviews"]:
    print(r["rating"], r["date"], r["nickname"], r["fit"], r["text"])

Response

"product_id": 25822310,

"product_title": "Calvin Klein Men's Standard Straight Fit Stretch Denim Jeans",

"product_url": "https://www.macys.com/shop/product/calvin-klein-mens-straight-fit-stretch-denim-jeans?ID=25822310",

"sort": "newest",

"rating_filter": null,

"query": null,

"total": 32,

"page": 1,

"limit": 10,

"total_pages": 4,

"has_more": true,

"count": 10,

"response_time": 871

}

from scavio import ScavioClient client = ScavioClient(api_key="sk_live_your_key") res = client.macys.reviews(product_id=25822310, sort="lowest_rated", limit=100)["data"] print(res["product_title"], res["total"], "written reviews") for r in res["reviews"]: print(r["rating"], r["date"], r["nickname"], r["fit"], r["text"])