Nordstrom

Nordstrom Reviews API

Customer reviews of one nordstrom.com (US) product by URL or style id, up to 200 per call (default 60), sorted most helpful, most recent, highest rated or lowest rated, and optionally filtered to star ratings, verified purchases, reviews with photos or a text search. Returns the review summary (average rating, total reviews, star histogram, size and width rating, the most mentioned praised and criticized features with a quote each, the count of rating-only reviews), the AI review summary when Nordstrom shows one, and each review with title, text, rating, size rating, author, date, helpful votes, verified-purchase flag, reviewer badges, size and color purchased, the reviewer's height, weight, body type and usual sizes, and photos. Costs 10 credits per request.

POST/api/v1/nordstrom/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

urlstring

nordstrom.com product URL (the url of a search, category or brand result). One of url or style_id is required.

Example: https://www.nordstrom.com/s/maeve-midi-dress/7737947

style_idstring

Nordstrom style id, used when url is not given.

Example: 7737947

sortstring

most_helpful (default), most_recent, highest_rated or lowest_rated. Cannot be combined with search: Nordstrom returns review search results in its own order.

Example: most_recent

starsarray<integer>

Only reviews with these star ratings, 1 to 5, e.g. [1, 2] for the critical ones.

Example: [1, 2]

verified_onlyboolean

Only reviews from verified purchasers.

Example: true

with_photosboolean

Only reviews that include customer photos.

Example: true

searchstring

Only reviews mentioning this text (the review search box), 1-100 characters. Results come in Nordstrom's search order, so sort cannot be set with it.

Example: wedding

max_reviewsinteger

Reviews to return, 1-200. Defaults to 60. Larger values take longer: up to about 100 seconds at 200.

Example: 100

Request

from scavio import ScavioClient

client = ScavioClient(api_key="sk_live_your_key")

# The newest 100 reviews; allow up to 120 s
res = client.nordstrom.reviews(style_id="7737947", sort="most_recent", max_reviews=100)["data"]

s = res["summary"]
print(res["name"], s["average_rating"], s["total_reviews"], "reviews, size rating", s["size_rating"])
for f in s["worst_features"]:
    print("complaint:", f["name"], f["mentions"], f["quote"])
for r in res["reviews"]:
    print(r["date"][:10], r["rating"], r["size_purchased"], r["verified_purchase"], r["title"])

Response

"style_id": "7737947",

"url": "https://www.nordstrom.com/s/maeve-midi-dress/7737947",

"name": "Maeve Midi Dress",

"brand": "ASTR the Label",

"sort": "most_helpful",

"max_reviews": 18,

"total_results": 216,

"returned": 18,

"has_more": true,

"ai_summary": "* Customers praise the soft, lightweight, silky fabric that drapes gracefully and feels luxurious against skin * Many highlight the flattering, body-inclusive fit with smocked back and adjustable straps accommodating diverse shapes * Reviewers love the vibrant, elegant colors and romantic aesthetic perfect for weddings and special events * Several note comfortable, breathable wear without restriction, ideal for extended wear in warm weather * A few report fit inconsistencies around the bust or occasional zipper issues, though isolated concerns",

"response_time": 13765

}

from scavio import ScavioClient client = ScavioClient(api_key="sk_live_your_key") # The newest 100 reviews; allow up to 120 s res = client.nordstrom.reviews(style_id="7737947", sort="most_recent", max_reviews=100)["data"] s = res["summary"] print(res["name"], s["average_rating"], s["total_reviews"], "reviews, size rating", s["size_rating"]) for f in s["worst_features"]: print("complaint:", f["name"], f["mentions"], f["quote"]) for r in res["reviews"]: print(r["date"][:10], r["rating"], r["size_purchased"], r["verified_purchase"], r["title"])