Fashion Nova Product Scraper - Actor Documentation ## Overview This Apify actor scrapes product information from Fashion Nova product pages. It extracts comprehensive product data including details, pricing, images, variants, and metadata. ## Features - Scrapes multiple Fashion Nova product URLs in a single run - Extracts complete product information including variants and pricing - Handles both regular and plus-size products - Stores results individually and as a complete dataset - Error handling and logging ## Input Schema The actor accepts the following input configuration: json { "productUrls": [ { "url": "https://www.fashionnova.com/products/tap-in-sweater-jumpsuit-black-combo" }, { "url": "https://www.fashionnova.com/products/lara-sweater-maxi-dress-black-white" } ] } ### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | productUrls | Array | Yes | Array of objects containing Fashion Nova product URLs | | productUrls[].url | String | Yes | Full Fashion Nova product URL | ### Default Values If no input is provided, the actor uses these default URLs: - https://www.fashionnova.com/products/tap-in-sweater-jumpsuit-black-combo - https://www.fashionnova.com/products/lara-sweater-maxi-dress-black-white ## Output Schema Each product returns a comprehensive JSON object with the following structure: json { "id": "6539669930108", "title": "Tap In Sweater Jumpsuit - Black/combo", "handle": "tap-in-sweater-jumpsuit-black-combo", "vendor": "Fashion Nova", "productType": "Jumpsuits", "price": { "amount": 11.98, "currency": "USD", "compareAt": 59.99, "formatted": "$11.98" }, "availableForSale": true, "isGiftCard": false, "description": ["Array of product features"], "descriptionHtml": "<ul>...</ul>", "images": [ { "idImage": "27976904343676", "url": "https://cdn.shopify.com/...", "altText": null, "width": 1333, "height": 2000 } ], "featuredImage": "https://cdn.shopify.com/...", "variants": [ { "id": "39271360200828", "title": "XS", "sku": "15437_Black/combo_XS", "price": { "amount": 11.98, "currency": "USD", "formatted": "$11.98" }, "compareAtPrice": { "amount": 59.99, "currency": "USD", "formatted": "$59.99" }, "image": "https://cdn.shopify.com/...", "requiresShipping": true, "taxable": true } ], "variantsCount": 8, "options": [ { "id": "8409019154556", "name": "Size", "values": ["XS", "S", "M", "L", "XL", "1X", "2X", "3X"] } ], "collections": [ { "idCollections": "181231300", "handle": "rompers-and-jumpsuits" } ], "category": { "idCategory": "TaxonomyCategory/aa-1-4", "name": "Dresses" }, "tags": ["80sale", "blackcollection", "Jumpsuits", ...], "publishedAt": "2025-06-18T23:06:16Z", "createdAt": "2023-07-13T23:51:16Z", "updatedAt": "2025-10-19T13:54:26Z" } ### Output Fields #### Product Information - id - Unique product identifier - title - Product name - handle - URL-friendly product identifier - vendor - Always "Fashion Nova" - productType - Product category (e.g., "Jumpsuits", "Dresses") #### Pricing - price.amount - Current price in decimal format - price.currency - Currency code (USD) - price.compareAt - Original price before discount - price.formatted - Formatted price string #### Product Details - availableForSale - Stock availability (boolean) - isGiftCard - Whether product is a gift card (boolean) - description - Array of product features - descriptionHtml - HTML formatted description #### Images - images[] - Array of product images with: - idImage - Image identifier - url - CDN URL to image - altText - Alternative text (usually null) - width, height - Image dimensions - featuredImage - Main product image URL #### Variants - variants[] - Array of size/color variants with: - id - Variant identifier - title - Variant name (size) - sku - Stock keeping unit - price - Variant pricing - compareAtPrice - Original variant price - image - Variant image URL - requiresShipping - Shipping requirement (boolean) - taxable - Tax status (boolean) - variantsCount - Total number of variants #### Options & Collections - options[] - Available options (usually Size) - collections[] - Product collections it belongs to - category - Product taxonomy category #### Metadata - tags[] - Product tags and attributes - publishedAt - Publication timestamp - createdAt - Creation timestamp - updatedAt - Last update timestamp ## Usage Examples ### Basic Usage javascript // Input { "productUrls": [ { "url": "https://www.fashionnova.com/products/tap-in-sweater-jumpsuit-black-combo" } ] } ### Multiple Products javascript // Input { "productUrls": [ { "url": "https://www.fashionnova.com/products/tap-in-sweater-jumpsuit-black-combo" }, { "url": "https://www.fashionnova.com/products/lara-sweater-maxi-dress-black-white" }, { "url": "https://www.fashionnova.com/products/another-product-handle" } ] } ## Data Storage The actor stores data in two ways: 1. Individual Records: Each product is stored separately using Actor.pushData() 2. Complete Dataset: All results are stored as a single array in the Key-Value store as output ## Error Handling The actor includes error handling that: - Logs errors to console - Throws errors to mark the run as failed - Provides error messages for debugging ## Implementation Notes - Products are processed sequentially (not in parallel) - Each product is logged during processing ## Best Practices 1. Rate Limiting: Consider adding delays between requests to avoid overwhelming the server 2. Error Recovery: Individual product failures don't stop the entire run 3. Data Validation: Validate URLs before processing 4. Monitoring: Check logs for processing status