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:

{
  "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:

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

// Input
{
  "productUrls": [
    { "url": "https://www.fashionnova.com/products/tap-in-sweater-jumpsuit-black-combo" }
  ]
}

Multiple Products

// 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