Fashion Nova Similar Products Actor

Overview

The Fashion Nova Similar Products Actor is an Apify scraper that extracts detailed product information and similar product recommendations from Fashion Nova's e-commerce platform. It takes a product URL as input and returns comprehensive product data including specifications, pricing, variants, images, and algorithmically recommended similar products.

Features

• Fetches complete product information including title, description, pricing, and availability
• Retrieves all product variants (sizes, colors) with individual pricing
• Extracts high-resolution product images
• Collects similar product recommendations
• Returns structured JSON output ready for analysis or integration
• Built-in error handling and validation

Input

The actor accepts the following input parameters:

Input Schema

{
  "productUrl": "string (required)"
}

Parameters

Parameter	Type	Required	Default	Description
productUrl	String	Yes	https://www.fashionnova.com/products/cool-breeze-active-legging-olive	Full URL of the Fashion Nova product page to scrape

Example Input

{
  "productUrl": "https://www.fashionnova.com/products/cool-breeze-active-legging-olive"
}

Output

The actor returns a structured JSON object containing product information and similar products.

Output Schema

{
  "productInfo": {
    "id": "string",
    "title": "string",
    "handle": "string",
    "vendor": "string",
    "productType": "string",
    "price": {
      "amount": "number",
      "currency": "string",
      "compareAt": "number",
      "formatted": "string"
    },
    "availableForSale": "boolean",
    "isGiftCard": "boolean",
    "description": ["string"],
    "descriptionHtml": "string",
    "images": [
      {
        "idImage": "string",
        "url": "string",
        "altText": "string",
        "width": "number",
        "height": "number"
      }
    ],
    "featuredImage": "string",
    "variants": [
      {
        "id": "string",
        "title": "string",
        "sku": "string",
        "barcode": "string",
        "price": {
          "amount": "number",
          "currency": "string",
          "formatted": "string"
        },
        "compareAtPrice": {
          "amount": "number",
          "currency": "string",
          "formatted": "string"
        },
        "image": "string",
        "requiresShipping": "boolean",
        "taxable": "boolean"
      }
    ],
    "variantsCount": "number",
    "options": [
      {
        "id": "string",
        "name": "string",
        "values": ["string"]
      }
    ],
    "collections": [
      {
        "idCollections": "string",
        "handle": "string"
      }
    ],
    "category": {
      "idCategory": "string",
      "name": "string"
    },
    "tags": ["string"],
    "publishedAt": "string",
    "createdAt": "string",
    "updatedAt": "string"
  },
  "similarProducts": [
    {
      "fragment": {
        "id": "string",
        "title": "string",
        "handle": "string",
        "description": "string",
        "productType": "string",
        "vendor": "string",
        "availableForSale": "boolean",
        "priceRange": {
          "minVariantPrice": {
            "amount": "string",
            "currencyCode": "string"
          },
          "maxVariantPrice": {
            "amount": "string",
            "currencyCode": "string"
          }
        },
        "firstImage": {
          "url": "string",
          "altText": "string"
        },
        "variants": {
          "nodes": [
            {
              "id": "string",
              "title": "string",
              "sku": "string",
              "availableForSale": "boolean",
              "price": {
                "amount": "string",
                "currencyCode": "string"
              },
              "compareAtPrice": {
                "amount": "string",
                "currencyCode": "string"
              }
            }
          ]
        },
        "tags": ["string"]
      },
      "tagline": {
        "tagline": "string",
        "priceWithCodeTagline": "string"
      },
      "badge": {
        "name": "string",
        "backgroundColor": "string",
        "textColor": "string"
      },
      "isOutOfStock": "boolean"
    }
  ]
}

Example Output

{
  "productInfo": {
    "id": "6541938491516",
    "title": "Cool Breeze Active Legging - Olive",
    "handle": "cool-breeze-active-legging-olive",
    "vendor": "Fashion Nova",
    "productType": "Nova Sport",
    "price": {
      "amount": 19.99,
      "currency": "USD",
      "compareAt": 19.99,
      "formatted": "$19.99"
    },
    "availableForSale": true,
    "isGiftCard": false,
    "description": [
      "Available In Mauve And Olive.",
      "Active Legging",
      "High Waisted",
      "Textured Fabric",
      "Low Impact",
      "Stretch",
      "Pair with \"Cool Breeze Active Sports Bra\"",
      "75% Nylon 25% Spandex",
      "Imported"
    ],
    "images": [
      {
        "idImage": "27977494429820",
        "url": "https://cdn.shopify.com/s/files/1/0293/9277/files/...",
        "width": 1333,
        "height": 2000
      }
    ],
    "variants": [
      {
        "id": "39284693598332",
        "title": "XS",
        "sku": "YP70036_Olive_XS",
        "price": {
          "amount": 19.99,
          "currency": "USD",
          "formatted": "$19.99"
        }
      }
    ],
    "tags": [
      "activity:Running",
      "bottom_style:Leggings",
      "color:Olive",
      "Plus"
    ]
  },
  "similarProducts": [
    {
      "fragment": {
        "title": "Major Body Active Legging - Sage",
        "handle": "major-body-active-legging-sage",
        "priceRange": {
          "minVariantPrice": {
            "amount": "21.95",
            "currencyCode": "EUR"
          }
        }
      },
      "badge": {
        "name": "40% OFF",
        "backgroundColor": "#9d2226",
        "textColor": "#ffffff"
      }
    }
  ]
}

Usage

Running on Apify Platform

1. Navigate to the actor's page on Apify Console
2. Click "Try for free" or "Start"
3. Enter the Fashion Nova product URL in the input field
4. Click "Start" to run the actor
5. Wait for the actor to finish (typically 10-30 seconds)
6. Download results in JSON, CSV, or other formats

Running via API

const ApifyClient = require('apify-client');

const client = new ApifyClient({
    token: 'YOUR_APIFY_TOKEN'
});

const input = {
    productUrl: "https://www.fashionnova.com/products/cool-breeze-active-legging-olive"
};

const run = await client.actor("THE_ACTOR_ID").call(input);
const { items } = await client.dataset(run.defaultDatasetId).listItems();

console.log(items);

Running via CLI

$apify run -p '{"productUrl": "https://www.fashionnova.com/products/cool-breeze-active-legging-olive"}'

Error Handling

The actor includes comprehensive error handling:

• Invalid Product URL: Throws an error if the URL is missing, empty, or not a string
• Product Not Found: Throws an error if the product doesn't exist or the URL is invalid
• Network Errors: Automatically retries failed requests
• Data Validation: Validates product data before returning

Error information is stored in the ERROR key-value store for debugging purposes.

Use Cases

• Price Monitoring: Track product prices and availability over time
• Competitor Analysis: Monitor Fashion Nova's product offerings and pricing strategies
• Product Research: Collect data for market research and trend analysis
• Recommendation Engine: Build custom product recommendation systems
• Inventory Tracking: Monitor stock levels across different sizes and variants
• Content Aggregation: Aggregate product data for fashion comparison websites
• Data Science: Collect training data for ML models in fashion e-commerce

Technical Details

Data Freshness

The actor fetches real-time data directly from Fashion Nova's platform, ensuring you always get the most current information including live pricing, availability, and promotions.

Limitations

• Only works with Fashion Nova product URLs
• Requires valid, publicly accessible product pages
• Cannot access products that are completely removed from the site
• Similar products are determined by Fashion Nova's algorithm (not customizable)

Support

For issues, questions, or feature requests, please contact us or create an issue.