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 json { "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 json { "page": 1, "perPage": 20, "totalAvailable": 25001, "hasNextPage": true, "hasPreviousPage": false } ## Usage Examples ### Basic Product Search json { "query": "black leggings" } ### Search with Pagination json { "query": "dresses", "page": 2, "perPage": 50 } ### Sort by Price (Low to High) json { "query": "jeans", "sortKey": "PRICE", "reverse": false } ### Sort by Price (High to Low) json { "query": "jeans", "sortKey": "PRICE", "reverse": true } ### International Search json { "query": "vestidos", "country": "MX", "language": "ES" } ## Output Example json { "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. ---