Fashion Nova Product Search Actor

Extract product data from Fashion Nova's catalog with advanced search and filtering capabilities. Perfect for price monitoring, inventory tracking, market research, and competitive analysis.

Features

✨ Comprehensive Product Data

• Full product details including titles, descriptions, prices, and availability
• Multiple product images with URLs and dimensions
• Complete variant information (sizes, SKUs, prices)
• Product collections and categories
• Tags and metadata

🔍 Advanced Search Options

• Keyword-based product search
• Sort by relevance or price
• Pagination support with customizable results per page
• Country and language targeting

💰 Pricing Information

• Current price and compare-at price
• Formatted currency display
• Per-variant pricing details

📊 Rich Metadata

• Product type and vendor information
• Tags and collections
• Publication and update timestamps
• Gift card status

Input Parameters

Required Parameters

Parameter	Type	Description	Example
query	string	Search term to find products	"leggings"

Optional Parameters

Parameter	Type	Default	Description
page	integer	1	Page number for pagination (min: 1)
perPage	integer	20	Number of results per page (1-100)
sortKey	string	"RELEVANCE"	Sort method: "RELEVANCE" or "PRICE"
country	string	"US"	Two-letter country code (e.g., "US", "CA")
language	string	"EN"	Two-letter language code (e.g., "EN", "ES")
reverse	boolean	false	Reverse sort order (e.g., highest to lowest price)

Output Format

The actor returns a JSON object with the following structure:

Root Object

{
  "products": [...],
  "pagination": {...}
}

Products Array

Each product in the products array contains:

Field	Type	Description
id	string	Unique product identifier
title	string	Product name
handle	string	URL-friendly product slug
vendor	string	Brand/vendor name
productType	string	Product category type
price	object	Price information (amount, currency, compareAt, formatted)
availableForSale	boolean	Availability status
isGiftCard	boolean	Whether product is a gift card
description	array	Product description as array of strings
descriptionHtml	string	HTML-formatted description
images	array	Product images with URLs, dimensions, and IDs
featuredImage	string	Primary product image URL
variants	array	Available product variants (sizes, colors, etc.)
variantsCount	integer	Total number of variants
options	array	Product options (e.g., size, color)
collections	array	Collections the product belongs to
category	object	Product category (ID and name)
tags	array	Product tags and metadata
publishedAt	string	Publication timestamp (ISO 8601)
createdAt	string	Creation timestamp (ISO 8601)
updatedAt	string	Last update timestamp (ISO 8601)

Variant Object Structure

Each variant contains:

• id: Unique variant identifier
• title: Variant name (e.g., size)
• sku: Stock keeping unit
• barcode: Product barcode (if available)
• price: Price object with amount, currency, and formatted string
• compareAtPrice: Original/compare-at price
• image: Variant-specific image URL
• requiresShipping: Shipping requirement flag
• taxable: Tax applicability flag

Pagination Object

{
  "page": 1,
  "perPage": 20,
  "totalAvailable": 25001,
  "hasNextPage": true,
  "hasPreviousPage": false
}

Usage Examples

Basic Product Search

{
  "query": "black leggings"
}

Search with Pagination

{
  "query": "dresses",
  "page": 2,
  "perPage": 50
}

Sort by Price (Low to High)

{
  "query": "jeans",
  "sortKey": "PRICE",
  "reverse": false
}

Sort by Price (High to Low)

{
  "query": "jeans",
  "sortKey": "PRICE",
  "reverse": true
}

International Search

{
  "query": "vestidos",
  "country": "MX",
  "language": "ES"
}

Output Example

{
  "products": [
    {
      "id": "6537923002492",
      "title": "Janet Snatched Leggings - Black",
      "handle": "janet-snatched-leggings-black",
      "vendor": "Fashion Nova",
      "productType": "Leggings",
      "price": {
        "amount": 24.99,
        "currency": "USD",
        "compareAt": 24.99,
        "formatted": "$24.99"
      },
      "availableForSale": true,
      "featuredImage": "https://cdn.shopify.com/...",
      "variants": [
        {
          "id": "39261707108476",
          "title": "XS",
          "sku": "ZDP0336S_Black_XS",
          "price": {
            "amount": 24.99,
            "currency": "USD",
            "formatted": "$24.99"
          }
        }
      ]
    }
  ],
  "pagination": {
    "page": 1,
    "perPage": 20,
    "totalAvailable": 25001,
    "hasNextPage": true,
    "hasPreviousPage": false
  }
}

Use Cases

🛍️ E-commerce Intelligence

• Track competitor pricing and product offerings
• Monitor inventory availability
• Analyze product descriptions and features

📊 Market Research

• Identify trending products and styles
• Analyze pricing strategies across categories
• Study product variant structures

💰 Price Monitoring

• Track price changes over time
• Compare prices across regions
• Monitor discount patterns

📦 Inventory Management

• Monitor stock availability
• Track variant-level inventory
• Identify popular size ranges

🎯 Content Analysis

• Extract product descriptions for SEO analysis
• Analyze tagging and categorization strategies
• Study product imagery and presentation

Best Practices

1. Pagination: Use reasonable perPage values (20-50) to balance data completeness and performance
2. Rate Limiting: Implement delays between requests to respect server resources
3. Data Storage: Store results in Apify dataset for easy access and export
4. Error Handling: Monitor for failed requests and implement retry logic
5. Incremental Updates: Use page parameter to systematically crawl large catalogs

Technical Notes

• Total Available Products: The Fashion Nova catalog contains 25,000+ searchable products
• Image Quality: Product images are available in high resolution (typically 1333x2000 or 2624x3936)
• Variant Coverage: Products include comprehensive variant data with size options (XS-3X)
• Timestamps: All dates are in ISO 8601 format
• Collections: Products can belong to multiple collections simultaneously

Limitations

• Search results are limited to publicly available products
• Some fields may be null for certain products
• The totalAvailable count represents catalog-wide availability, not query-specific results
• Maximum perPage value is 100 to ensure reasonable response times

Support

For questions, feature requests, or bug reports, please contact us through the Apify platform.

---