Fashion Nova Product Review - Apify Actor Documentation

Overview

The Fashion Nova Product Review Actor extracts product information and customer reviews from Fashion Nova product pages. It retrieves detailed product data including reviews, ratings, sizing information, and customer feedback metrics.

Features

• Extract product details (name, ID, image, URL)
• Retrieve customer reviews with pagination support
• Get review statistics and sentiment analysis
• Access sizing and fit information
• Sort reviews by multiple criteria
• Filter reviews by rating

Input Schema

The Actor accepts the following input parameters:

Required Parameters

Parameter	Type	Description
productUrl	string	The Fashion Nova product URL to scrape reviews from

Optional Parameters

Parameter	Type	Default	Description
page	integer	1	Page number for pagination (minimum: 1)
perPage	integer	20	Number of reviews per page (1-100)
sortBy	string	"most_relevant"	Sort order for reviews

Sort Options

• most_relevant - Most Relevant
• most_recent - Most Recent
• most_helpful - Most Helpful
• lowest_rated - Lowest Rated
• highest_rated - Highest Rated

Input Example

{
  "productUrl": "https://www.fashionnova.com/products/tap-in-sweater-jumpsuit-black-combo",
  "page": 1,
  "perPage": 20,
  "sortBy": "most_relevant"
}

Output Schema

The Actor returns a JSON object with the following structure:

Product Information

Field	Type	Description
product.id	string	Unique product identifier
product.name	string	Product name
product.image	string	Product image URL
product.url	string	Product page URL

Reviews Data

Pagination

Field	Type	Description
reviews.pagination.page	integer	Current page number
reviews.pagination.perPage	integer	Results per page
reviews.pagination.totalAvailable	integer	Total number of reviews

Individual Review

Each review in reviews.reviews[] contains:

Field	Type	Description
id	integer	Review ID
score	integer	Star rating (1-5)
votes_up	integer	Helpful votes count
votes_down	integer	Not helpful votes count
content	string	Review text content
title	string	Review title
created_at	string	ISO timestamp of review creation
verified_buyer	boolean	Whether reviewer is verified buyer
sentiment	float	Sentiment score (0-1)
topics	object	AI-extracted topics from review
custom_fields	object	Sizing and fit information
user.display_name	string	Reviewer's display name
fit	integer	Fit rating (size accuracy)
purchasedSize	string	Size purchased by reviewer
usualSize	string	Reviewer's usual size

Review Summary

Field	Type	Description
reviews.summary.fit	integer	Average fit rating
reviews.summary.rating	float	Average star rating
reviews.summary.total	integer	Total review count
reviews.summary.stars[]	array	Breakdown of ratings by star count

Output Example

{
  "productInfo": {
    "id": "6539669930108",
    "name": "Tap In Sweater Jumpsuit - Black/combo",
    "image": "https://cdn-yotpo-images-production.yotpo.com/Product/532031366/443559359/square.jpg",
    "url": "https://yotpo.com/go/vaWMGya8"
  },
  "reviews": {
    "pagination": {
      "page": 1,
      "perPage": 20,
      "totalAvailable": 24
    },
    "reviews": [
      {
        "id": 760272987,
        "score": 5,
        "votes_up": 1,
        "votes_down": 0,
        "content": "This jumpsuit is AMAZING! The feel of it on my body is like butter...",
        "title": "This jumpsuit is AMAZING!",
        "created_at": "2025-09-17T17:36:49.000Z",
        "verified_buyer": true,
        "sentiment": 0.991561,
        "purchasedSize": "XL",
        "usualSize": "XL",
        "fit": 2,
        "reviewerName": "Detra M."
      }
    ],
    "summary": {
      "fit": 2,
      "rating": 3.9,
      "total": 24,
      "stars": [
        {"name": "5", "reviews": 14},
        {"name": "4", "reviews": 3},
        {"name": "3", "reviews": 1},
        {"name": "2", "reviews": 3},
        {"name": "1", "reviews": 3}
      ]
    }
  }
}

Usage

1. Navigate to the Actor in Apify Console
2. Configure Input Parameters:
   • Enter the Fashion Nova product URL
   • Set pagination options (page, perPage)
   • Choose sort order
3. Run the Actor
4. Access Results via dataset or key-value store (output key)

Use Cases

• Market Research - Analyze customer sentiment and product performance
• Competitive Analysis - Compare products based on customer feedback
• Size Guide Optimization - Understand fit issues through sizing data
• Review Monitoring - Track new reviews and customer satisfaction
• Sentiment Analysis - Gauge overall product reception

Error Handling

The Actor will throw an error if:

• The product URL is invalid
• The product cannot be found
• Network issues prevent data retrieval

Error messages are logged to the console with details about the failure.

Performance Notes

• Each run processes one product URL
• Review data is paginated for efficient retrieval
• Results are stored in both dataset and key-value store

Support

For issues or questions about this Actor, please contact us or refer to the Apify documentation.