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 json { "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 json { "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.